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

Извлекает дескриптор для первого элемента управления, который имеет стиль 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 , система рекурсивно выполняет поиск дочерних элементов окна.

Требования

См. также раздел

Основные понятия

Диалоговые окна

GetDlgItem

GetNextDlgGroupItem

Справочные материалы