Método ITfUIElementSink::BeginUIElement (msctf.h)

Se llama al método ITfUIElementSink::BeginUIElement cuando se inició uiElement. Este receptor puede permitir que el servicio de texto dibuje o no dibujar el elemento de la interfaz de usuario.

Sintaxis

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

Parámetros

[in] dwUIElementId

[in] Identificador de uiElement que se inició.

pbShow

[dentro, fuera] Devuelve true si la aplicación no dibuja el contenido UIElement y el servicio de texto dibuja su contenido de interfaz de usuario original. Devuelve false si la aplicación dibuja el contenido de UIElement y impide que el servicio de texto lo dibuje. La aplicación puede obtener la interfaz ITfUIElement mediante ITfUIElementMgr::GetUIElement y puede evaluar si puede controlar UIElement por QI con IID_ITfCandidateListUIElement o con otras interfaces UIElement. La aplicación siempre puede devolver FALSE si se desconoce o no se puede controlar. En este caso, el servicio de texto no mostrará ninguna interfaz de usuario adicional en la pantalla. Esta es una buena manera de algunas aplicaciones de pantalla completa. Como alternativa, la aplicación puede devolver TRUE para usar la interfaz de usuario de TextService en algunas interfaces de usuario concretas o desconocidas.

Valor devuelto

El administrador de TSF omite el valor devuelto de este método.

Valor	Descripción
S_OK	Método realizado correctamente.
E_FAIL	Se ha producido un error no especificado.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	Windows 2000 Server [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	msctf.h
Archivo DLL	Msctf.dll
Redistribuible	TSF 1.0 en Windows 2000 Professional