Win32 API. Функции окна - Функция GetNextWindow

ОГЛАВЛЕНИЕ

Функция GetNextWindow

(ПолучитьСледующееОкно)

Функция GetNextWindow отыскивает данные о дескрипторе следующего или предыдущего окна в Z - последовательности. Следующее окно - ниже заданного окна; предыдущее окно выше. Если заданное окно - самое верхнее окно, функция отыскивает дескриптор следующего (или пре-дыдущего) самого верхнего окна. Если определяемое окно - окно верхнего уровня, функция отыскивает дескриптор следующего (или предыдущего) окна верхнего уровня. Если определяемое окно - дочернее окно, функция ищет дескриптор следующего (или предыдущего) дочернего окна.

Синтаксис

HWND GetNextWindow
(
HWND hWnd, // дескриптор текущего окна
UINT wCmd // флаг направления
);

Параметры

hWnd
Идентифицирует окно. Найденный дескриптор окна, который относится к этому окну, основан на значении параметра wCmd.

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

  • GW_HWNDNEXT - Возвращает дескриптор окна ниже данного окна.
  • GW_HWNDPREV - Возвращает дескриптор окна выше данного окна.

Возвращаемые значения
Если функция завершается успешно, возвращаемое значение - дескриптор следующего (или предыдущего) окна. Если нет никакого следующего (или предыдущего) окна, возвращаемое значение - ПУСТО (NULL). Чтобы получить расширенную информацию об ошибках, вызовите GetLastError.

Замечания<
Использование этой функции точно такое же, как вызов функции GetWindow с установленным флажком GW_HWNDNEXT или GW_HWNDPREV.

Смотри также
GetTopWindow

Размещение и совместимость GetNextWindow

Windows NT			Да
Win95 Да
Win32s Да
Импортируемая библиотека user32.lib
Заголовочный файл winuser.h
Unicode Нет
Замечания по платформе Не имеется