Compartilhar via

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

  • Artigo

O método ITfUIElementSink::BeginUIElement é chamado quando o UIElement foi iniciado. Esse coletor pode permitir que o serviço de texto desenhe ou não desenhe o elemento de interface do usuário.

Sintaxe

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

Parâmetros

[in] dwUIElementId

[in] ID do UIElement que foi iniciado.

pbShow

[in, out] Retornará true se o aplicativo não desenhar o conteúdo UIElement e o serviço de texto desenhar seu conteúdo original da interface do usuário. Retornará false se o aplicativo desenhar o conteúdo do UIElement e impedir que o serviço de texto o desenhe. O aplicativo pode obter a interface ITfUIElement usando ITfUIElementMgr::GetUIElement e pode avaliar se pode manipular o UIElement por QI com IID_ITfCandidateListUIElement ou com outras interfaces UIElement. O aplicativo sempre poderá retornar FALSE se for desconhecido ou não puder ser manipulado. Nesse caso, o serviço de texto não mostrará nenhuma interface do usuário extra na tela. Essa é uma boa maneira para alguns aplicativos de tela inteira. Como alternativa, o aplicativo pode retornar TRUE para usar a interface do usuário do TextService em algumas interfaces do usuário específicas ou desconhecidas.

Retornar valor

O gerenciador do TSF ignora o valor retornado desse método.

Valor Descrição
S_OK
 O método foi bem-sucedido.
E_FAIL
 Ocorreu um erro não especificado.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho msctf.h
DLL Msctf.dll
Redistribuível TSF 1.0 no Windows 2000 Professional