Compartilhar via


Método ITfLangBarItemButton::GetIcon (ctfutb.h)

Obtém o ícone a ser exibido para o botão da barra de idiomas.

Sintaxe

HRESULT GetIcon(
  [out] HICON *phIcon
);

Parâmetros

[out] phIcon

Ponteiro para um valor HICON que recebe o identificador de ícone. Receberá NULL se o botão não tiver nenhum ícone. O chamador deve liberar esse ícone quando ele não for mais necessário chamando DestroyIcon.

Valor retornado

Esse método pode retornar um desses valores.

Valor Descrição
S_OK
O método foi bem-sucedido.
E_INVALIDARG
phIcon é inválido.

Comentários

O tamanho ideal do ícone pode ser obtido chamando GetSystemMetrics(SM_CXSMICON) para a largura do ícone e GetSystemMetrics(SM_CYSMICON) para a altura do ícone.

Se o botão tiver o estilo TF_LBI_STYLE_TEXTCOLORICON, o ícone obtido por esse método deverá ser um ícone monocromático.

Requisitos

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