ContentElement.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.

TextInput Zdarzenie 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ż mają specjalne znaczenie dla tej kontrolki. Jeśli używasz PreviewTextInput jako zdarzenia, w którym dołączasz programy obsługi do wprowadzania tekstu, możesz otrzymać lepsze wyniki. Ta technika pomija 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 , ale mowy, pisma ręcznego TextInputi innych urządzeń wejściowych może również podnieść TextInputwartość .

Ze względu na kombinacje klawiszy — w domyślnych klawiaturach lub za pomocą edytorów metod wejściowych — wiele kluczowych zdarzeń może zgłaszać tylko jedno zdarzenie wprowadzania tekstu.

To zdarzenie tworzy alias dla dołączonego TextCompositionManager.TextInput zdarzenia dla tej klasy, więc TextInput jest to część listy składowych klasy, gdy ContentElement jest dziedziczona jako element podstawowy. Programy obsługi zdarzeń TextInput dołączone do zdarzenia są dołączone 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 , aby zaimplementować obsługę klas dla tego zdarzenia w klasach pochodnych.