Русский справочник по Win32 API - [5]

Шрифт
Интервал


Функция AdjustWindowRectEx вычисляет необходимый размер прямоугольника окна с расширенным стилем, основываясь на желаемом размере клиентского прямоугольника. Оконный прямоугольник может быть передан в функцию CreateWindowEx для создания окна, чья клиентская область имеет желаемый размер.


BOOL AdjustWindowRectEx (


LPRECT lpRect , // указатель на структуру с координатами

// клиентской области

DWORD dwStyle , // стили окна

BOOL bMenu , // флаг наличия меню

DWORD dwExStyle // расширенный стиль

);


Параметры


lpRect - указатель на структуру типа RECT , которая содержит координаты верхнего левого и нижнего правого углов клиентской области. После выполнения функции эта структура содержит координаты верхнего левого и нижнего правого углов окна, имеющего клиентскую область желаемого размера.

dwStyle - определяет стили окна, размер которого вычисляется.

bMenu - определяет наличие меню у окна.

dwExStyle - определяет расширенный стиль окна, размер которого вычисляется.


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


В случае успеха возвращается ненулевое значение.

В случае неудачи возвращается нуль. Для получения дополнительной информации об ошибке вызовите функцию GetLastError .


Комментарии


Клиентский прямоугольник - это наименьший прямоугольник, который полностью содержит в себе клиентскую область окна. Оконный прямоугольник - это наименьший прямоугольник, который полностью содержит в себе само окно.

Функция AdjustWindowRectEx не добавляет дополнительного пространства, когда строка меню сворачивается в два или более рядов.


См . также


AdjustWindowRect, CreateWindowEx, RECT .



ArrangeIconicWindows


Функция ArrangeIconicWindows упорядочивает все минимизированные (в виде иконок) окна указанного родительского окна.


UINT ArrangeIconicWindows (


HWND hWnd // дескриптор родительского окна

);


Параметры


hWnd - идентифицирует родительское окно.


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


В случае успеха возвращается высота одного ряда иконок.

В случае неудачи возвращается нуль. Для получения дополнительной информации об ошибке вызовите функцию GetLastError .


Комментарии


Приложение, которое работает со своими минимизированными дочерними окнами, может использовать функцию ArrangeIconicWindows для упорядочивания иконок окон в родительском окне. Функция также может упорядочивать иконки окон на рабочем столе. Для получения дескриптора рабочего стола используйте функцию GetDesktopWindow .

Приложение отправляет сообщение WM _ MDIICONARRANGE MDI -окну для упорядочивания его минимизированных дочерних MDI -окон.


См. также


CloseWindow, GetDesktopWindow .


BeginDeferWindowPos


Функция BeginDeferWindowPos выделяет память для структуры, содержащей информацию о размере и положении для одного или более окон, и возвращает дескриптор этой структуры.


HDWP BeginDeferWindowPos (


int nNumWindows // количество окон

);


Параметры


nNumWindows - определяет начальное количество окон, для которых необходимо хранить информацию об их положении. Функция DeferWindowPos при необходимости увеличивает размер данной структуры.


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


В случае успеха возвращается идентификатор структуры.

В случае нехватки доступных ресурсов системы для структуры возвращается NULL .


Комментарии


Структура, содержащая информацию о размере и положении для одного или более окон, является внутренней структурой Windows . Приложение не может иметь к ней прямой доступ.

Функция DeferWindowPos заполняет структуру информацией об одном или нескольких окнах, подлежащих перемещению. Функция EndDeferWindowPos принимает дескриптор структуры и репозиционирует окна в соответствии с информацией из данной структуры.

Если одно из окон, описанных в структуре, имеет установленный флаг SWP _ HIDEWINDOW или SWP _ SHOWWINDOW, то не репозиционируется ни одно из окон.

Если Windows должна увеличить размер структуры по сравнению с начальным размером, задающимся значением параметра nNumWindows , но не может выделить достаточно памяти, то вся последовательность перемещений окон ( BeginDeferWindowPos, DeferWindowPos и EndDeferWindowPos ) заканчивается неудачей. Указанием максимально необходимого размера структуры приложение может выявить и обработать сбой в самом начале всего процесса.


