Freigeben über


ITipAutocompleteClient::RequestShowUI-Methode

Bestimmt, ob der Eingabebereich bereit ist, die Liste der automatisch abgeschlossenen Elemente anzuzeigen.

Syntax

HRESULT RequestShowUI(
  [in]  HWND hWndACList,
  [out] BOOL *pfAllowShowing
);

Parameter

hWndACList [in]

Fensterhandle der Benutzeroberfläche für die automatische Vervollständigung der Liste.

pfAllowShowing [out]

FALSE , wenn der Client empfiehlt, die Benutzeroberfläche der automatisch abgeschlossenen Liste nicht anzuzeigen. TRUE , wenn der Anbieter für automatische Vervollständigung die Benutzeroberfläche der Liste anzeigen kann.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
Erfolg.
E_FAIL
Es ist ein unbekannter Fehler aufgetreten.

Bemerkungen

Diese Methode wird vom Anbieter für automatische Vervollständigung aufgerufen, wenn die Benutzeroberfläche für automatische Vervollständigung angezeigt werden soll. Wenn der interne Clientstatus es dem Anbieter nicht zulässt, die Benutzeroberfläche anzuzeigen, wird pfAllowShowing auf FALSE festgelegt. Wenn der Text beispielsweise von der Handschrift-Skin des Eingabebereichs tablet PC an das Feld gesendet wird und der Benutzer sofort mit der Freihandeingabe beginnt, empfiehlt der Client, die Benutzeroberfläche für die automatische Vervollständigung nicht anzuzeigen, um eine Zerstörung der Freihandeingabe des Benutzers zu vermeiden, indem pfAllowShowing auf FALSE festgelegt wird.

Rufen Sie RequestShowUI auf, um das Popup-Fensterhandle auto complete festzulegen, bevor Sie die ITipAutocompleteClient::P referredRects-Methode aufrufen. Wenn dies nicht geschieht, wird beim Aufrufen von PreferredRects ein E_INVALIDARG Fehler verursacht.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows XP Tablet PC Edition [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Nicht unterstützt
Header
TipAutoComplete.h (erfordert auch Peninputpanel_i.c)
DLL
Tiptsf.dll

Siehe auch

ITipAutocompleteClient-Schnittstelle

ITipAutocompleteClient::P referredRects-Methode

Texteingabebereichsreferenz