ITfIntegratableCandidateListUIElement-Schnittstelle (ctffunc.h)

Artikel
02/24/2024

Ermöglicht Textdiensten und Eingabemethoden-Editoren (IMEs), das Verhalten im Modus ohne Benutzeroberfläche anzupassen.

Vererbung

Die ITfIntegratableCandidateListUIElement-Schnittstelle erbt von der IUnknown-Schnittstelle . ITfIntegratableCandidateListUIElement verfügt auch über folgende Membertypen:

Methoden

Die ITfIntegratableCandidateListUIElement-Schnittstelle verfügt über diese Methoden.


ITfIntegratableCandidateListUIElement::FinalizeExactCompositionString Schließt die aktuelle Komposition mit dem wert ab, der dem Benutzer derzeit angezeigt wird.
ITfIntegratableCandidateListUIElement::GetSelectionStyle Ruft das Auswahlformat ab.
ITfIntegratableCandidateListUIElement::OnKeyDown Verarbeitet einen Tastendruck.
ITfIntegratableCandidateListUIElement::SetIntegrationStyle Legt den Integrationsstil fest.
ITfIntegratableCandidateListUIElement::ShowCandidateNumbers Gibt an, ob Kandidatenzahlen angezeigt werden sollen.

Hinweise

Die ITfIntegratableCandidateListUIElement-Schnittstelle wird von Textdiensten und Eingabemethoden-Editoren (IMEs) implementiert, um das Verhalten im Modus ohne Benutzeroberfläche anzupassen, um eine bessere Benutzeroberfläche und Tastatureingabe in im IME integrierten Steuerelementen wie dem Windows 8 Suchfeld zu ermöglichen. Die Benutzeroberfläche wird von Apps verwendet, die eine optimierte Benutzeroberfläche und Tastatureingabe mit IME-Sprachen benötigen.

Sie können einen ITfIntegratableCandidateListUIElement-Schnittstellenzeiger abrufen, indem Sie QueryInterface für den ITfUIElement-Schnittstellenzeiger aufrufen, der mithilfe der dwUIElementId-Parameter der ITfUIElementSink-Rückruffunktionen bereitgestellt wird, um die Schnittstelle von ITfUIElementMgr abzurufen.

Die ITfIntegratableCandidateListUIElement-Schnittstelle ist eine optionale Schnittstelle, die von einem Textdienst oder IME implementiert wird und eine bessere Kontrolle darüber benötigt, wie die Benutzeroberfläche im Modus ohne Benutzeroberfläche dargestellt wird. Apps können sie verwenden, um optimierte, spezielle Eingabesteuerelemente zu implementieren, z. B. in Autovervollständigen oder Suchvorschlägen.

Implementieren Sie die ITfIntegratableCandidateListUIElement-Schnittstelle in derselben Klasse, die die Schnittstellen ITfUIElement, ITfCandidateListUIElement und ITfCandidateListUIElementBehavior implementiert. Diese Schnittstellen arbeiten zusammen, um eine vollständig integrierte Oberfläche zu erstellen, in der die App die Kandidatenlistenbenutzeroberfläche für den Textdienst oder imE rendert und auch einige IME-spezifische Ui-Anpassungen und Tastaturinteraktionsverhalten aufweisen kann.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	ctffunc.h

Weitere Informationen

ITfCandidateListUIElement

ITfCandidateListUIElementBehavior