Condividi tramite

Metodo IRichEditOleCallback::GetContextMenu (richole.h)

  • Articolo

Esegue una query sull'applicazione per un menu di scelta rapida da usare in un evento di scelta rapida.

Sintassi

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

Parametri

seltype

Tipo: WORD

Tipo di selezione. Il valore, che specifica il contenuto della nuova selezione, può essere uno o più dei valori seguenti.

Valore Significato
SEL_EMPTY
 La selezione è vuota.
SEL_TEXT
 Text.
SEL_OBJECT
 Almeno un oggetto COM.
SEL_MULTICHAR
 Più di un carattere di testo.
SEL_MULTIOBJECT
 Più di un oggetto COM.
GCM_RIGHTMOUSEDROP
 Indica che deve essere generato un menu di scelta rapida per una selezione di trascinamento del mouse con il pulsante destro del mouse. Il parametro lpoleobj è un puntatore all'interfaccia IDataObject per l'oggetto da eliminare.

lpoleobj

Tipo: LPOLEOBJECT

Puntatore a un'interfaccia. Se il parametro seltype include il flag SEL_OBJECT , lpoleobj è un puntatore all'interfaccia IOleObject per il primo oggetto COM selezionato. Se seltype include il flag GCM_RIGHTMOUSEDROP , lpoleobj è un puntatore a un'interfaccia IDataObject . In caso contrario, lpoleobj è NULL. Se si tiene premuto il puntatore dell'interfaccia, è necessario chiamare il metodo AddRef per incrementare il conteggio dei riferimenti dell'oggetto.

lpchrg

Tipo: CHARRANGE*

Puntatore a una struttura CHARRANGE contenente la selezione corrente.

lphmenu

Tipo: HMENU*

Handle di un menu di scelta rapida da utilizzare. Questo parametro viene ignorato se viene restituito un errore. Un controllo rich edit elimina definitivamente il menu al termine dell'operazione, in modo che il client non debba.

Valore restituito

Tipo: HRESULT

Restituisce S_OK in caso di esito positivo. Se il metodo ha esito negativo, può essere il valore seguente.

Codice restituito Descrizione
E_INVALIDARG
 È presente un argomento non valido.

Commenti

Quando l'utente seleziona un elemento dalla finestra di contesto, viene inviato un messaggio WM_COMMAND alla finestra padre del controllo rich edit.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione richole.h
DLL Msftedit.dll

Vedi anche

CHARRANGE

GETCONTEXTMENUEX

IRichEditOleCallback

Riferimento