Funzione GetAltTabInfoA (winuser.h)

Articolo
08/27/2023

Recupera le informazioni sullo stato per la finestra specificata se si tratta della finestra di cambio dell'applicazione (ALT+TAB).

Sintassi

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

Parametri

[in, optional] hwnd

Tipo: HWND

Handle per la finestra per cui verranno recuperate le informazioni sullo stato. Questa finestra deve essere la finestra di cambio dell'applicazione.

[in] iItem

Tipo: int

Indice dell'icona nella finestra di cambio dell'applicazione. Se il parametro pszItemText non è NULL, il nome dell'elemento viene copiato nella stringa pszItemText . Se questo parametro è -1, il nome dell'elemento non viene copiato.

[in, out] pati

Tipo: PALTTABINFO

Puntatore a una struttura ALTTABINFO per ricevere le informazioni sullo stato. Si noti che è necessario impostare il membro csSize su sizeof(ALTTABINFO) prima di chiamare questa funzione.

[out, optional] pszItemText

Tipo: LPTSTR

Nome dell'elemento. Se questo parametro è NULL, il nome dell'elemento non viene copiato.

[in] cchItemText

Tipo: UINT

Dimensione, in caratteri, del buffer pszItemText .

Valore restituito

Tipo: BOOL

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

La finestra di cambio dell'applicazione consente di passare alla finestra dell'applicazione usata più di recente. Per visualizzare la finestra di commutazione dell'applicazione, premere ALT+TAB. Per selezionare un'applicazione dall'elenco, continuare a tenere premuto ALT e premere TAB per spostarsi nell'elenco. Aggiungere MAIUSC per invertire la direzione dell'elenco.

Nota

L'intestazione winuser.h definisce GetAltTabInfo come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll

Vedi anche

ALTTABINFO

Informazioni concettuali

Riferimento

Windows