InsertMenu

A função InsertMenu insere um novo item de menu em um menu, mover outros itens para baixo no menu.

A função InsertMenu foi substituída pela função InsertMenuItem . Você pode ainda usar InsertMenu, no entanto, se você não precisa de nenhum dos recursos estendidos do InsertMenuItem.

(BOOL InsertMenu HMENU  hMenu, / / identificador para o menuUINTuPosition, / / menu item desse novo menu item precedeUINTuFlags, / / item de menu sinalizadoresUINTuIDNewItem, / / menu item identificador ou identificador para soltar-para baixo / / menu ou submenuLPCTSTRlpNewItem / / menu de item conteúdo);
 

Parâmetros

hMenu
Identificador para o menu a ser alterado.
uPosition
Especifica o item de menu antes que o novo item de menu é para ser inserido, conforme determinado pelo uFlags parâmetro.
uFlags
Especifica os sinalizadores que controlam a interpretação do uPosition parâmetro e o conteúdo, aparência e comportamento do novo item de menu. Este parâmetro deve ser uma combinação de um dos seguintes valores necessários e pelo menos um dos valores listados na seguinte seção Comentários.
Valor Descrição
MF_BYCOMMAND Indica que o parâmetro uPosition fornece o identificador do item de menu. O Sinalizar MF_BYCOMMAND é o padrão se nem o MF_BYCOMMAND ou MF_BYPOSITION Sinalizar for especificado.
MF_BYPOSITION Indica que o parâmetro uPosition oferece o relativo posição baseada em zero do item de menu novo. Se uPosition é 0xFFFFFFFF, o novo item de menu é acrescentado ao final do menu.

uIDNewItem
Especifica ambos o identificador do novo item de menu ou, se a uFlags parâmetro tiver o Sinalizar MF_POPUP definida, o identificador para o drop-down menu ou submenu.
lpNewItem
Especifica o conteúdo do novo item de menu. A interpretação de lpNewItem depende se a uFlags parâmetro inclui o sinalizador MF_BITMAP, MF_OWNERDRAW ou MF_STRING, da seguinte forma:
Valor Descrição
MF_BITMAP Contém um identificador de bitmap.
MF_OWNERDRAW Contém um valor de 32 bits fornecido pelo aplicativo que pode ser usado para manter dados adicionais relacionados ao item de menu. O valor está no itemData membro da estrutura apontado pelo lparam parâmetro da WM_MEASUREITEM ou WM_DRAWITEM mensagem enviada quando o item de menu é criado ou sua aparência é atualizada.
MF_STRING Contém um ponteiro para uma seqüência de caracteres null-terminated (o padrão).

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

O aplicativo deve chamar o DrawMenuBar função sempre que um menu muda, ou não o menu está em uma janela exibida.

A lista a seguir descreve os sinalizadores que podem ser definidos in a uFlags parâmetro:

Valor Descrição
MF_BITMAP Usa um bitmap como o item de menu. O lpNewItem parâmetro contém o identificador para o bitmap.
MF_CHECKED Coloca uma marca de seleção próxima ao item de menu. Se o aplicativo fornece bitmaps de marca de verificação (consulte SetMenuItemBitmaps), este sinalizador de Estado exibe o bitmap de marca de seleção próxima ao item de menu.
MF_DISABLED Desabilita o item de menu para que ele não pode ser selecionado, mas não cinza-lo.
MF_ENABLED Permite que o item de menu para que ele pode ser selecionado e restaura-lo de seu estado sombreado.
MF_GRAYED Desabilita o item de menu e grays-lo para que ele não pode ser selecionado.
MF_MENUBARBREAK Funções, o mesmo que o MF_MENUBREAK sinalizador para uma barra de menus. Para um drop-down menu, submenu ou menu de atalho, a nova coluna separada da coluna antiga por uma linha vertical.
MF_MENUBREAK Coloca o item em uma Novo linha (para barras de menus) ou em uma nova coluna (para um drop-down menu, submenu ou menu de atalho) sem separar colunas.
MF_OWNERDRAW Especifica que o item é um item owner-drawn. Antes que o menu é exibido pela primeira vez, a janela que possui o menu recebe uma mensagem WM_MEASUREITEM para recuperar a largura e a altura do item de menu. A mensagem WM_DRAWITEM , em seguida, é enviada para o procedimento janela da janela de proprietário, sempre que a aparência do item de menu deve ser atualizada.
MF_POPUP Especifica que o item de menu abre um Soltar-para baixo menu ou submenu. O parâmetro uIDNewItem especifica o identificador para o drop-down menu ou submenu. Este sinalizador é usado para adicionar um nome de menu para uma barra de menus ou um item de menu que abre um submenu para um drop-down menu, submenu ou menu de atalho.
MF_SEPARATOR Desenha uma linha divisória horizontal. Este sinalizador é usado somente em um drop-down menu, submenu ou menu de atalho. A linha não pode ser cinza, desabilitada ou realçada. Os lpNewItem e uIDNewItem parâmetros são ignorados.
MF_STRING Especifica que o item de menu é uma Cadeia de caracteres de texto; o lpNewItem parâmetro aponta para a seqüência de caracteres.
MF_UNCHECKED Não colocar uma marca de seleção próxima ao item de menu (padrão). Se o aplicativo fornece bitmaps de marca de Marcar (marcar a função SetMenuItemBitmaps ), este sinalizador exibe o bitmap desmarcado próximo para o item de menu.

Os seguintes grupos de sinalizadores não podem ser usados juntos:

Windows CE: Windows CE não suporta o sinalizador MF_BITMAP ou o sinalizador MF_DISABLED in a uFlags parâmetro. Itens de menu não podem ser desativados sem ser acinzentado. Para desativar um item de menu usar o sinalizador MF_GRAYED.

Windows CE versão 1.0 não suporta menus em cascata. Se você estiver usando o Windows CE 1.0, você não pode inserir um menu MF_POPUP em outro menu pop-up. Se usando o Windows CE 2.0 ou posterior, você pode.

Ver também

Visão geral de menus, funções de Menu, AppendMenu, DeleteMenu, DrawMenuBar, InsertMenuItem, ModifyMenu, RemoveMenu, SetMenuItemBitmaps, WM_DRAWITEM, WM_MEASUREITEM

Index