OleUIAddVerbMenuW-Funktion (oledlg.h)

Artikel
03/01/2024

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

Syntax

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

Parameter

[in, optional] lpOleObj

Zeiger auf die IOleObject-Schnittstelle für das ausgewählte Objekt. Wenn dies NULL ist, wird ein standardmäßig deaktiviertes Menüelement erstellt.

[in, optional] lpszShortType

Zeiger auf den kurzen Namen, der in der Registrierung (AuxName==2) für das mit lpOleObj identifizierte Objekt definiert ist. Wenn die Zeichenfolge nicht bekannt ist, wird möglicherweise NULL übergeben. Wenn NULL übergeben wird, wird IOleObject::GetUserType aufgerufen, um es abzurufen. Wenn der Aufrufer einfachen Zugriff auf die Zeichenfolge hat, kann sie schneller übergeben werden.

[in] hMenu

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

[in] uPos

Position des Menüelements.

[in] uIDVerbMin

Der Bezeichnerwert, mit 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 am unteren Rand des Menüs (voran ein Trennzeichen) ein Convert-Element hinzugefügt werden soll.

[in] idConvert

Der Bezeichnerwert, der für das Menüelement Konvertieren verwendet werden soll, wenn bAddConvertTRUE ist.

[out] lphMenu

Ein HMENU-Zeiger auf das kaskadierende Verbmenü, wenn es erstellt wird. Wenn es nur ein Verb gibt, wird dieses 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. Eine FALSE-Rückgabe gibt an, dass lpOleObjNULL und ein deaktiviertes Standardmenüelement erstellt wurde.

Hinweise

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

Hinweis

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 nicht codierungsneutralem Code 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
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	oledlg.h
Bibliothek	OleDlg.lib
DLL	OleDlg.dll

Share via