sgcEditors Macierz funkcji
Wszystko, co potrafi sgcEditors, pogrupowane według zadań, z linkiem do tematu pomocy każdej funkcji. Każda kontrolka istnieje dla VCL, FireMonkey, WinForms, WPF i Avalonia z tymi samymi właściwościami i zdarzeniami.
Wszystko, co potrafi sgcEditors, pogrupowane według zadań, z linkiem do tematu pomocy każdej funkcji. Każda kontrolka istnieje dla VCL, FireMonkey, WinForms, WPF i Avalonia z tymi samymi właściwościami i zdarzeniami.
17 funkcji
9 funkcji
Funkcje: 2
Pakiety NuGet: 6
Pomoc online i podręczniki PDF
Zarejestrowana oznacza funkcje, które są w edycji zarejestrowanej i wersji próbnej, a nie ma ich w bezpłatnej edycji Community. ~ oznacza funkcję, którą Community ma tylko częściowo, z różnicą poniżej.
Każdy wiersz prowadzi do tematu pomocy. Kolumna Community pokazuje, co zawiera bezpłatna edycja .NET Community; wszystko jest w edycji Zarejestrowanej i wersji próbnej.
| Funkcja | Szczegóły | Community | Pomoc |
|---|---|---|---|
| Kalendarz miesięczny | Pojedyncza data lub zakres, MinDate i MaxDate, wyłączone daty i dni tygodnia, numery tygodni ISO 8601, widoki miesiąca, roku i dekady. | Pomoc | |
| Wybór daty | Wprowadzanie daty z rozwijanym kalendarzem i tolerancyjnym parserem, który rozumie nazwy miesięcy. | Pomoc | |
| Wybór czasu | Wprowadzanie czasu w natywnym polu edycji. | Pomoc | |
| Wybór daty i czasu | Data i czas w jednej kontrolce. | Pomoc | |
| Suwak zakresu | Wybierz wartość lub zakres na suwaku. Drugi uchwyt jest w edycji zarejestrowanej. | ~Rysowany i edytowany jest jeden uchwyt; EndValue jest zachowane, ale niepokazywane. | Pomoc |
| Wybór koloru | Wybierz kolor. Kwadrat HSV i pasek alfa są w edycji zarejestrowanej. | ~Tylko próbki i hex; kwadrat HSV i pasek alfa nie są rysowane, a alfa to zawsze $FF. | Pomoc |
| Pole tokenów | Chipy dla tagów i odbiorców. Lista autouzupełniania jest w edycji zarejestrowanej. | ~Chipy, walidacja i limity działają; lista autouzupełniania nigdy się nie otwiera. | Pomoc |
| Ocena | Wprowadzanie oceny w gwiazdkach. | Pomoc | |
| Pole liczbowe | Wprowadzanie liczby z kółkiem myszy i automatycznym powtarzaniem. | Pomoc | |
| Pole z przyciskami | Natywny edytor z przyciskami przeglądania, listy rozwijanej, wyszukiwania, czyszczenia, plus, minus, tekstowymi lub rysowanymi przez właściciela po obu stronach, każdy ze skrótem. Czytniki ekranu wymieniają i naciskają każdy przycisk. | Pomoc | |
| Pole wyszukiwania | OnSearch po przerwie w pisaniu lub od razu po Enter, przyciski wyszukiwania i czyszczenia oraz rozwijana historia wcześniejszych wyszukiwań. | Pomoc | |
| Pole z maską | Maski wprowadzania w składni EditMask z Delphi lub MaskedTextBox z .NET, wybieranej przez MaskSyntax, więc jedna maska działa tak samo w Delphi i .NET. Niepełna wartość jest zgłaszana walidatorowi. | Pomoc | |
| Pole walutowe | Dokładna wartość Currency (decimal w .NET) z formatem waluty ustawień regionalnych, symbolem lub kodem ISO, limitami i grupowaniem podczas pisania. | Pomoc | |
| Pole z listą wyboru | Wielokolumnowa lista rozwijana z opcjonalnym wierszem nagłówka, filtrowaniem podczas pisania, kolumną klucza i kolumną wyświetlaną. Wiersze z Items, OnGetItems lub, w .NET, ItemsSource. | Pomoc | |
| Memo | Motywowany edytor wielowierszowy z tekstem zastępczym, licznikiem znaków z opcjonalnym limitem i wysokością, która podąża za liczbą wierszy. | Pomoc | |
| Przełącznik | TsgcVCLToggleSwitch i TsgcFMXToggleSwitch (TsgcWinFormsToggleSwitch, TsgcWpfToggleSwitch i TsgcAvaloniaToggleSwitch w .NET) to przełączniki włącz i wyłącz dla ustawień: zaokrąglony tor z okrągłym suwakiem, który przesuwa się do nowego stanu w około 150 ms, podpis po prawej lub po lewej (CaptionPosition), tekst Wł. i Wył. wewnątrz toru (ShowText), ReadOnly oraz kolory toru i suwaka, które domyślnie pochodzą z motywu. OnChanging anuluje zmianę wykonaną przez użytkownika, OnChange jest wywoływane po każdej zmianie, a Toggle zmienia stan tak, jak zrobiłby to użytkownik. Kliknięcie, przeciągnięcie suwaka, Spacja, Lewo i Prawo, układ od prawej do lewej oraz pole wyboru ze wzorcem Toggle dla czytników ekranu. Checked wiąże się dwukierunkowo w WPF i Avalonia. | Pomoc | |
| Pole adresu IP | TsgcVCLIPAddressEdit i TsgcFMXIPAddressEdit (TsgcWinFormsIPAddressEdit, TsgcWpfIPAddressEdit i TsgcAvaloniaIPAddressEdit w .NET) przyjmują adres IPv4 lub IPv6 (Mode). IPv4 pokazuje cztery pola oktetów, które przesuwają się w trakcie pisania, ogranicza wartość powyżej 255 i wypełnia puste pola zerem, gdy fokus opuszcza pole. IPv6 to jedno pole tekstowe, sprawdzane i zapisywane w kanonicznej postaci RFC 5952, gdy fokus opuszcza pole. Address, Octets, IsValid, Required z ramką błędu motywu, ReadOnly, Clear i OnChange. Wklejanie pełnego adresu, układ od prawej do lewej oraz pole edycji ze wzorcem Value dla czytników ekranu. Address wiąże się dwukierunkowo w WPF i Avalonia. | Pomoc | |
| Pole przedziału czasu | TsgcVCLTimeSpanEdit i TsgcFMXTimeSpanEdit (TsgcWinFormsTimeSpanEdit, TsgcWpfTimeSpanEdit i TsgcAvaloniaTimeSpanEdit w .NET) edytują czas trwania w segmentach od dni do milisekund (Segments), jako zegar lub z jednostkami (DisplayFormat). Value w milisekundach (TimeSpan w .NET), MinValue, MaxValue, AllowNegative, Increment, ShowButtons dla przycisków zmiany wartości oraz ReadOnly. Pisanie, Góra i Dół, PageUp i PageDown, kółko i przyciski zmieniają aktywny segment z przeniesieniem do następnego. Pokrętło ze wzorcem RangeValue dla czytników ekranu. Value wiąże się dwukierunkowo w WPF i Avalonia. | Pomoc | |
| Selektor czcionki | TsgcVCLFontPicker i TsgcFMXFontPicker (TsgcWinFormsFontPicker, TsgcWpfFontPicker i TsgcAvaloniaFontPicker w .NET) wybierają rodzinę czcionek z listy rozwijanej, która rysuje każdą nazwę jej własnym krojem (ShowPreview, PreviewText), filtrowanej w trakcie pisania. FontName, Fonts wypełniana z platformy, dopóki aplikacja jej nie wypełni, RefreshFonts, ostatnio wybrane rodziny na początku (RecentCount, RecentFonts) oraz filtr stałej szerokości (FontFilter). Podgląd krojów w Delphi jest rysowany w Windows. FontName wiąże się dwukierunkowo w WPF i Avalonia. | Pomoc | |
| Lista z polami wyboru | TsgcVCLCheckListBox i TsgcFMXCheckListBox (TsgcWinFormsCheckListBox, TsgcWpfCheckListBox i TsgcAvaloniaCheckListBox w .NET) wyświetlają Items z polem wyboru w każdym wierszu: Checked, State ze stanem szarym (AllowGrayed) i ItemEnabled dla każdego elementu. Trójstanowy wiersz Zaznacz wszystko (ShowCheckAll), pole filtra, które nigdy nie zmienia stanu (ShowFilter), CheckAll, UncheckAll, CheckedCount oraz OnClickCheck przed OnChange. Rysowane są tylko widoczne wiersze, więc 10000 elementów pozostaje szybkie. Spacja, Ctrl+A, wpisanie litery, aby przeskoczyć, oraz elementy listy ze wzorcem Toggle dla czytników ekranu. | Pomoc | |
| Podwójna lista | TsgcVCLDualListBox i TsgcFMXDualListBox (TsgcWinFormsDualListBox, TsgcWpfDualListBox i TsgcAvaloniaDualListBox w .NET) przenoszą elementy między AvailableItems i SelectedItems przyciskami między listami, dwukrotnym kliknięciem lub przeciąganiem oraz zmieniają kolejność SelectedItems przyciskami Góra i Dół (ShowReorderButtons). SortAvailable, ShowFilter, ShowCaptions, ReadOnly, metody MoveToSelected, MoveAllToSelected, MoveToAvailable, MoveAllToAvailable, MoveUp i MoveDown, OnMoving, aby zachować element, oraz jedno OnChange na operację. Wielokrotny wybór, przenoszenie klawiaturą i układ od prawej do lewej. SelectedItems wiąże się dwukierunkowo w WPF i Avalonia. | Pomoc | |
| NumPad dla paneli dotykowych | TsgcVCLNumPad to ekranowa klawiatura numeryczna zadokowana na formularzu, a TsgcVCLNumPadPopup otwiera ten sam pad na liście rozwijanej pod swoim celem (TsgcFMXNumPad i TsgcFMXNumPadPopup w FireMonkey oraz NumPad w .NET). Wpisuje do pola liczbowego, pola walutowego, wskaźników pokrętła i suwaka z sgcGauges oraz standardowego pola edycji, ustawianego przez Associate lub przejmowanego z kontrolki z fokusem. Pad odczytuje zakres i miejsca dziesiętne celu i zapisuje wartość jako zmianę użytkownika, z klawiszami dość dużymi na palec lub rękawicę. | Pomoc | |
| Klawiatura ekranowa | TsgcVCLKeyboard to pełna klawiatura ekranowa zadokowana na formularzu, a TsgcVCLKeyboardPopup otwiera ją na liście rozwijanej pod edytorem, który dostaje fokus, z AutoPopup, AutoPopupAll, PopupPosition i CloseOnEnter (TsgcFMXKeyboard i TsgcFMXKeyboardPopup w FireMonkey, TsgcWinFormsKeyboard, TsgcWpfKeyboard i TsgcAvaloniaKeyboard z oknami rozwijanymi w .NET). Pisze do kontrolki z fokusem albo do Associate i nigdy nie przejmuje fokusu. Strony z literami, symbolami i cyframi, Shift, Caps Lock, AltGr i martwe klawisze, dziesięć wbudowanych układów (en-US, en-GB, es-ES, fr-FR, de-DE, it-IT, pt-BR, nl-NL, pl-PL, tr-TR), własne układy przez sgcKeyboardRegisterLayout, klawisz układu przełączający pozycje z Layouts, motywy, układ od prawej do lewej i dostępność. OnKeyText zmienia lub anuluje wpisywany tekst, a OnEnterKey działa po Enterze. | Pomoc | |
| Kontrolka układu | TsgcVCLLayoutControl i TsgcFMXLayoutControl (w .NET TsgcWinFormsLayoutControl, TsgcWpfLayoutControl i TsgcAvaloniaLayoutControl) układają dowolne kontrolki, zarówno sgcEditors, jak i standardowe, w grupach, grupach z kartami i kolumnach, z etykietami wyrównanymi do jednej szerokości, rozdzielaczami, które użytkownik może przeciągać, elementami, które użytkownik może ukryć, i układami od prawej do lewej. Czytniki ekranu widzą grupy i karty. We wszystkich edycjach; Delphi Community nie ma pakietu czasu projektowania dla sgcEditors, więc tam kontrolkę układu tworzy się w kodzie. | Pomoc |
| Funkcja | Szczegóły | Community | Pomoc |
|---|---|---|---|
| Edytory powiązane z danymi | Wybór daty, wybór czasu, pole liczbowe, ocena, suwak zakresu, pole z przyciskami, pole z maską, pole walutowe, memo i pole z listą wyboru wiążą DataSource i DataField; suwak zakresu wiąże też EndDataField, a pole z listą wyboru wypełnia listę z drugiego zbioru danych przez ListSource, KeyField i ListField. Pola null są puste. Delphi i C++ Builder. | Zarejestrowana | Pomoc |
| Wiązanie danych w WinForms | Wybór daty i czasu, pole liczbowe, ocena, suwak zakresu oraz pola z przyciskami, z maską, walutowe, z listą wyboru i memo w WinForms wiążą pole przez DataSource, DataMember i DataField: BindingSource, DataTable, DataView lub List. | Zarejestrowana | Pomoc |
| Listy wyboru z dowolnej kolekcji | ItemsSource, DisplayMember i ValueMember wypełniają pole z listą wyboru w WinForms, WPF i Avalonia; SelectedValue i SelectedItem zwracają obiekty z typami. | Pomoc | |
| Walidacja | Walidator z sgcUICore sprawdza kontrolki sgcEditors i standardowe według reguł: wymagane, zakres, długość, wyrażenie regularne, e-mail, porównanie i własne, z ramką, ikoną, listą podsumowania i dostępnymi komunikatami, w VCL, FireMonkey, WinForms, WPF i Avalonia. W .NET pokazuje też błędy IDataErrorInfo i INotifyDataErrorInfo. | Pomoc | |
| Smart Paste | Kalendarz miesięczny, selektory daty, czasu i daty z czasem, pole liczbowe, ocena, edytor tokenów, selektor koloru, pola z przyciskami, z maską, walutowe i z listą wyboru oraz memo biorą udział w Smart Paste. TsgcVCLSmartPaste i TsgcFMXSmartPaste (w .NET TsgcWinFormsSmartPaste, TsgcWpfSmartPaste i TsgcAvaloniaSmartPaste) zamieniają wklejony tekst, na przykład e-mail lub blok adresowy, na wartości kontrolek formularza, zarówno sgcEditors, jak i standardowych edytorów, list rozwijanych, pól wyboru i kontrolek daty, z cofnięciem i przyciskiem Smart Paste. Do dostawcy AI wysyłany jest tylko wklejony tekst i opisy pól, a bez dostawcy lokalny parser czyta wiersze takie jak Nazwa: wartość. | Pomoc | |
| Generator formularzy danych | TsgcVCLDataForm i TsgcFMXDataForm budują kompletny formularz edycji na kontrolce układu ze zbioru TDataSet, z jedną kontrolką sgcEditors na pole, dobraną według jego typu, albo z published właściwości klasy przez RTTI z użyciem BindObject. W .NET TsgcWinFormsDataForm, TsgcWpfDataForm i TsgcAvaloniaDataForm przyjmują DataTable, DataView, listę lub pojedynczy obiekt. Fields ustawia podpis, rodzaj, grupę, kartę i kolejność każdego pola, a nawigator dodaje pierwszy, poprzedni, następny, ostatni, nowy, edycję, usuń, zatwierdź i anuluj. Delphi, C++ Builder i .NET. | Zarejestrowana | Pomoc |
| Walidacja formularza danych | Każde pole staje się regułami walidatora sgcUICore: wymagane, zakres, długość, wyrażenie regularne i e-mail, a do własnych sprawdzeń służy OnValidateField. Post najpierw waliduje rekord, podsumowanie wymienia błędy, a nieprawidłowe pole na karcie, która nie jest widoczna, wybiera swoją kartę. | Zarejestrowana | Pomoc |
| Smart Paste w formularzu danych | SmartPaste, SmartPasteAsync i SmartPasteFromClipboard, także jako przycisk nawigatora, wypełniają każde pole rekordu z wklejonego tekstu przez warstwę AI, której edytory używają do własnego Smart Paste. Pola, które wypełnił, pokazują znaczek AI, a SmartPasteUndo przywraca stare wartości. Bez dostawcy lokalny parser czyta wiersze takie jak Nazwa: wartość. | Zarejestrowana | Pomoc |
| Układy zapisywane jako JSON | SaveLayout i LoadLayout zachowują kolejność, element nadrzędny, rozmiary i widoczność każdego elementu, aktywną kartę każdej grupy z kartami oraz elementy ukryte przez użytkownika, jako JSON, do ciągu znaków, strumienia lub pliku. Układ zapisany przez starszą kompilację ładuje się w nowszej. | Pomoc |
| Funkcja | Szczegóły | Community | Pomoc |
|---|---|---|---|
| Prawdziwe wprowadzanie tekstu | Pola daty, czasu, liczby i hex to natywne pola edycji, więc działają IME, schowek, cofanie i czytniki ekranu. | Pomoc | |
| Lokalizacja | Każda kontrolka ma własne ustawienia regionalne: nazwy dni i miesięcy, formaty, pierwszy dzień tygodnia, FormatSettings dla każdej kontrolki. | Pomoc | |
| Klawiatura | F4 lub Alt+Strzałka w dół dla list rozwijanych, strzałki oraz PageUp i PageDown w kalendarzu, kółko myszy i automatyczne powtarzanie w polu liczbowym, skrót dla każdego przycisku edytora, ramka fokusu. | Pomoc | |
| DPI dla każdego monitora | Układ w pikselach logicznych przy 96 DPI, skalowany dla każdego monitora, z listą rozwijaną rysowaną w DPI jej monitora. | Pomoc | |
| Od prawej do lewej (arabski i hebrajski) | Przyciski zmiany wartości, listy rozwijanej i czyszczenia przechodzą na drugą stronę, a kierunek suwaka i oceny, kolejność dni tygodnia w kalendarzu, strzałki i układ tokenów są odbite lustrzanie. Wewnętrzne pole edycji dostaje ten sam kierunek. | Pomoc | |
| Czytniki ekranu i wysoki kontrast | Każdy edytor udostępnia swoją rolę, nazwę i wartość w UI Automation, razem z częściami edytorów złożonych (części daty, tokeny, gwiazdki oceny, kolor, przyciski edytora, lista pola z listą wyboru) i ich oknami podręcznymi, gdy są otwarte, a niepoprawne pole zgłasza swój stan i komunikat o błędzie. Ramka fokusu jest zawsze widoczna, a wysoki kontrast Windows jest respektowany. Domyślnie włączone w VCL (Delphi 7 do 13), FireMonkey w Windows, WinForms, WPF i Avalonia. | Pomoc |
| Funkcja | Szczegóły | Community | Pomoc |
|---|---|---|---|
| Motywy | Jasny i ciemny motyw jedną właściwością, plus AccentColor, TextStyle i kolor błędu dla walidacji. | Pomoc | |
| Renderowanie bez interfejsu | SaveToPNG i SaveToSVG na każdej kontrolce i na modelach bezgłowych, także w Linux64. Pola z przyciskami, wyszukiwania, z maską, walutowe i z listą wyboru oraz memo zachowują tekst wartości w PNG, SVG i na wydrukowanych lub podglądanych stronach. | Pomoc |
| Zadanie | Standardowe kontrolki Delphi | sgcEditors |
|---|---|---|
| Wybierz datę lub czas z listy rozwijanej | TDateTimePicker | TsgcVCLDatePicker, TsgcVCLTimePicker |
| Data i czas w jednej kontrolce | TDateTimePicker | TsgcVCLDateTimePicker |
| Wybierz zakres dni o maksymalnej długości | TMonthCalendar | esmRange, MaxRangeDays |
| Zablokuj pojedyncze daty i dni tygodnia | TMonthCalendar | DisabledDates, DisabledWeekDays, OnIsDateDisabled |
| Ustawienia regionalne dla każdej kontrolki | TDateTimePicker | FormatSettings |
| Wprowadzanie z maską w składni Delphi lub .NET | TMaskEdit | TsgcVCLMaskEdit, MaskSyntax |
| Wybierz wiersz z listy wielokolumnowej | TDBLookupComboBox | TsgcVCLLookupEdit, TsgcVCLDBLookupEdit |
| Edytor z przyciskami | TButtonedEdit | TsgcVCLButtonEdit |
| Wpisz liczbę na panelu dotykowym | TTouchKeyboard | TsgcVCLNumPad, TsgcVCLNumPadPopup |
| Wpisz tekst na ekranie dotykowym | TTouchKeyboard | TsgcVCLKeyboard, TsgcVCLKeyboardPopup |
| Przełącznik włącz i wyłącz dla ustawień | TToggleSwitch | TsgcVCLToggleSwitch |
| Edycja adresu IPv4 lub IPv6 | TMaskEdit | TsgcVCLIPAddressEdit |
| Wpisanie czasu trwania, na przykład limitu czasu | TSpinEdit | TsgcVCLTimeSpanEdit |
| Wybór rodziny czcionek z podglądem | TComboBox z Screen.Fonts, TFontDialog | TsgcVCLFontPicker |
| Lista opcji z polami wyboru | TCheckListBox | TsgcVCLCheckListBox |
| Przenoszenie elementów między dwiema listami | Dwie kontrolki TListBox i przyciski | TsgcVCLDualListBox |
Tylko możliwości, zgodnie z opisem w pomocy. Bez twierdzeń o wydajności.
Edytory .NET to port C# z tymi samymi nazwami i zdarzeniami, dla WinForms, WPF i Avalonia. W WPF właściwości wartości są właściwościami zależności, które wiążą się dwukierunkowo. Pole z listą wyboru przyjmuje ItemsSource, DisplayMember i ValueMember w każdym hoście, a w edycji Zarejestrowanej edytory WinForms wiążą pole przez DataSource, DataMember i DataField.
| Pakiet | Edycja | Zawartość |
|---|---|---|
esegece.sgcEditors.Community | Community (bezpłatna) | Biblioteka podstawowa |
esegece.sgcEditors.WinForms.Community | Community (bezpłatna) | Kontrolki Windows Forms |
esegece.sgcEditors.Wpf.Community | Community (bezpłatna) | Kontrolki WPF |
esegece.sgcEditors.Avalonia.Community | Community (bezpłatna) | Kontrolki Avalonia |
esegece.sgcEditors.Rendering.Community | Community (bezpłatna) | Renderowanie bez interfejsu |
esegece.sgcEditors | Zarejestrowana | Biblioteka podstawowa |
esegece.sgcEditors.WinForms | Zarejestrowana | Kontrolki Windows Forms |
esegece.sgcEditors.Wpf | Zarejestrowana | Kontrolki WPF |
esegece.sgcEditors.Avalonia | Zarejestrowana | Kontrolki Avalonia |
esegece.sgcEditors.Rendering | Zarejestrowana | Renderowanie bez interfejsu |
Każda funkcja sgcEditors jest opisana w pomocy sgcUI, z osobną wersją dla każdego środowiska programistycznego.
Zacznij od wprowadzenia do sgcEditors, a potem przejdź do szybkiego startu i tematów o funkcjach.
Delphi →Cała pomoc sgcUI jako plik PDF, do czytania offline lub wydruku.
Delphi (PDF) →