IContextMenu::QueryContextMenu

9/9/2008

O QueryContextMenu método adiciona os novos itens menu a um menu de contexto.

Syntax

HRESULT QueryContextMenu (
  HMENU hmenu, 
  UINT indexMenu, 
  UINT idCmdFirst, 
  UINT idCmdLast, 
  UINT uFlags 
);

Parameters

• hmenu
  [no] O menu ao qual os itens adicionais são adicionados.

• indexMenu
  [no] Especifica a localidade de menu (nunca deve ser – 1).

• idCmdFirst
  [no] O início do intervalo especificado.

• idCmdLast
  [no] O fim do intervalo especificado.

• uFlags
  [no] Especifica o contexto. Veja a seção Comentários seção para a lista de com suporte sinalizadores.

Return Value

QueryContextMenu Retorna o número de itens que foram adicionados para o menu de contexto. O número de itens adicionados também é o menu máximo deslocamento identificação item (USHORT) na (campo codificarLOWORD) da SCode.

Observação

Se não houver espaços entre itens menu, o número é fornecido como não se houvesse nenhum lacunas.

Remarks

O QueryContextMenu método pode inserir um ou mais novos itens menu no menu especificado hmenuno local especificado indexMenu, com as identificações desses itens menu. IDs devem estar no intervalo especificado de idCmdFirst Para idCmdLast. O QueryContextMenu método retorna o deslocamento identificação máximo item de menu (USHORT) na (campo codificarLOWORD) da SCode. O HIWORD está reservado para comunicações específico contexto e o LOWORD está reservado para uso sistema. O uFlags parâmetro especifica o contexto da chamada.

A seguinte tabela lista os valores possíveis para o uFlags parâmetro.

Sinalizador	Valor	Descrição
CMF_NORMAL	0 x 00000000	Passado quando o usuário clica com o botão direito do mouse ou toques e contém um objeto no de conteúdo painel. Isso é conhecido como a ação normal. Observe que um atalho pode manipulador arrastar - e - ato de soltar, namespace de extensão ou extensão menu adicionar todos os itens menu.
CMF_DEFAULTONLY	0 x 00000001	Passado quando o usuário clica duas vezes ou toques um objeto no de conteúdo painel. Isso é conhecido como a ação usar como padrão. QueryContextMenu Retorna NOERROR, e não há itens menu são adicionados para o menu de contexto.
CMF_VERBSONLY	0 x 00000002	Passado ao construir um menu de contexto de um curto-recortar objeto. QueryContextMenu Nunca Adiciona itens menu inadequado para menus contexto. É um exemplo de uma item de menu inadequado Excluir, porque ele não é Clear se Excluir deve remover o item de origem link ou apenas o link.
CMF_EXPLORE	0x00000004	Passado quando o usuário clica com o botão direito do mouse ou toques e contém um objeto no painel de navegação. Este sinalizador será ignorado.

Requirements

Header	shlobj.h
Windows Embedded CE	Windows CE 3.0 and later
Windows Mobile	Pocket PC 2000 and later

See Also

Reference

IContextMenu
IContextMenu::GetCommandString
IContextMenu::InvokeCommand