Condividi tramite


Funzione SetWindowTextA (winuser.h)

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

Sintassi

BOOL SetWindowTextA(
  [in]           HWND   hWnd,
  [in, optional] LPCSTR lpString
);

Parametri

[in] hWnd

Tipo: HWND

Handle per la finestra o il controllo il cui testo deve essere modificato.

[in, optional] lpString

Tipo: LPCTSTR

Nuovo titolo o testo del controllo.

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

Se la finestra di destinazione è di proprietà del processo corrente, SetWindowText causa l'invio di un messaggio di WM_SETTEXT alla finestra o al controllo specificato. Se il controllo è un controllo casella di riepilogo creato con lo stile WS_CAPTION , imposta tuttavia il testo per il controllo, non per le voci della casella di riepilogo.

Per impostare il testo di un controllo in un altro processo, inviare il messaggio di WM_SETTEXT direttamente anziché chiamare SetWindowText.

La funzione SetWindowText non espande i caratteri di tabulazione (codice ASCII 0x09). I caratteri di tabulazioni vengono visualizzati come caratteri verticali (|).

Esempio

Per un esempio, vedere Invio di un messaggio.

Nota

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

Requisiti

Requisito Valore
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
Set di API ext-ms-win-ntuser-window-l1-1-3 (introdotta in Windows 10, versione 10.0.10240)

Vedi anche

Informazioni concettuali

GetWindowText

Riferimento

WM_SETTEXT

Windows