UIElement.TextInput Zdarzenie
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Występuje, gdy ten element pobiera tekst w sposób niezależny od urządzenia.
public:
virtual event System::Windows::Input::TextCompositionEventHandler ^ TextInput;public event System.Windows.Input.TextCompositionEventHandler TextInput;member this.TextInput : System.Windows.Input.TextCompositionEventHandler Public Custom Event TextInput As TextCompositionEventHandler Typ zdarzenia
Implementuje
Uwagi
Ważne
To zdarzenie może być już oznaczone jako obsługiwane przez wewnętrzne implementacje złożonych kontrolek. Zobacz uwagi poniżej.
Zdarzenie TextInput może być już oznaczone jako obsługiwane przez wewnętrzne implementacje złożonych kontrolek. Na przykład element to TextBox złożona kontrolka, w której TextInput zdarzenie jest już oznaczone jako obsługiwane; w ramach jego kompositingu. Kontrolki to robią, ponieważ kontrolka musi interpretować niektóre typy danych wejściowych, takich jak klawisze strzałek, ponieważ ma specjalne znaczenie dla tej kontrolki. Jeśli używasz PreviewTextInput jako zdarzenia, w którym dołączasz programy obsługi dla wprowadzania tekstu, możesz otrzymać lepsze wyniki. Ta technika pozwala obejść większość przypadków, w których kompozycja sterowania oznaczyła to zdarzenie jako obsługiwane i uniemożliwia programowi obsługi odbieranie zdarzenia wzdłuż trasy zdarzenia.
Zdarzenie TextInput umożliwia składnikowi lub aplikacji nasłuchiwanie danych wejściowych tekstu w sposób niezależny od urządzenia. Klawiatura jest podstawowym środkiem TextInput, ale mowy, pisma ręcznego i innych urządzeń wejściowych może również podnieść TextInput.
Ze względu na kombinacje klawiszy — w domyślnych klawiaturach lub za pośrednictwem edytorów metod wejściowych — wiele zdarzeń klawiszy może zgłosić tylko jedno zdarzenie wprowadzania tekstu.
To zdarzenie tworzy alias dla dołączonego TextCompositionManager.TextInput zdarzenia dla tej klasy, dzięki czemu TextInput jest częścią listy składowych klasy, gdy UIElement jest dziedziczony jako element podstawowy. Programy obsługi zdarzeń dołączone do TextInput zdarzenia są dołączane do bazowego TextCompositionManager.TextInput dołączonego zdarzenia i odbierają to samo wystąpienie danych zdarzenia.
Informacje dotyczące kierowanego zdarzenia
| Pole identyfikatora | TextInputEvent |
| Strategia routingu | Propagacji |
| Delegat | TextCompositionEventHandler |
Odpowiednie zdarzenie tunelowania to PreviewTextInput.
Zastąp OnTextInput implementację obsługi klas dla tego zdarzenia w klasach pochodnych.
