Funzione OleUIAddVerbMenuW (oledlg.h)

Articolo
11/20/2024

Aggiunge il menu verbo per l'oggetto specificato al menu specificato.

Sintassi

BOOL OleUIAddVerbMenuW(
  [in, optional] LPOLEOBJECT lpOleObj,
  [in, optional] LPCWSTR     lpszShortType,
  [in]           HMENU       hMenu,
  [in]           UINT        uPos,
  [in]           UINT        uIDVerbMin,
  [in]           UINT        uIDVerbMax,
  [in]           BOOL        bAddConvert,
  [in]           UINT        idConvert,
  [out]          HMENU       *lphMenu
);

Parametri

[in, optional] lpOleObj

Puntatore all'interfaccia IOleObject sull'oggetto selezionato. Se si tratta di NULL, viene creata una voce di menu disabilitata predefinita.

[in, optional] lpszShortType

Puntatore al nome breve definito nel Registro di sistema (AuxName===2) per l'oggetto identificato con lpOleObj. Se la stringa non è nota, è possibile passare NULL. Se viene passato NULL, IOleObject::GetUserType viene chiamato per recuperarlo. Se il chiamante ha facile accesso alla stringa, è più veloce passarlo.

[in] hMenu

Gestire il menu in cui apportare modifiche.

[in] uPos

Posizione della voce di menu.

[in] uIDVerbMin

Valore dell'identificatore in corrispondenza del quale iniziare i verbi.

[in] uIDVerbMax

Valore massimo dell'identificatore da utilizzare per i verbi oggetto. Se uIDVerbMax è 0, non viene usato alcun valore di identificatore massimo.

[in] bAddConvert

Indica se aggiungere un elemento Converti nella parte inferiore del menu (preceduto da un separatore).

[in] idConvert

Valore dell'identificatore da utilizzare per la voce di menu Convert , se bAddConvert è TRUE.

[out] lphMenu

Puntatore HMENU al menu verbo a catena, se creato. Se è presente un solo verbo, questo verrà riempito con NULL.

Valore restituito

Questa funzione restituisce TRUE se lpOleObj è valido e al menu è stato aggiunto almeno un verbo. Un false restituito indica che lpOleObj è stato NULL e è stata creata una voce di menu predefinita disabilitata.

Osservazioni

Se l'oggetto ha un verbo, il verbo viene aggiunto direttamente al menu specificato.

Nota

L'intestazione oledlg.h definisce OleUIAddVerbMenu come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	oledlg.h
libreria	OleDlg.lib
dll	OleDlg.dll

Condividi tramite