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

Статья
11/20/2024

Извлекает сведения о состоянии для указанного окна, если это окно переключения приложений (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 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 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	winuser.h (включая Windows.h)
библиотеки	User32.lib
DLL	User32.dll

См. также

ALTTABINFO

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

Справочник

Windows

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