Funzione CreateStatusWindowA (commctrl.h)

Articolo
11/18/2024

Crea una finestra di stato, in genere utilizzata per visualizzare lo stato di un'applicazione. La finestra viene in genere visualizzata nella parte inferiore della finestra padre e contiene il testo specificato.

Nota Questa funzione è obsoleta. In alternativa, usare CreateWindow.

Sintassi

HWND CreateStatusWindowA(
  LONG   style,
  LPCSTR lpszText,
  HWND   hwndParent,
  UINT   wID
);

Parametri

style

Tipo: LONG

Stili di finestra per la finestra di stato. Questo parametro deve includere lo stile WS_CHILD e deve includere anche lo stile WS_VISIBLE.

lpszText

Tipo: LPCTSTR

Puntatore a una stringa con terminazione Null che specifica il testo di stato per la prima parte.

hwndParent

Tipo: HWND

handle nella finestra padre.

wID

Tipo: UINT

Identificatore di controllo per la finestra di stato. La procedura della finestra usa questo valore per identificare i messaggi inviati alla finestra padre.

Valore restituito

Tipo: HWND

Restituisce l'handle alla finestra di stato se ha esito positivo oppure NULL in caso contrario. Per recuperare informazioni sull'errore estese, chiamare GetLastError.

Osservazioni

La funzione CreateStatusWindow chiama la funzione CreateWindow per creare la finestra. Passa i parametri a senza modifiche e imposta i parametri posizione, larghezza e altezza su CreateWindow valori predefiniti.

Nota

L'intestazione commctrl.h definisce CreateStatusWindow 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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Vista [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	commctrl.h
libreria	Comctl32.lib
dll	Comctl32.dll

Condividi tramite