Макрос GetNextWindow (winuser.h)

Статья
11/20/2024

Извлекает дескриптор к следующему или предыдущему окну в Z-Order. Следующее окно находится под указанным окном; Предыдущее окно выше.

Если указанное окно является самым верхним окном, функция выполняет поиск самого верхнего окна. Если указанное окно является окном верхнего уровня, функция ищет окно верхнего уровня. Если указанное окно является дочерним окном, функция выполняет поиск дочернего окна.

Синтаксис

void GetNextWindow(
  [in]  hWnd,
  [in]  wCmd
);

Параметры

[in] hWnd

Тип: HWND

Дескриптор окна. Полученный дескриптор окна относится к этому окну на основе значения параметра wCmd.

[in] wCmd

Тип: UINT

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

Ценность	Значение
GW_HWNDNEXT 2	Возвращает дескриптор в окно под заданным окном.
GW_HWNDPREV 3	Возвращает дескриптор в окно над заданным окном.

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

Тип: HWND

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

Замечания

Эта функция реализуется как вызов функции GetWindow.

#define GetNextWindow(hWnd, wCmd) GetWindow(hWnd, wCmd)

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	winuser.h (включая Windows.h)

См. также

концептуальные

GetTopWindow

GetWindow

Справочник

Windows

Поделиться через