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

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	ole2.h
Libreria	Ole32.lib
DLL	Ole32.dll
Set di API	ext-ms-win-com-ole32-l1-1-5 (introdotta in Windows 10 versione 10.0.15063)

Vedi anche

IOleInPlaceActiveObject

IOleInPlaceFrame::SetMenu

OleCreateMenuDescriptor