Método IShellMenu::Initialize (shobjidl_core.h)

  • Artigo

Inicializa uma faixa de menu.

Sintaxe

HRESULT Initialize(
  [in, optional] IShellMenuCallback *psmc,
  [in]           UINT               uId,
  [in]           UINT               uIdAncestor,
  [in]           DWORD              dwFlags
);

Parâmetros

[in, optional] psmc

Tipo: IShellMenuCallback*

Um ponteiro para uma interface IShellMenuCallback . Essa interface recebe notificações do menu. Esse valor pode ser NULL.

[in] uId

Tipo: UINT

O identificador do item de menu selecionado. Defina esse parâmetro como -1 para o menu em si.

[in] uIdAncestor

Tipo: UINT

[in] dwFlags

Tipo: DWORD

Sinalizadores que controlam como o menu opera.

Uma combinação dos seguintes valores de opção:

Valor Significado
SMINIT_DEFAULT
 Não há opções.
SMINIT_RESTRICT_DRAGDROP
 Não permita arrastar e soltar.
SMINIT_TOPLEVEL
 Esta é a melhor banda.
SMINIT_CACHED
 Não destrua a banda quando a janela estiver fechada.
 

Além dos valores acima, uma das seguintes opções de layout:

Valor Significado
SMINIT_VERTICAL
 Especifica uma banda vertical.
SMINIT_HORIZONTAL
 Especifica uma faixa horizontal.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP com SP2 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shobjidl_core.h (inclua Shobjidl.h)
DLL Shell32.dll