Função SetMenuItemBitmaps (winuser.h)

  • Artigo

Associa o bitmap especificado a um item de menu. Se o item de menu estiver selecionado ou desmarcado, o sistema exibirá o bitmap apropriado ao lado do item de menu.

Sintaxe

BOOL SetMenuItemBitmaps(
  [in]           HMENU   hMenu,
  [in]           UINT    uPosition,
  [in]           UINT    uFlags,
  [in, optional] HBITMAP hBitmapUnchecked,
  [in, optional] HBITMAP hBitmapChecked
);

Parâmetros

[in] hMenu

Tipo: HMENU

Um identificador para o menu que contém o item para receber novos bitmaps de marca marcar.

[in] uPosition

Tipo: UINT

O item de menu a ser alterado, conforme determinado pelo parâmetro uFlags .

[in] uFlags

Tipo: UINT

Especifica como o parâmetro uPosition deve ser interpretado. O parâmetro uFlags deve ser um dos valores a seguir.

Valor Significado
MF_BYCOMMAND
0x000000000L
 Indica que uPosition fornece o identificador do item de menu. Se nem MF_BYCOMMAND nem MF_BYPOSITION for especificado, MF_BYCOMMAND será o sinalizador padrão.
MF_BYPOSITION
0x00000400L
 Indica que uPosition fornece a posição relativa baseada em zero do item de menu.

[in, optional] hBitmapUnchecked

Tipo: HBITMAP

Um identificador para o bitmap exibido quando o item de menu não está selecionado.

[in, optional] hBitmapChecked

Tipo: HBITMAP

Um identificador para o bitmap exibido quando o item de menu é selecionado.

Valor retornado

Tipo: BOOL

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Se o parâmetro hBitmapUnchecked ou hBitmapChecked for NULL, o sistema não exibirá nada ao lado do item de menu do estado de marcar correspondente. Se ambos os parâmetros forem NULL, o sistema exibirá o bitmap de marca marcar padrão quando o item for selecionado e removerá o bitmap quando o item não estiver selecionado.

Quando o menu é destruído, esses bitmaps não são destruídos; cabe ao aplicativo destruí-los.

Os bitmaps selecionados e claros devem ser monocromáticos. O sistema usa o operador AND booliano para combinar bitmaps com o menu para que a parte branca se torne transparente e a parte preta se torne a cor do item de menu. Se você usar bitmaps de cor, os resultados poderão ser indesejáveis.

Use a função GetSystemMetrics com os valores SM_CXMENUCHECK e SM_CYMENUCHECK para recuperar as dimensões de bitmap.

Exemplos

Para obter um exemplo, consulte Simulando caixas de seleção em um menu.

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 winuser.h (inclua Windows.h)
Biblioteca User32.lib
DLL User32.dll

Confira também

Menus