ContentElement.TextInput Událost

Definice

Nastane, když tento prvek získá text způsobem nezávislým na zařízení.

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 

Event Type

Implementuje

Poznámky

Důležité

Tato událost už může být označená jako zpracovávaná interními implementacemi složených ovládacích prvků. Viz poznámka níže.

Událost TextInput již může být označena jako zpracovávaná vnitřními implementacemi složených ovládacích prvků. Například je TextBox složený ovládací prvek, kde TextInput je událost již označena jako zpracována; v rámci svého sestavení. Ovládací prvky to dělají, protože ovládací prvek musí interpretovat některé typy vstupu, například klávesy se šipkami, jako by tento ovládací prvek měl zvláštní význam. Pokud použijete PreviewTextInput jako událost, ke které připojíte obslužné rutiny pro zadávání textu, můžete získat lepší výsledky. Tato technika obchází většinu případů, kdy složení ovládacích prvků již označilo tuto událost jako zpracovaný a zabraňuje obslužné rutině v přijetí události podél trasy události.

Událost TextInput umožňuje komponentě nebo aplikaci naslouchat textovému zadání způsobem nezávislým na zařízení. Primárním prostředkem TextInputfunkce je klávesnice, ale řeč, rukopis a další vstupní zařízení mohou také vyvolat TextInput.

Kvůli kombinacím kláves – buď ve výchozích klávesnicích, nebo prostřednictvím editorů vstupních metod – může více klíčových událostí vyvolat pouze jednu událost textového vstupu.

Tato událost vytvoří alias pro připojenou TextCompositionManager.TextInput událost pro tuto třídu, takže TextInput je součástí seznamu členů třídy, pokud ContentElement je zděděna jako základní prvek. Obslužné rutiny událostí, které jsou připojené k TextInput události, jsou připojené k podkladové TextCompositionManager.TextInput připojené události a přijímají stejnou instanci dat události.

Informace o směrované události

Pole Identifikátor TextInputEvent
Strategie směrování Bublající
Delegát TextCompositionEventHandler
  • Odpovídající událost tunelování je PreviewTextInput.

  • Přepsání OnTextInput pro implementaci zpracování třídy pro tuto událost v odvozených třídách.

Platí pro