См. также


DeferWindowPos, EndDeferWindowPos, SetWindowPos .


BringWindowToTop


Функция BringWindowToTop помещает указанное окно в вершину Z -последовательности. Если окно является окном верхнего уровня - оно активизируется. Если окно представляет собой дочернее окно - активизируется родительское окно верхнего уровня.


BOOL BringWindowToTop (


HWND hWnd // дескриптор окна

);


Параметры


hWnd - идентифицирует окно, помещаемое в вершину Z -последовательности.


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


В случае успеха возвращается ненулевое значение.

В случае неудачи возвращается нуль. Для получения дополнительной информации вызовите функцию GetLastError .


Комментарии


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

Результат вызова этой функции похож на результат вызова SetWindowPos для изменения позиции окна в Z -последовательности, но вызов


Рекомендуем почитать
Создание Православной Церкви Украины как новый раскол и феномен протестантизма восточного обряда

В книге описывается как хронология, так и «анатомия» создания новой конфессии, находящейся, несмотря на претенциозное название, за границами Единой Святой Соборной и Апостольской Церкви. Подробно объясняется, почему с православной догматической и канонической точки зрения ПЦУ не является Церковью, а также причины и обстоятельства вероучительного падения Константинопольского Патриархата. Анализируется контекст этого падения и появления «конфессии Думенко» – феномен самого проекта «Украины как антиРоссии», являющийся даже не национализмом, а «политическим униатством», «негативной идентичностью» (автор термина А.


Таинство Исповеди. Как научиться каяться и перестать прятаться от Бога

В книге известного православного писателя и публициста игумена Нектария (Морозова) говорится о сути таинства Покаяния, его истории, подготовке к нему и об основных ошибках, которые люди, сознательно или неосознанно, допускают на исповеди.Книга поможет более честно взглянуть на себя. Почему мое сердце холодно и не радуется молитве? Почему я так мало похож на Христа: не имею ни любви, ни терпения, ни кротости? Как получается, что, раз за разом исповедуясь и причащаясь, я остаюсь прежним?


Мивары: 25 лет создания искусственного интеллекта

В монографии профессора МФТИ, МАДИ, д.т.н. Варламова О.О. и д.т.н. Санду Р.А. предложен оригинальный подход в области искусственного интеллекта по созданию миварных глобальных обучаемых активных логически рассуждающих эволюционных автоматических информационных систем. Это стало возможным благодаря реализации на практике двух инновационных российских фундаментальных технологий: 1) эволюционного накопления данных – миварное информационное пространство, и 2) активной логико-вычислительной обработки информации – миварные сети.


Все о грибах. Рецепты. Виды. Советы

Грибы – удивительное создание природы. Они вызывают восторг, когда их находишь в лесу, например, желтых лисичек во мху после теплого дождика, или красную шляпку подосиновика в траве на лужайке. Но какие же грибы вкусные в супчике или в жаркое! Эта книга сообщит полезную информацию о том, какие бывают грибы, о их свойствах и особой обработке. А также добавит в вашу коллекцию много новых блюд и заготовок, которые без сомнения нужно приготовить.


Винный гид покупателя

Эта книга не просто энциклопедический перечень виноделов и виноградарей, но одновременно и учебник, и покупательский гид. Ее цель — превратить вас в более знающего и уверенного покупателя, достаточно осведомленного о «закулисных» деталях, чтобы при покупке вина вы могли сделать самый разумный выбор.


Секреты безопасной покупки подержанного автомобиля

Выбор и покупка подержанного автомобиля в России до недавнего времени были лотереей. Проигрыш в этой лотерее означал сотни тысяч рублей, выпущенных на ветер. Однако эта книга, представляющая собой краткое руководство по приобретению б/у машины, а также услуги нашего сервиса «АвтоКод» помогут свести риск нарваться на мошенников к нулю!