SetMenuItemBitmaps

A função SetMenuItemBitmaps associa o bitmap especificado com um item de menu. Se o item de menu é marcada ou desmarcada, o sistema exibe o bitmap apropriado Avançar ao item de menu.

(BOOL SetMenuItemBitmaps HMENU  hMenu, / / identificador para o menuUINTuPosition, / / menu item para receber novo bitmapsUINTuFlags, / / item de menu sinalizadoresHBITMAPhBitmapUnchecked, / / identificador para o bitmap desmarcadoHBITMAPhBitmapChecked / / identificador para o bitmap selecionado);
 

Parâmetros

hMenu
Identificador para o menu que contém o item para receber novo bitmaps marca de seleção.
uPosition
Especifica o item de menu a ser alterado, conforme determinado pelo uFlags parâmetro.
uFlags
Especifica como o parâmetro uPosition é interpretado. A uFlags parâmetro deve ser um dos seguintes valores.
Valor Significado
MF_BYCOMMAND Indica que uPosition dá o identificador do item de menu. Se nem MF_BYCOMMAND MF_BYPOSITION é especificada, MF_BYCOMMAND é a bandeira de padrão.
MF_BYPOSITION Indica que uPosition dá o relativo posição baseada em zero do item de menu.

hBitmapUnchecked
Identificador para o bitmap exibido quando o item de menu não é verificado.
hBitmapChecked
Identificador para o bitmap exibido quando o item de menu é verificado.

Retornar valores

Se a função for bem-sucedido, o valor de retorno é diferente de zero.

Se a função falhar, o valor de retorno é zero. Para informações de erro estendidas get, chamar GetLastError.

Observações

Se o hBitmapUnchecked ou o hBitmapChecked parâmetro é NULL, o sistema exibe nada Avançar ao item de menu para o estado de seleção correspondente. Se ambos os parâmetros são NULL, o sistema exibe o bitmap de marca de seleção padrão quando o item é verificado e remove o bitmap quando o item não é marcado.

Quando o menu é destruído, esses bitmaps não são destruídos; é up to o aplicativo para destruí-los.

Os bitmaps checked and desmarcados deve ser monocromático. O sistema usa o operador booleano AND para combinar bitmaps com o menu de modo que a parte branca se torna transparente e a parte preta se tornará a cor do item de menu. Se você usar bitmaps de cor, os resultados podem ser indesejáveis.

Usar o GetSystemMetrics função com os valores CXMENUCHECK e CYMENUCHECK para recuperar as dimensões de bitmap.

QuickInfo

nbsp; Windows &NT: requer a versão 3.1 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Sem suporte.
Cabeçalho:Declarado em WinUser. h.
Biblioteca de importação:Use user32.lib.

Ver também

Visão geral de menus, funções de Menu, GetSystemMetrics

Index