Share via

Método IRichEditOleCallback::GetContextMenu (richole.h)

  • Artigo

Consulta o aplicativo para um menu de contexto a ser usado em um evento de clique com o botão direito do mouse.

Sintaxe

HRESULT GetContextMenu(
  WORD        seltype,
  LPOLEOBJECT lpoleobj,
  CHARRANGE   *lpchrg,
  HMENU       *lphmenu
);

Parâmetros

seltype

Tipo: WORD

Tipo de seleção. O valor, que especifica o conteúdo da nova seleção, pode ser um ou mais dos valores a seguir.

Valor Significado
SEL_EMPTY
 A seleção está vazia.
SEL_TEXT
 Text.
SEL_OBJECT
 Pelo menos um objeto COM.
SEL_MULTICHAR
 Mais de um caractere de texto.
SEL_MULTIOBJECT
 Mais de um objeto COM.
GCM_RIGHTMOUSEDROP
 Indica que um menu de contexto para uma queda de arrastar do mouse à direita deve ser gerado. O parâmetro lpoleobj é um ponteiro para a interface IDataObject para o objeto que está sendo descartado.

lpoleobj

Tipo: LPOLEOBJECT

Ponteiro para uma interface. Se o parâmetro seltype incluir o sinalizador SEL_OBJECT , lpoleobj será um ponteiro para a interface IOleObject para o primeiro objeto COM selecionado. Se seltype incluir o sinalizador GCM_RIGHTMOUSEDROP , lpoleobj será um ponteiro para uma interface IDataObject . Caso contrário, lpoleobj será NULL. Se você se apegar ao ponteiro da interface, deverá chamar o método AddRef para incrementar a contagem de referência do objeto.

lpchrg

Tipo: CHARRANGE*

Ponteiro para uma estrutura CHARRANGE que contém a seleção atual.

lphmenu

Tipo: HMENU*

O identificador de um menu de contexto a ser usado. Esse parâmetro será ignorado se um erro for retornado. Um controle de edição avançada destrói o menu quando ele é concluído com ele para que o cliente não deva.

Retornar valor

Tipo: HRESULT

Retornará S_OK se houver êxito. Se o método falhar, ele poderá ser o valor a seguir.

Código de retorno Descrição
E_INVALIDARG
 Houve um argumento inválido.

Comentários

Quando o usuário seleciona um item na janela de contexto, uma mensagem de WM_COMMAND é enviada para a janela pai do controle de edição avançada.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [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 richole.h
DLL Msftedit.dll

Confira também

CHARRANGE

GETCONTEXTMENUEX

Iricheditolecallback

Referência