Функция GetSystemMenu

Функция 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

Нет

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

Не имеется

 

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

Hosted by uCoz