Freigeben über

ITfUIElementSink::BeginUIElement-Methode (msctf.h)

  • Artikel

Die ITfUIElementSink::BeginUIElement-Methode wird aufgerufen, wenn das UIElement gestartet wurde. Diese Senke kann es dem textdienst ermöglichen, das UI-Element zu zeichnen oder nicht zu zeichnen.

Syntax

HRESULT BeginUIElement(
  [in] DWORD dwUIElementId,
       BOOL  *pbShow
);

Parameter

[in] dwUIElementId

[in] ID des gestarteten UIElements.

pbShow

[ein, aus] Gibt true zurück, wenn die Anwendung den UIElement-Inhalt nicht zeichnet und der Textdienst den ursprünglichen Ui-Inhalt zeichnet. Gibt false zurück, wenn die Anwendung den Inhalt des UIElements zeichnet und den Textdienst am Zeichnen anhält. Die Anwendung kann die ITfUIElement-Schnittstelle mithilfe von ITfUIElementMgr::GetUIElement abrufen und auswerten, ob sie das UIElement von QI mit IID_ITfCandidateListUIElement oder mit anderen UIElement-Schnittstellen verarbeiten kann. Die Anwendung kann immer FALSE zurückgeben, wenn sie unbekannt ist oder nicht verarbeitet werden kann. In diesem Fall zeigt der Textdienst keine zusätzliche Benutzeroberfläche auf dem Bildschirm an. Dies ist eine gute Möglichkeit für einige Vollbildanwendungen. Alternativ kann die Anwendung TRUE zurückgeben, um die Benutzeroberfläche von TextService auf bestimmten oder unbekannten UIs zu verwenden.

Rückgabewert

Der TSF-Manager ignoriert den Rückgabewert dieser Methode.

Wert BESCHREIBUNG
S_OK
 Die Methode war erfolgreich.
E_FAIL
 Es ist ein unbekannter Fehler aufgetreten.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile msctf.h
DLL Msctf.dll
Verteilbare Komponente TSF 1.0 unter Windows 2000 Professional