ContentElement.TextInput Zdarzenie

Definicja

Występuje, gdy ten element Pobiera tekst w sposób niezależny od urządzenia.Occurs when this element gets text in a device-independent manner.

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 

Implementuje

Uwagi

Ważne

To zdarzenie może już być oznaczone jako obsługiwane przez wewnętrzne implementacje kontrolek złożonych.This event might already be marked as handled by the internal implementations of composited controls. Zobacz uwagi poniżej.See Remark below.

Zdarzenie TextInput może już być oznaczone jako obsługiwane przez wewnętrzne implementacje kontrolek złożonych.The TextInput event may already be marked as handled by the internal implementations of composited controls. Na przykład TextBox to złożona kontrolka, w której zdarzenie TextInput jest już oznaczone jako obsługiwane; w ramach jego złożenia.For example, a TextBox is a composited control where the TextInput event is already marked as handled; within its compositing. Kontrolki to, ponieważ kontrolka musi interpretować niektóre typy danych wejściowych, takich jak klawisze strzałek, jako mające specjalne znaczenie dla tej kontrolki.Controls do this because the control needs to interpret some types of input, such as arrow keys, as having special meaning to that control. Jeśli używasz PreviewTextInput jako zdarzenia, gdzie dołączasz programy obsługi do wprowadzania tekstu, możesz uzyskać lepsze wyniki.If you use PreviewTextInput as the event where you attach handlers for text input, you may receive better results. Ta technika omija większość przypadków, w których kompozycja formantów już oznaczył to zdarzenie jako obsłużone i uniemożliwia programowi obsługi otrzymywanie zdarzenia wzdłuż trasy zdarzenia.This technique circumvents most cases where control composition has already marked this event as handled and prevents your handler from receiving the event along the event route.

Zdarzenie TextInput umożliwia składnikowi lub aplikacji nasłuchiwanie danych tekstowych w sposób niezależny od urządzenia.The TextInput event allows a component or application to listen for text input in a device-independent manner. Klawiatura jest podstawowym środkiem TextInput, ale rozpoznawanie mowy, pisma ręcznego i inne urządzenia wejściowe mogą również podnieść TextInput.The keyboard is the primary means of TextInput, but speech, handwriting, and other input devices can also raise TextInput.

Ze względu na kombinacje klawiszy — w domyślnych klawiaturach lub za pomocą edytorów metod wejściowych — wiele kluczowych zdarzeń może wywoływać tylko jedno zdarzenie wprowadzania tekstu.Because of key combinations - either in default keyboards or through input method editors - multiple key events might raise just one text input event.

To zdarzenie tworzy alias dla TextCompositionManager.TextInput dołączonego zdarzenia dla tej klasy, tak że TextInput jest częścią listy składowych klasy, gdy ContentElement jest dziedziczona jako element podstawowy.This event creates an alias for the TextCompositionManager.TextInput attached event for this class, so that TextInput is part of the class members list when ContentElement is inherited as a base element. Programy obsługi zdarzeń dołączone do zdarzenia TextInput są dołączone do bazowego TextCompositionManager.TextInput dołączonego zdarzenia i odbierają to samo wystąpienie danych zdarzenia.Event handlers that are attached to the TextInput event are attached to the underlying TextCompositionManager.TextInput attached event and receive the same event data instance.

Informacje dotyczące kierowanego zdarzeniaRouted Event Information

Pole identyfikatoraIdentifier field TextInputEvent
Strategia routinguRouting strategy PropagacjaBubbling
DelegateDelegate TextCompositionEventHandler
  • Odpowiednie zdarzenie tunelowania jest PreviewTextInput.The corresponding tunneling event is PreviewTextInput.

  • Zastąp OnTextInput, aby zaimplementować obsługę klasy dla tego zdarzenia w klasach pochodnych.Override OnTextInput to implement class handling for this event in derived classes.

Dotyczy