WinAPI на русском

Здравствуйте, уважаемые подписчики. Перед вами очередной выпуск рассылки "WinAPI
на 

русском".

Сайт рассылки: http://www.bcbdev.ru. Материалы по Win32 API, C++Builder.

Раздел "WinAPI": http://www.bcbdev.ru/winapi.htm
Раздел "C++Builder": http://www.bcbdev.ru/cbuilder.htm
Раздел "Примеры кода": http://www.bcbdev.ru/codesamples.htm
Раздел "MSDN по-русски": http://www.bcbdev.ru/msdn/index.php

Обновления на сайте

В раздел Примеры кода добавился пример "Получение дня недели (VCL вариант)".

Перевод

Сегодня вашему вниманию представлен перевод функции GetSystemMenu.

GetSystemMenu

Функция GetSystemMenu позволяет приложению получить доступ к оконному меню (также
известному 

как системное меню или управляющее меню) для копирования и модификации.

HMENU GetSystemMenu(
    HWND hWnd,
    BOOL bRevert
);

Параметры

hWnd – дескриптор окна, которое будет владеть копией оконного меню.
bRevert – определяет предпринимаемое действие. Если значение этого параметра
равно FALSE, 

GetSystemMenu возвращает дескриптор используемого в настоящий момент оконного
меню. 

Изначально копия идентична оконному меню, но может быть изменена. Если значение
этого 

параметра равно TRUE, GetSystemMenu возвращает оконное меню в исходное состояние.
Предыдущее 

оконное меню, если таковое есть, разрушается.

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

Если значение параметра bRevert равно FALSE, возвращаемое значение является дескриптором


копии оконного меню. Если значение параметра bRevert равно TRUE, то возвращается
NULL.

Комментарии

Любое окно, которое не использует функцию GetSystemMenu для создания своей собственной
копии 

оконного меню, получает оконное меню по умолчанию.
Оконное меню изначально содержит пункты с различными значениями идентификаторов,
такими, как 

SC_CLOSE, SC_MOVE и SC_SIZE.
Пункты меню в оконном меню отправляют сообщения WM_SYSCOMMAND.
Все предопределенные пункты оконного меню имеют значения идентификаторов большие,
чем 

0xF000. Если приложение добавляет команды в оконное меню, оно должно использовать


идентификаторы, со значением, меньшим 0xF000.
Система автоматически закрашивает серым пункты стандартного оконного меню в зависимости
от 

ситуации. Приложение может выполнить свою собственную проверку или закрашивание
серым, 

отвечая на сообщение WM_INITMENU, которое отправляется перед тем, как меню будет
изображено 

на экране.

Требования

Заголовок: объявлена в Winuser.h, подключать Windows.h.
Библиотека импорта: User32.lib.
Минимальные ОС: включена в Windows 95, Windows NT 3.1

См. также

GetMenu, InsertMenuItem, SetMenuItemInfo, WM_INITMENU, WM_SYSCOMMAND


Справочник по WinAPI: http://www.bcbdev.ru/winapi/win32api.exe
Справочник по WinAPI (zip-версия): http://www.bcbdev.ru/winapi/win32api.zip
Дружественная рассылка "Программирование на WinAPI": 

http://subscribe.ru/catalog/comp.soft.prog.russianmsdn

С уважением, 
ведущий рассылки
Тарас Сорока.
mailto:stathome@rol.ru