MaskedEdit, kontrolka
Kontrolka MaskedEdit to kontrolka pola edycji zawierająca maskę w polu tekstowym kontrolki. Kontrolkę można skojarzyć z właściwością wartości ciągu, wprowadzając nazwę właściwości w kolumnie Właściwość tabeli Control Table.
Możesz użyć kontrolki MaskedEdit, aby utworzyć szablon do wprowadzania informacji przez użytkownika, takich jak numer telefonu lub kod identyfikatora produktu. Na przykład właściwośćPIDKEYmoże zostać wprowadzona przez użytkownika za pomocą kontrolki MaskedEdit określonej przez ustawienie właściwości PIDTemplate na ciąg podobny do następującego:
12345<### —%%%%%%%>@@@@@
Ciąg definiuje szablon maskowania dla wpisu właściwości PIDKEY przez użytkownika. Widoczny segment ciągu jest ujęta w parę znaków nawiasu (<>).
W poniższej tabeli zidentyfikowano składnię maski.
| Znak | Znaczenie |
|---|---|
| < | Lewy koniec widocznego segmentu szablonu. Ten znak i wszystko po lewej stronie są ukryte w interfejsie użytkownika. W szablonie nie powinno być więcej niż jedno wystąpienie tego znaku. |
| > | Prawy koniec widocznego segmentu szablonu. Ten znak i wszystko po prawej stronie są ukryte w interfejsie użytkownika. Ten znak jest zastępowany przez kreskę podczas walidacji. Jeśli istnieje widoczny segment zaczyna się od <, należy zakończyć go pasującym >. |
| # | Ten znak może być cyfrą (cyfrą). |
| % | Ten znak może być cyfrą alternatywną (cyfrą), która umożliwia maski kontrolowanie sposobu, w jaki akcja niestandardowa rozróżnia pola. |
| @ | Ten znak może być cyfrą losową (cyfrą). Ten znak nie powinien być wyświetlany w widocznej części szablonu. |
| & | Ten znak może być dowolnym znakiem. |
| ^ | Ten znak może być znakiem alternatywnym, który umożliwia maski kontrolowanie sposobu, w jaki akcja niestandardowa rozróżnia pola. |
| ? | Ten znak może być znakiem alternatywnym, który umożliwia maski kontrolowanie sposobu, w jaki akcja niestandardowa rozróżnia pola. |
| ` | Znaki akcentu grobowego " (wartość ASCII 96) mogą reprezentować alternatywny znak, który umożliwia maski kontrolowanie sposobu, w jaki akcja niestandardowa rozróżnia pola. |
| _ | Ten znak jest znakiem podkreślenia literału. |
| = | Ten znak jest terminatorem pola. Musi to być zgodne z wartością #, %, ^lub '. Spowoduje to utworzenie jeszcze jednej pozycji wejściowej tego samego typu co poprzednie pozycje i zakończenie pola separatorem "-". |
Każdy inny znak jest traktowany jako stała literału.
W przypadku znaków, które można edytować, kontrolka tworzy oddzielne okna edycji z jednym oknem dla każdego bloku ciągłych znaków tego samego rodzaju.
Atrybuty kontrolki
Aby zmienić wartość atrybutu używającego zdarzenia, zasubskrybuj kontrolkę do zdarzenia kontrolki w tabeli EventMapping i wyświetl identyfikator atrybutu w kolumnie Atrybut. Wprowadź identyfikator zdarzenia kontrolki w kolumnie Zdarzenie. Następujące atrybuty można użyć z kontrolką MaskedEdit.
| Atrybut | Bit szesnastkowy | Opis |
|---|---|---|
| IndirectPropertyName | Jest to nazwa właściwości pośredniej skojarzonej z kontrolką. Jeśli bit atrybutu pośredniego jest ustawiony, kontrolka wyświetla lub zmienia wartość właściwości, która ma tę nazwę. Jeśli bit atrybutu pośredniego jest ustawiony, ta nazwa jest również wartością właściwości wymienionej w kolumnie Właściwość tabeli Control Table. | |
| położenie | Pozycja kontrolki w oknie dialogowym. Wprowadź szerokość, wysokość i współrzędne lewego rogu kontrolki w kolumnach Width(Szerokość), Height (Wysokość), X (X) i Y (Y) tabeli sterowania . Użyj Jednostki instalatora długości i odległości. |
|
| PropertyName | Jest to nazwa właściwości skojarzonej z tą kontrolką. Jeśli bit atrybutu pośredniego nie jest ustawiony, kontrolka wyświetla lub zmienia wartość właściwości, która ma tę nazwę. Ten atrybut jest określony w kolumnie Właściwość tabeli sterowania . | |
| PropertyValue | Bieżąca wartość właściwości, która jest wyświetlana lub zmieniana przez tę kontrolkę. Jeśli bit atrybutu pośredniego nie jest ustawiony, jest to wartość PropertyName. Jeśli bit atrybutu pośredniego jest ustawiony, jest to wartość IndirectPropertyName. Jeśli atrybut ulegnie zmianie, kontrolka odzwierciedla nową wartość. | |
| tekstu | Aby ustawić czcionkę i styl czcionki ciągu tekstowego, przedrostek ciągu wyświetlanych znaków z stylem {\style} lub {&style}. Gdzie styl jest identyfikatorem wymienionym w kolumnie Styl tabeli TextStyle. Jeśli żadna z nich nie istnieje, ale DefaultUIFont właściwość jest zdefiniowana jako prawidłowy styl tekstu, ta czcionka jest używana. Ciąg określający szablon maskowania jest zgodny z tym prefiksem i używa składni opisanej wcześniej w tym temacie. | |
| widoczne | 0x00000000 0x00000001 |
Ukryta kontrolka. Widoczna kontrolka. Uwzględnij ten bit w bitowym słowie kolumny Atrybuty w tabeli sterowania , aby kontrolka była widoczna lub ukryta podczas jej tworzenia. Możesz również ukryć lub pokazać kontrolkę przy użyciu ControlCondition Table. |
| włączone | 0x00000000 0x00000002 |
Sterowanie w stanie wyłączonym. Kontrolka w stanie włączonym. Uwzględnij ten bit w wyrazie bitowym w kolumnie Atrybuty tabeli Control Table, aby włączyć kontrolkę tworzenia. Możesz również włączyć lub wyłączyć kontrolkę przy użyciu ControlCondition Table. |
| zatopione | 0x00000000 0x00000004 |
Wyświetla domyślny styl wizualizacji. Wyświetla kontrolkę z zatopiony wygląd 3-W. Uwzględnij te bity w wyrazie bitowym w kolumnie Atrybuty tabeli Control Table. |
| pośrednie | 0x00000000 0x00000008 |
Kontrolka wyświetla lub zmienia wartość właściwości w kolumnie Właściwość tabeli Control Table. Kontrolka wyświetla lub zmienia wartość właściwości, która ma identyfikator wymieniony w kolumnie Właściwość tabeli sterowania . Określa, czy właściwość skojarzona z tą kontrolką jest odwołana pośrednio. |
Uwagi
Kontrolka MaskedEdit tworzy jedno okno nadrzędne klasy BUTTON ze stylami BS_OWNERDRAW i WS_EX_CONTROLPARENT. Tworzy kilka okien podrzędnych w tym oknie.
- W przypadku stałych części tekstu tworzy okna STATYCZNe ze stylami SS_LEFT i WS_CHILD.
- W przypadku pól edytowalnych tworzy okno EDYCJA z stylami WS_CHILD, WS_BORDERi WS_TABSTOP.
- W przypadku pól liczbowych okno ma również styl ES_NUMBER.
Alternatywne cyfry, %i alternatywne znaki alfanumeryczne, ^, ?i ' umożliwiają akcje niestandardowe rozróżniania pól w sposób, który może być kontrolowany przez maskę, na przykład ^ może służyć do pól, które powinny być wielkie.