SetWindowText

La funzione SetWindowText cambia il testo della barra del titolo della finestra specificata (se ne ha uno). Se la finestra specificata di un controllo, viene modificato il testo del controllo. Tuttavia, SetWindowText non è possibile modificare il testo di un controllo in un'altra applicazione.

(BOOL SetWindowText HWND  hWnd, / / handle di finestra o di controlloLPCTSTRlpString / / indirizzo della stringa);
 

Parametri

hWnd
Gestire alla finestra o controllare il cui testo è quello di essere cambiato.
lpString
Puntatore a una stringa con terminazione null per essere utilizzato come il nuovo testo di titolo o di un controllo.

Valori restituiti

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

Se la funzione ha esito negativo, il valore restituito è zero. Per ottenere informazioni di errore estese, chiamare GetLastError.

Osservazioni

Se la finestra di destinazione è di proprietà del processo corrente, SetWindowText provoca un messaggio WM_SETTEXT essere inviati alla finestra specificata o il controllo. Se il controllo è un controllo casella di riepilogo creato con lo stile WS_CAPTION, tuttavia, SetWindowText imposta il testo per il controllo, non per le voci di elenco casella.

La funzione SetWindowText non espande i caratteri di tabulazione (codice ASCII 0x09). Caratteri di tabulazione vengono visualizzati come caratteri verticale barra (|).

Descrizione

nbsp; Windows &NT: richiede 3.1 o versione successiva.
Windows:Richiede Windows 95 o versioni successive.
Windows CE:Richiede la versione 1.0 o successiva.
Intestazione:Dichiarati in winuser.
Importare librerie:Utilizzare user32.lib.
Unicode:Implementato come versioni Unicode e ANSI su Windows NT.

Vedi anche

Panoramica di Windows, le funzioni finestra, GetWindowText, WM_SETTEXT

Rimedio: Inserire il CD-ROM CD di MSDN Library.

Index