OleUIAddVerbMenuA-Funktion (oledlg.h)

Artikel
11/20/2024

Fügt dem angegebenen Menü das Verb Menü für das angegebene Objekt hinzu.

Syntax

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
);

Parameter

[in, optional] lpOleObj

Zeigen Sie auf die IOleObject Schnittstelle des ausgewählten Objekts. Wenn dies NULL-ist, wird ein standardmäßiges deaktiviertes Menüelement erstellt.

[in, optional] lpszShortType

Zeiger auf den in der Registrierung definierten Kurznamen (AuxName==2) für das mit lpOleObjidentifizierte Objekt. Wenn die Zeichenfolge nicht bekannt ist, wird möglicherweise NULL- übergeben. Wenn NULL- übergeben wird, wird IOleObject::GetUserType aufgerufen, um sie abzurufen. Wenn der Aufrufer einfachen Zugriff auf die Zeichenfolge hat, ist es schneller, die Zeichenfolge zu übergeben.

[in] hMenu

Behandeln Sie das Menü, in dem Änderungen vorgenommen werden sollen.

[in] uPos

Position des Menüelements.

[in] uIDVerbMin

Der Bezeichnerwert, bei dem die Verben gestartet werden sollen.

[in] uIDVerbMax

Der maximale Bezeichnerwert, der für Objektverben verwendet werden soll. Wenn uIDVerbMax 0 ist, wird kein maximaler Bezeichnerwert verwendet.

[in] bAddConvert

Gibt an, ob ein Convert-Element am unteren Rand des Menüs hinzugefügt werden soll (vorangestellt durch ein Trennzeichen).

[in] idConvert

Der bezeichnerwert, der für das Menüelement Convert verwendet werden soll, wenn bAddConvertTRUEist.

[out] lphMenu

Ein HMENU Zeiger auf das Kaskadierende Verbmenü, wenn es erstellt wird. Wenn nur ein Verb vorhanden ist, wird dies mit NULL-gefüllt.

Rückgabewert

Diese Funktion gibt TRUE zurück, wenn lpOleObj gültig war und mindestens ein Verb zum Menü hinzugefügt wurde. Ein FALSE Rückgabe gibt an, dass lpOleObj-NULL- und ein deaktiviertes Standardmenüelement erstellt wurde.

Bemerkungen

Wenn das Objekt ein Verb aufweist, wird das Verb direkt zum angegebenen Menü hinzugefügt.

Anmerkung

Der oledlg.h-Header definiert OleUIAddVerbMenu als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	oledlg.h
Library	OleDlg.lib
DLL-	OleDlg.dll

Freigeben über