Método IMenuPopup::P opup (shobjidl_core.h)

Artigo
03/05/2024

Invoca o menu de atalho em um local especificado na tela.

Sintaxe

HRESULT Popup(
  [in] POINTL        *ppt,
  [in] RECTL         *prcExclude,
  [in] MP_POPUPFLAGS dwFlags
);

Parâmetros

[in] ppt

Tipo: POINTL*

Um ponteiro para uma estrutura POINTL que especifica o local do menu pop-up nas coordenadas da tela. O menu pop-up é exibido em relação a esse ponto, conforme determinado pelos sinalizadores de posição definidos em dwFlags.

[in] prcExclude

Tipo: RECTL*

Um ponteiro para uma estrutura RECTL que especifica o retângulo a ser excluído ao posicionar o menu. No Windows Vista, o alinhamento do menu em relação a essa área é determinado pelos sinalizadores de alinhamento definidos em dwFlags. Esse parâmetro pode ser NULL para incluir a tela inteira.

[in] dwFlags

Tipo: MP_POPUPFLAGS

Uma ou mais das constantes a seguir que controlam a exibição do menu pop-up.

MPPF_SETFOCUS (0x00000001)

O menu deve ter foco quando ele aparecer.

MPPF_INITIALSELECT (0x00000002)

O primeiro item no menu deve ser selecionado.

MPPF_NOANIMATE (0x00000004)

Não anime este show.

MPPF_KEYBOARD (0x00000010)

O menu é ativado pelo teclado.

MPPF_REPOSITION (0x00000020)

Reposicione a barra exibida.

MPPF_FORCEZORDER (0x00000040)

A barra de menus deve ignorar as posições de submenu.

MPPF_FINALSELECT (0x00000080)

O último item no menu deve ser selecionado.

MPPF_TOP (0x20000000)

Exiba o menu pop-up acima do ponto especificado em ppt.

MPPF_LEFT (0x40000000)

Exiba o menu pop-up à esquerda do ponto especificado em ppt.

MPPF_RIGHT (0x60000000)

Exiba o menu pop-up à direita do ponto especificado em ppt.

MPPF_BOTTOM (0x80000000)

Exiba o menu pop-up abaixo do ponto especificado em ppt.

MPPF_POS_MASK (0xE0000000)

Mascarar valores de posição MPPF_TOP, MPPF_LEFT e MPPF_RIGHT.

MPPF_ALIGN_LEFT (0x02000000)

Alinhamento padrão.

MPPF_ALIGN_RIGHT (0x04000000)

O menu pop-up deve ser alinhado à direita do retângulo excluído especificado por prcExclude.

Retornar valor

Tipo: HRESULT

Retorna S_OK se o objeto implementar o menu pop-up como um menu de modelagem. Caso contrário, retorna S_FALSE, o que indica o fim da implementação do menu.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP com SP1 [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 (versão 5.0 ou posterior)

Compartilhar via