getAltTabInfoA 函数 (winuser.h)

  • 项目

如果指定窗口是应用程序切换 (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 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名的使用与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。 有关详细信息，请参阅 函数原型的约定。

要求

   
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 winuser.h (包括 Windows.h)
Library User32.lib
DLL User32.dll

另请参阅

ALTTABINFO

概念性

引用

Windows