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

Статья
08/27/2023

Извлекает сведения о состоянии указанного окна, если это окно переключения приложений (ALT+TAB).

Синтаксис

BOOL GetAltTabInfoA(
  [in, optional]  HWND        hwnd,
  [in]            int         iItem,
  [in, out]       PALTTABINFO pati,
  [out, optional] LPSTR       pszItemText,
  [in]            UINT        cchItemText
);

Параметры

[in, optional] hwnd

Тип: HWND

Дескриптор окна, для которого будут получены сведения о состоянии. Это окно должно быть окном переключения приложений.

[in] iItem

Тип: int

Индекс значка в окне переключения приложения. Если параметр pszItemText не равен NULL, имя элемента копируется в строку pszItemText . Если этот параметр имеет значение –1, имя элемента не копируется.

[in, out] pati

Тип: PALTTABINFO

Указатель на структуру ALTTABINFO для получения сведений о состоянии. Обратите внимание, что перед вызовом этой функции необходимо задать для члена csSize значение sizeof(ALTTABINFO) .

[out, optional] pszItemText

Тип: LPTSTR

Имя элемента. Если этот параметр имеет значение NULL, имя элемента не копируется.

[in] cchItemText

Тип: UINT

Размер буфера pszItemText в символах.

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

Тип: BOOL

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

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

Окно переключения приложений позволяет переключиться на последнее используемое окно приложения. Чтобы отобразить окно переключения приложения, нажмите клавиши ALT+TAB. Чтобы выбрать приложение из списка, продолжайте удерживать нажатой клавишу ALT и нажимайте клавишу TAB для перемещения по списку. Добавьте SHIFT в обратное направление по списку.

Примечание

Заголовок winuser.h определяет GetAltTabInfo в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования


Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	winuser.h (включая Windows.h)
Библиотека	User32.lib
DLL	User32.dll

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

ALTTABINFO

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

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

Windows