(ПолучитьСистемноеМеню)
Функция GetSystemMenu позволяет прикладной программе обратиться к меню окна, (известное также как Системное меню (System menu) или Управляющее меню (Control menu)) для копирования и изменения.
Синтаксис
HMENU GetSystemMenu ( HWND hWnd, // дескриптор окна, которое владеет меню окна BOOL bRevert // флажок сброса );
Параметры
hWnd
Идентифицирует окно, которое будет владеть копией меню окна.
bRevert
Определяет действие, которое нужно предпринять. Если этот параметр - ЛОЖЬ (FALSE), GetSystemMenu возвращает дескриптор копии используемого в настоящее время меню окна. Копия вначале идентична меню окна, но она может быть изменена.
Если этот параметр - ИСТИНА (TRUE), GetSystemMenu возвращает меню окна обратно в состояние определяемое в Windows по умолчанию. Предыдущее меню окна, если оно есть, разрушается.
Возвращаемые значения
Если параметр bRevert - ЛОЖЬ (FALSE), величина возвращаемого значения - дескриптор копии меню окна. Если bRevert параметр - ИСТИНА (TRUE), величина возвращаемого значения - ПУСТО (NULL).
Замечания
Любое окно, которое не использует функцию GetSystemMenu, чтобы сделать свою собственную копию меню окна, получает стандартное меню окна.
Меню окна вначале содержит пункты с различными значениями идентификатора, такие как SC_CLOSE, SC_MOVE и SC_SIZE.
Пункты меню в меню окна посылают сообщения WM_SYSCOMMAND.
Все предопределенные пункты меню окна имеют числа идентификатора большие, чем 0xF000. Если прикладная программа добавляет команды в меню окна, она должна использовать числа идентификаторов меньшие, чем 0xF000.
Windows автоматически окрашивает в серый цвет (делает недоступными) пункты стандартного меню окна, в зависимости от ситуации. Прикладная программа может выполнить свою собственную проверку или установку запрета выбора, отвечая на сообщение WM_INITMENU, которое отправляся, до того, как покажется на экране какое-либо меню.
Смотри также
GetMenu, WM_INITMENU, WM_SYSCOMMAND
Размещение и совместимость GetSystemMenu
Windows NT Да Win95 Да Win32s Да Импортируемая библиотека user32.lib Заголовочный файл winuser.h Unicode Нет Замечания по платформе Не имеется