Функция CreatePopupMenu создает “выпадающее” меню, подменю или контекстное меню. Меню вначале пустое. Вы можете вставлять или добавлять в конец пункты меню при помощи использования функции InsertMenuItem. Вы можете также использовать и функцию InsertMenu, чтобы вставлять пункты меню, а функцию AppendMenu, чтобы добавлять в конец пункты меню.
Синтаксис
HMENU CreatePopupMenu(VOID); |
Параметры
У этой функции нет параметров.
Возвращаемые значения
Если функция завершается успешно, величина возвращаемого значения - дескриптор недавно созданного меню.
Если функция завершается ошибкой, величина возвращаемого значения - ПУСТО (NULL). Чтобы получить дополнительные сведения об ошибке, вызовите GetLastError.
Замечания
Прикладная программа может добавлять новое меню в существующее меню, или она может показывать на экране контекстное меню путем вызова функции TrackPopupMenuEx или TrackPopupMenu.
Ресурсы, связанные с меню, которое предназначены окну, освобождаются автоматически. Если меню окну не назначено, прикладная программа должна освободить ресурсы системы, связанные с меню перед закрытием. Приложение освобождает ресурсы меню путем вызова функция DestroyMenu.
Windows 95/98/Me: система может поддерживать максимум 16,364 дескрипторов меню.
Пример
Пример смотри в статье Добавление меню Линии и Диаграммы.
Смотри также
Краткий обзор Меню, AppendMenu, CreateMenu, DestroyMenu, InsertMenu, InsertMenuItem, SetMenu, TrackPopupMenu, TrackPopupMenuEx
Размещение и совместимость CreatePopupMenu |
|
Windows. NET Server |
Да |
Windows XP |
Да |
Windows 2000 |
Да |
Windows NT |
Да версии 3.1 и выше |
Windows Me |
Да |
Windows 98 |
Да |
Windows 95 |
Да |
Используемая библиотека |
User32.lib |
Заголовочный файл |
|
- объявлено в |
Winuser.h |
- включено в |
Windows.h |
Unicode |
Нет |
Замечания по платформе |
Не имеется |