Funzione GetDlgItemTextA (winuser.h)

Articolo
11/20/2024

Recupera il titolo o il testo associato a un controllo in una finestra di dialogo.

Sintassi

UINT GetDlgItemTextA(
  [in]  HWND  hDlg,
  [in]  int   nIDDlgItem,
  [out] LPSTR lpString,
  [in]  int   cchMax
);

Parametri

[in] hDlg

Tipo: HWND

Handle per la finestra di dialogo che contiene il controllo .

[in] nIDDlgItem

Tipo: int

Identificatore del controllo il cui titolo o testo deve essere recuperato.

[out] lpString

Tipo: LPTSTR

Buffer per ricevere il titolo o il testo.

[in] cchMax

Tipo: int

Lunghezza massima, in caratteri, della stringa da copiare nel buffer a cui punta lpString. Se la lunghezza della stringa, incluso il carattere Null, supera il limite, la stringa viene troncata.

Valore restituito

Tipo: UINT

Se la funzione ha esito positivo, il valore restituito specifica il numero di caratteri copiati nel buffer, senza includere il carattere null di terminazione.

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

Osservazioni

Se la stringa è lunga o più lunga del buffer, il buffer conterrà la stringa troncata con un carattere Null di terminazione.

La funzione GetDlgItemText invia un messaggio di WM_GETTEXT al controllo.

Esempi

Per un esempio, vedere Creazione di una finestra di dialogo modale.

Nota

L'intestazione winuser.h definisce GetDlgItemText 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)