UIElement.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 již může být označena 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á interními implementacemi složených ovládacích prvků. Například je TextBox složený ovládací prvek, ve TextInput kterém je událost již označena jako zpracována v rámci své kompozice. Ovládací prvky to dělají, protože ovládací prvek musí interpretovat některé typy vstupu, jako jsou klávesy se šipkami, jako by pro tento ovládací prvek měl zvláštní význam. Pokud jako událost použijete PreviewTextInput připojení obslužných rutin 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 zvládnutou a zabraňuje obslužné rutině přijímat událost podél trasy události.

Událost TextInput umožňuje komponentě nebo aplikaci naslouchat textovému vstupu nezávisle na zařízení. Klávesnice je primárním prostředkem , TextInputale řeč, rukopis a další vstupní zařízení mohou také zvýšit 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 několik 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 UIElement je zděděna jako základní prvek. Obslužné rutiny událostí, které jsou připojené k TextInput události, jsou připojeny 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říd pro tuto událost v odvozených třídách.

Platí pro