Функция GetNextDlgTabItem (winuser.h)

Статья
08/27/2023

Извлекает дескриптор для первого элемента управления, который имеет стиль WS_TABSTOP , предшествующий (или следующий) указанному элементу управления.

Синтаксис

HWND GetNextDlgTabItem(
  [in]           HWND hDlg,
  [in, optional] HWND hCtl,
  [in]           BOOL bPrevious
);

Параметры

[in] hDlg

Тип: HWND

Дескриптор диалогового окна для поиска.

[in, optional] hCtl

Тип: HWND

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

[in] bPrevious

Тип: BOOL

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

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

Тип: HWND

Если функция выполняется успешно, возвращаемое значение — это дескриптор окна предыдущего (или следующего) элемента управления, для которого задан стиль WS_TABSTOP .

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

Функция GetNextDlgTabItem ищет элементы управления в порядке (или обратном порядке), которые они были созданы в шаблоне диалогового окна. Функция возвращает первый элемент управления, который она находит, является видимым, не отключенным и имеет стиль WS_TABSTOP . Если такого элемента управления не существует, функция возвращает hCtl.

Если при поиске следующего элемента управления со стилем WS_TABSTOP встречается окно со стилем WS_EX_CONTROLPARENT , система рекурсивно выполняет поиск дочерних элементов окна.

Требования


Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	winuser.h (включая Windows.h)
Библиотека	User32.lib
DLL	User32.dll
Набор API	ext-ms-win-ntuser-dialogbox-l1-1-2 (появилась в Windows 10 версии 10.0.10240)