Функция SetMenuItemInfoA (winuser.h)

Изменяет сведения о элементе меню.

Синтаксис

BOOL SetMenuItemInfoA(
  [in] HMENU            hmenu,
  [in] UINT             item,
  [in] BOOL             fByPositon,
  [in] LPCMENUITEMINFOA lpmii
);

Параметры

[in] hmenu

Тип: HMENU

Дескриптор меню, содержащий элемент меню.

[in] item

Тип: UINT

Идентификатор или положение элемента меню для изменения. Значение этого параметра зависит от значения fByPositon.

[in] fByPositon

Тип: BOOL

Значение uItem. Если этот параметр имеет значение FALSE, uItem — это идентификатор элемента меню. В противном случае это положение элемента меню. Дополнительные сведения см. в разделе "О меню ". (Примечание. Этот параметр неправильно указан в заголовке; его следует использовать, как показано здесь.)

[in] lpmii

Тип: LPMENUITEMINFO

Указатель на структуру MENUITEMINFO, которая содержит сведения о элементе меню и указывает, какие атрибуты элемента меню необходимо изменить.

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

Тип: BOOL

Если функция выполнена успешно, возвращаемое значение ненулевое.

Если функция завершается ошибкой, возвращаемое значение равно нулю. Чтобы получить расширенные сведения об ошибке, используйте функцию GetLastError.

Замечания

Приложение должно вызывать функцию DrawMenuBar всякий раз при изменении меню, находится ли меню в отображаемом окне.

Чтобы ускорители клавиатуры работали с растровым изображением или элементами меню, нарисованным владельцем, владелец меню должен обработать сообщение WM_MENUCHAR. Дополнительные сведения см. в меню Owner-Drawn и сообщения WM_MENUCHAR.

Примеры

Пример см. в примере Owner-Drawn элементов меню.

Требования

См. также

концептуальные

DrawMenuBar

GetMenuItemInfo

MENUITEMINFO

меню

Справочник