Funzione OleSetMenuDescriptor (ole2.h)

Installa o rimuove il codice di invio OLE dalla finestra del frame del contenitore.

Sintassi

HRESULT OleSetMenuDescriptor(
  [in] HOLEMENU                 holemenu,
  [in] HWND                     hwndFrame,
  [in] HWND                     hwndActiveObject,
  [in] LPOLEINPLACEFRAME        lpFrame,
  [in] LPOLEINPLACEACTIVEOBJECT lpActiveObj
);

Parametri

[in] holemenu

Gestire il descrittore di menu composito restituito dalla funzione OleCreateMenuDescriptor . Se NULL, il codice di invio viene scollegato.

[in] hwndFrame

Gestire la finestra del frame del contenitore in cui deve essere installato il menu composito sul posto.

[in] hwndActiveObject

Gestire la finestra di attivazione sul posto dell'oggetto. OLE invia messaggi di menu e comandi a questa finestra.

[in] lpFrame

Puntatore all'interfaccia IOleInPlaceFrame nella finestra del frame del contenitore.

[in] lpActiveObj

Puntatore all'interfaccia IOleInPlaceActiveObject nell'oggetto attivo sul posto.

Valore restituito

Questa funzione restituisce S_OK in caso di esito positivo.

Commenti

Il contenitore deve chiamare OleSetMenuDescriptor per installare il codice di invio in hwndFrame quando l'oggetto chiama il metodo IOleInPlaceFrame::SetMenu o per rimuovere il codice di invio passando NULL come valore per holemenu a OleSetMenuDescriptor.

Se i parametri lpFrame e lpActiveObj non sono NULL, OLE installa il filtro dei messaggi F1 sensibile al contesto per l'applicazione. In caso contrario, l'applicazione deve specificare il proprio filtro messaggi.

Requisiti

Vedi anche

IOleInPlaceActiveObject

IOleInPlaceFrame::SetMenu

OleCreateMenuDescriptor