Partilhar via


CMenu::GetDefaultItem

Determina o item de menu padrão no menu especificado.

UINT GetDefaultItem(
   UINT gmdiFlags,
   BOOL fByPos = FALSE 
);

Parâmetros

  • gmdiFlags
    Valor que especifica como a função pesquisa de itens de menu.Esse parâmetro pode ser nenhum, um ou uma combinação dos seguintes valores:

    Valor

    Significado

    GMDI_GOINTOPOPUPS

    Especifica que, se o item padrão é um que abre um submenu, a função Pesquisar a recursivamente submenu correspondente.Se o submenu não tiver nenhum item padrão, o valor retornado identifica o item que abre o submenu.

    Por padrão, a função retornará o primeiro item padrão no menu especificado, independentemente de ele é um item que abre um submenu.

    GMDI_USEDISABLED

    Especifica que a função retornar um item padrão, mesmo que ele esteja desabilitado.

    Por padrão, a função ignora itens cinza ou desabilitadas.

  • fByPos
    Valor que especifica se recuperar o identificador do item de menu ou sua posição.Se esse parâmetro for FALSE, o identificador retornado.Caso contrário, a posição é retornada.

Valor de retorno

Se a função obtiver êxito, o valor retornado é o identificador ou a posição do item de menu.Se a função falhar, do valor retornado será - 1.

Comentários

Esta função de membro implementa o comportamento do Win32 função GetMenuDefaultItem, conforme descrito no Windows SDK.

Exemplo

Consulte o exemplo para CMenu::InsertMenu.

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

Classe CMenu

Gráfico de hierarquia

CMenu::SetDefaultItem

Outros recursos

CMenu membros