UIElement.TextInput Zdarzenie

Definicja

Przestrzeń nazw:

System.Windows

Zestaw:

PresentationCore.dll

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

TextCompositionEventHandler

Implementuje

TextInput

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.