TextEdit – vzor ovládacího prvku

Představuje pokyny a konvence pro implementaci ITextEditProvider, včetně informací o vlastnostech a metodách. Vzor ovládacího prvku TextEdit slouží k programovému přístupu k ovládacímu prvku, který upravuje text, například ovládací prvek, který provádí automatickou opravu nebo povoluje složení vstupu.

Poznámka

Poznámky k implementaci v tomto tématu odkazují na rozhraní API, která pocházejí z rozhraní TSF (Text Services Framework). Další informace o TSF a referenční informace k rozhraní API naleznete v tématu Rozhraní text Services Framework.

Požadované členy pro ITextEditProvider

Tyto vlastnosti a metody jsou vyžadovány pro implementaci ITextEditProvider rozhraní.

Požadované členy	Typ členu	Poznámky
GetActiveComposition	Metoda	Vrátí oblast aktuálního převodu (žádná, pokud neexistuje žádný převod). Vrátí aktivní složení (v TSF je to rozsah označený GUID_PROP_COMPOSING). Například pomocí editoru IME (Microsoft Japanese Input Method Editor) by to byl celý podtržený text.
GetConversionTarget	Metoda	Vrátí aktuální cílový rozsah převodu (žádný, pokud žádný převod neexistuje). V TSF je to rozsah znaků označených jako TF_ATTR_TARGET_NOTCONVERTED nebo TF_ATTR_TARGET_CONVERTED ze struktury TF_DISPLAYATTRIBUTE.

Události TextEditTextChanged a ConversionTargetChanged jsou vyžadovány elementy Microsoft UI Automation podporující vzor TextEdit.

TextEditTextChanged

• Pomocí funkce UiaRaiseTextEditTextChangedEvent vyvoláte událost TextEditTextChanged.
• Následující tabulka uvádí případy, kdy byste měli vyvolat událost a UiaRaiseTextEditTextChangedEvent parametry, které se mají použít.

TextEditChangeType	Datová část události	Poznámky
automatické opravy	Nový opravený řetězec	Vyvolá se, když ovládací prvek provede automatickou opravu. Nebo kdykoli je nahrazení provedeno prostřednictvím TSF a rozsah má GUID_PROP_TKB_ALTERNATES hodnotu TKB_ALTERNATES_AUTOCORRECTION_APPLIED.
složení	Aktualizovaný řetězec	Datová část musí obsahovat pouze znaky, které se změnily (neodesílejte celý řetězec složení). Vyvolá se při každé výměně složení. V nástroji TSF je nahrazení složení definováno jako náhrada, která obsahuje sadu příznaků GUID_PROP_COMPOSING. Úpravy ovládacích prvků implementovaných TSF může monitorovat tyto změny prostřednictvím oznámení OnEndEdit.
CompositionFinalized	Finalizovaný řetězec složení (viz Poznámky)	V TSF je řetězec převodu, který se finalizuje, definován příznakem GUID_PROP_COMPOSING, který se odebere ze složení. Edit controls implement TSF should determine the finalized string from EndComposition and raise the event when OnEndEdit isvolat. Finalizovaný řetězec složení může být prázdný, pokud bylo složení zrušeno nebo odstraněno.

ConversionTargetChanged

• ConversionTargetChanged nastane, když se cíl převodu změní z jednoho cíle na jiný.
• Pomocí funkce UiaRaiseAutomationEvent vyvoláte událost ConversionTargetChanged (předejte identifikátor události UIA_TextEdit_ConversionTargetChangedEventId).
• ConversionTargetChanged by neměl být vyvolán při změně obsahu cíle. Pokud dojde ke změně cíle současně se změnou složení, musí být událost cílové změny vyvolána po vyvolání všech událostí složení.
• V TSF je cíl převodu definován hodnotou, TF_ATTR_TARGET_CONVERTED je nastavena ze struktury TF_DISPLAYATTRIBUTE. Změny lze monitorovat pomocí onEndEdit.

Související témata

koncepční

typy ovládacích prvků a jejich podporované vzory ovládacích prvků

Přehled vzorů ovládacích prvků automatizace uživatelského rozhraní

Přehled stromu automatizace uživatelského rozhraní