Skip to content

Latest commit

 

History

History
122 lines (80 loc) · 4.07 KB

nf-winuser-getalttabinfow.md

File metadata and controls

122 lines (80 loc) · 4.07 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:winuser.GetAltTabInfoW
GetAltTabInfoW function (winuser.h)
Retrieves status information for the specified window if it is the application-switching (ALT+TAB) window. (Unicode)
GetAltTabInfo
GetAltTabInfo function [Windows and Messages]
GetAltTabInfoW
_win32_GetAltTabInfo
_win32_getalttabinfo_cpp
winmsg.getalttabinfo
winui._win32_getalttabinfo
winuser/GetAltTabInfo
winuser/GetAltTabInfoW
winmsg\getalttabinfo.htm
winmsg
VS|winui|~\winui\windowsuserinterface\windowing\windows\windowreference\windowfunctions\getalttabinfo.htm
12/05/2018
GetAltTabInfo, GetAltTabInfo function [Windows and Messages], GetAltTabInfoA, GetAltTabInfoW, _win32_GetAltTabInfo, _win32_getalttabinfo_cpp, winmsg.getalttabinfo, winui._win32_getalttabinfo, winuser/GetAltTabInfo, winuser/GetAltTabInfoA, winuser/GetAltTabInfoW
winuser.h
Windows.h
Windows
Windows 2000 Professional [desktop apps only]
Windows 2000 Server [desktop apps only]
GetAltTabInfoW (Unicode) and GetAltTabInfoA (ANSI)
User32.lib
User32.dll
Windows
19H1
GetAltTabInfoW
winuser/GetAltTabInfoW
c++
APIRef
kbSyntax
DllExport
User32.dll
GetAltTabInfo
GetAltTabInfoA
GetAltTabInfoW

GetAltTabInfoW function

-description

Retrieves status information for the specified window if it is the application-switching (ALT+TAB) window.

-parameters

-param hwnd [in, optional]

Type: HWND

A handle to the window for which status information will be retrieved. This window must be the application-switching window.

-param iItem [in]

Type: int

The index of the icon in the application-switching window. If the pszItemText parameter is not NULL, the name of the item is copied to the pszItemText string. If this parameter is –1, the name of the item is not copied.

-param pati [in, out]

Type: PALTTABINFO

A pointer to an ALTTABINFO structure to receive the status information. Note that you must set the csSize member to sizeof(ALTTABINFO) before calling this function.

-param pszItemText [out, optional]

Type: LPTSTR

The name of the item. If this parameter is NULL, the name of the item is not copied.

-param cchItemText [in]

Type: UINT

The size, in characters, of the pszItemText buffer.

-returns

Type: BOOL

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero. To get extended error information, call GetLastError.

-remarks

The application-switching window enables you to switch to the most recently used application window. To display the application-switching window, press ALT+TAB. To select an application from the list, continue to hold ALT down and press TAB to move through the list. Add SHIFT to reverse direction through the list.

Note

The winuser.h header defines GetAltTabInfo as an alias which automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.

-see-also

ALTTABINFO

Conceptual

Reference

Windows