Método ITfMenu::AddMenuItem (ctfutb.h)
Adiciona um item ao menu que a barra de idiomas exibirá para o botão.
Sintaxe
HRESULT AddMenuItem(
[in] UINT uId,
[in] DWORD dwFlags,
[in] HBITMAP hbmp,
[in] HBITMAP hbmpMask,
[in] const WCHAR *pch,
[in] ULONG cch,
ITfMenu **ppMenu
);
Parâmetros
[in] uId
Contém o identificador do item de menu.
[in] dwFlags
Contém zero ou uma combinação de um ou mais dos valores TF_LBMENUF_* que especificam o tipo e o estado do item de menu.
[in] hbmp
Contém o identificador do bitmap desenhado para o item de menu. Se for NULL, nenhum bitmap será exibido para o item de menu.
[in] hbmpMask
Contém o identificador do bitmap de máscara. Este é um bitmap monocromático que funciona como uma máscara para hbmp. Cada pixel preto neste bitmap fará com que o pixel correspondente no hbmp seja exibido em sua cor normal. Cada pixel branco neste bitmap fará com que o pixel correspondente no hbmp seja exibido no inverso de sua cor normal.
Para que o bitmap seja exibido sem nenhuma conversão de cor, crie um bitmap monocromático do mesmo tamanho que hbmp e defina cada pixel como preto (RGB(0, 0, 0)).
Se hbmp for NULL, esse parâmetro será ignorado.
[in] pch
Ponteiro para um buffer WCHAR que contém o texto a ser exibido para o item de menu. O comprimento do texto é especificado por cch.
[in] cch
Especifica o comprimento, em WCHAR, do texto do item de menu no pch.
ppMenu
[in, out] Ponteiro para um ponteiro de interface ITfMenu que recebe o objeto submenu. Esse parâmetro não é usado e deve ser NULL se dwFlags não contiver TF_LBMENUF_SUBMENU.
Se o item de submenu for criado com êxito, esse parâmetro receberá um objeto ITfMenu que o chamador usa para adicionar itens ao submenu.
Se dwFlags contiver TF_LBMENUF_SUBMENU, esse valor deverá ser inicializado como NULL antes de chamar esse método porque, na maioria dos casos, essa é uma chamada marshalled. Não inicializar essa variável resulta na tentativa do marshaller de acessar memória aleatória.
Valor retornado
Esse método pode retornar um desses valores.
| Valor | Descrição |
|---|---|
|
O método foi bem-sucedido. |
|
Ocorreu um erro não especificado. |
|
Ocorreu uma falha de alocação de memória. |
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 |