Функция SetMenuItemInfo

Функция SetMenuItemInfo изменяет информацию о пункте меню.

Синтаксис

BOOL SetMenuItemInfo(
    HMENU hMenu,
    UINT uItem,
    BOOL fByPosition,
    LPMENUITEMINFO lpmii
); 

Параметры

hMenu

[in] Дескриптор меню, которое содержит пункт.

uItem

[in] Идентификатор или позиция пункта меню, который измениться. Значение этого параметра зависит от значения fByPosition.

fByPosition

[in] Значение, устанавливающее значение uItem. Если этот параметр - ЛОЖЬ (FALSE), uItem - идентификатор пункта меню. В противном случае, это - позиция пункта меню.

lpmii

[in] Указатель на структуру MENUITEMINFO, которая содержит информацию о пункте меню и устанавливает, какому пункту меню изменять атрибуты.

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

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

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

Замечания

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

Для ускорителей клавиатуры, чтобы работать с растровыми (значками) или нарисованными пользователем (собственными) пунктами меню, владелец меню должен обрабатывать сообщение WM_MENUCHAR. За подробной информацией обратитесь к статье Собственные меню и сообщение WM_MENUCHAR.

Windows 95/98/Me: SetMenuItemInfoW поддерживается программой Microsoft Layer for Unicode. Чтобы использовать ее, Вы должны добавить некоторые файлы к вашему приложению, как изложено в описании Microsoft Layer for Unicode для системы Windows 95/98/Me.

Пример

Пример смотри в статье Пример пунктов собственного меню.

Смотри также

Краткий обзор МенюDrawMenuBarGetMenuItemInfo, MENUITEMINFO

Размещение и совместимость SetMenuItemInfo

Windows. NET Server

Да

Windows XP

Да

Windows 2000

Да

Windows NT

Да версии 4.0 и выше

Windows Me

Да

Windows 98

Да

Windows 95

Да

Используемая библиотека

User32.lib

Заголовочный файл

 

- объявлено в

Winuser.h

- включено в

Windows.h

Unicode

Нет

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz