Metodo ITfUIElementSink::BeginUIElement (msctf.h)

Il metodo ITfUIElementSink::BeginUIElement viene chiamato al momento dell'avvio di UIElement. Questo sink può consentire al servizio di testo di disegnare o meno di disegnare l'elemento dell'interfaccia utente.

Sintassi

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

Parametri

[in] dwUIElementId

[in] ID dell'oggetto UIElement avviato.

pbShow

[in, out] Restituisce true se l'applicazione non disegna il contenuto UIElement e il servizio di testo disegna il contenuto originale dell'interfaccia utente. Restituisce false se l'applicazione disegna il contenuto dell'UIElement e arresta il servizio di testo dal disegno. L'applicazione può ottenere l'interfaccia ITfUIElement usando ITfUIElementMgr::GetUIElement e può valutare se può gestire UIElement by QI con IID_ITfCandidateListUIElement o con altre interfacce UIElement. L'applicazione può sempre restituire FALSE se è sconosciuta o non può essere gestita. In questo caso, il servizio di testo non mostrerà alcun'interfaccia utente aggiuntiva sullo schermo. Questo è un buon modo per alcune applicazioni a schermo intero. In alternativa, l'applicazione può restituire TRUE per usare l'interfaccia utente di TextService in una determinata o sconosciuta UI.

Valore restituito

Il gestore TSF ignora il valore restituito di questo metodo.

Valore	Descrizione
S_OK	Il metodo è stato eseguito correttamente.
E_FAIL	Si è verificato un errore non specificato.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [app desktop | App UWP]
Server minimo supportato	Windows 2000 Server [app desktop | App UWP]
Piattaforma di destinazione	Windows
Intestazione	msctf.h
DLL	Msctf.dll
Componente ridistribuibile	TSF 1.0 in Windows 2000 Professional