Функция GetSystemMenu дает возможность прикладной программе обратиться к меню окна (также известному как системное меню (system menu) или меню окона (control menu)) для копирования и модификации.
Синтаксис
HMENU GetSystemMenu( HWND hWnd, BOOL bRevert ); |
Параметры
hWnd
[in] Дескриптор окна, который будет владеть копией Системного меню.bRevert
[in] Устанавливает действие, которое будет принято. Если этот параметр - ЛОЖЬ (FALSE), GetSystemMenu возвращает дескриптор копии Системного меню, которое в настоящее время используется. Копия вначале идентична Системному меню, но она может модифицироваться. Если этот параметр - ИСТИНА (TRUE), GetSystemMenu переустанавливает Системное меню обратно в заданное по умолчанию состояние. Предшествующее Системное меню, если таковое вообще имеется, разрушается.Возвращаемые значения
Если параметр bRevert - ЛОЖЬ (FALSE), возвращаемое значение - дескриптор копии Системного меню. Если параметр bRevert - ИСТИНА (TRUE), возвращаемое значение - ПУСТО (NULL).
Замечания
Любое окно, которое не использует функцию GetSystemMenu, чтобы сделать свою собственную копию Системного меню, получает стандартное Системное меню.
Системное меню вначале содержит пункты с различными значениями идентификаторов, такими как SC_CLOSE, SC_MOVE и SC_SIZE.
Пункты в Системном меню отправляют сообщения WM_SYSCOMMAND.
Все предопределенные пункты Системного меню имеют числа идентификаторов больше чем 0xF000. Если приложение добавляет команды к Системному меню, оно должно использовать числа идентификаторов меньше, чем 0xF000.
Система автоматически окрашивает в серый цвет (делает недоступными) пункты на стандартном Системном меню, в зависимости от ситуации. Приложение может выполнить свою собственную отметку типа "галочки" или установку запрета выбора, отвечая на сообщение WM_INITMENU , которое отправляется прежде, чем любое меню отобразится на экране.
Смотри также
Краткий обзор Меню, GetMenu, InsertMenuItem, SetMenuItemInfo, WM_INITMENU, WM_SYSCOMMAND|
Размещение и совместимость GetSystemMenu |
|
|
Windows. NET Server |
Да |
|
Windows XP |
Да |
|
Windows 2000 |
Да |
|
Windows NT |
Да версии 3.1 и выше |
|
Windows Me |
Да |
|
Windows 98 |
Да |
|
Windows 95 |
Да |
|
Используемая библиотека |
User32.lib |
|
Заголовочный файл |
|
|
- объявлено в |
Winuser.h |
|
- включено в |
Windows.h |
|
Unicode |
Нет |
|
Замечания по платформе |
Не имеется |