Funzione OleUIAddVerbMenuA (oledlg.h)

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

Sintassi

BOOL OleUIAddVerbMenuA(
  [in, optional] LPOLEOBJECT lpOleObj,
  [in, optional] LPCSTR      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 nell'oggetto selezionato. Se è 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 , viene chiamato IOleObject::GetUserType 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 una voce Converti nella parte inferiore del menu (preceduta da un separatore).

[in] idConvert

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

[out] lphMenu

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

Valore restituito

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

Commenti

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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

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 oledlg.h
Libreria OleDlg.lib
DLL OleDlg.dll