Funzione SetDlgItemTextA (winuser.h)

Articolo
08/28/2023

Imposta il titolo o il testo di un controllo in una finestra di dialogo.

Sintassi

BOOL SetDlgItemTextA(
  [in] HWND   hDlg,
  [in] int    nIDDlgItem,
  [in] LPCSTR lpString
);

Parametri

[in] hDlg

Tipo: HWND

Handle per la finestra di dialogo che contiene il controllo .

[in] nIDDlgItem

Tipo: int

Controllo con titolo o testo da impostare.

[in] lpString

Tipo: LPCTSTR

Testo da copiare nel 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

La funzione SetDlgItemText invia un messaggio WM_SETTEXT al controllo specificato.

Esempio

Per un esempio, vedere Uso delle caselle di riepilogo.

Nota

L'intestazione winuser.h definisce SetDlgItemText 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
Set di API	ext-ms-win-ntuser-dialogbox-l1-1-0 (introdotto in Windows 8)