Funzione SetDlgItemTextA (winuser.h)

Articolo
11/20/2024

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 ottenere informazioni estese sull'errore, chiamare GetLastError.

Osservazioni

La funzione SetDlgItemText invia un messaggio di WM_SETTEXT al controllo specificato.

Esempi

Per un esempio, vedere Uso di 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 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 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
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)