Функция OleUIAddVerbMenuA (oledlg.h)

Статья
11/20/2024

Добавляет меню команды для указанного объекта в указанное меню.

Синтаксис

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

Параметры

[in, optional] lpOleObj

Указатель на интерфейс IOleObject выбранного объекта. Если это null, создается отключенный пункт меню по умолчанию.

[in, optional] lpszShortType

Указатель на короткое имя, определенное в реестре (AuxName==2) для объекта, определяемого lpOleObj. Если строка не известна, может быть передана NULL. Если передается NULL, вызывается IOleObject::GetUserType для получения. Если вызывающий объект имеет простой доступ к строке, он быстрее передает его.

[in] hMenu

Обработайте меню, в котором необходимо внести изменения.

[in] uPos

Положение элемента меню.

[in] uIDVerbMin

Значение идентификатора, с которого нужно запустить команды.

[in] uIDVerbMax

Максимальное значение идентификатора, используемое для команд объекта. Если uIDVerbMax равно 0, то не используется максимальное значение идентификатора.

[in] bAddConvert

Указывает, следует ли добавлять элемент в нижней части меню (перед разделителем).

[in] idConvert

Значение идентификатора, используемое для элемента меню преобразования , если bAddConvert TRUE.

[out] lphMenu

Указатель HMENU на каскадное меню команды, если он создан. Если существует только одна команда, это будет заполнено NULL.

Возвращаемое значение

Эта функция возвращает TRUE, если lpOleObj действительна, а в меню добавлена по крайней мере одна команда. Возврат FALSE указывает, что lpOleObj был NULL и создан отключенный элемент меню по умолчанию.

Замечания

Если объект имеет одну команду, команда добавляется непосредственно в заданное меню.

Заметка

Заголовок oledlg.h определяет OleUIAddVerbMenu как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	oledlg.h
библиотеки	OleDlg.lib
DLL	OleDlg.dll

Поделиться через