Funzione GetDlgItemInt (winuser.h)

Articolo
08/27/2023

Converte il testo di un controllo specificato in una finestra di dialogo in un valore intero.

Sintassi

UINT GetDlgItemInt(
  [in]            HWND hDlg,
  [in]            int  nIDDlgItem,
  [out, optional] BOOL *lpTranslated,
  [in]            BOOL bSigned
);

Parametri

[in] hDlg

Tipo: HWND

Handle della finestra di dialogo contenente il controllo di interesse.

[in] nIDDlgItem

Tipo: int

Identificatore del controllo il cui testo deve essere tradotto.

[out, optional] lpTranslated

Tipo: BOOL*

Indica l'esito positivo o l'errore (TRUE indica l'esito positivo, FALSE indica l'errore).

Se questo parametro è NULL, la funzione non restituisce informazioni sull'esito positivo o negativo.

[in] bSigned

Tipo: BOOL

Indica se la funzione deve esaminare il testo per un segno meno all'inizio e restituire un valore intero firmato se ne trova uno (TRUE specifica che deve essere eseguito, FALSE che non deve essere eseguito).

Valore restituito

Tipo: UINT

Se la funzione ha esito positivo, la variabile puntata da lpTranslated è impostata su TRUE e il valore restituito è il valore tradotto del testo del controllo.

Se la funzione ha esito negativo, la variabile puntata da lpTranslated è impostata su FALSE e il valore restituito è zero. Si noti che, poiché zero è un valore tradotto possibile, un valore restituito pari a zero non indica se stesso un errore.

Se lpTranslated è NULL, la funzione non restituisce informazioni sull'esito positivo o negativo.

Si noti che, se il parametro bSigned è TRUE ed è presente un segno meno (-) all'inizio del testo, GetDlgItemInt converte il testo in un valore intero firmato. In caso contrario, la funzione crea un valore intero senza segno. Per ottenere il valore appropriato in questo caso, eseguire il cast del valore restituito in un tipo int .

Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

La funzione GetDlgItemInt recupera il testo del controllo specificato inviando il controllo a un messaggio di WM_GETTEXT . La funzione converte il testo recuperato rimuovendo eventuali spazi aggiuntivi all'inizio del testo e quindi convertendo le cifre decimali. La funzione smette di tradurre quando raggiunge la fine del testo o rileva un carattere non numerico.

La funzione GetDlgItemInt restituisce zero se il valore tradotto è maggiore di INT_MAX (per i numeri firmati) o UINT_MAX (per i numeri non firmati).

Esempio

Per un esempio, vedere Creazione di una finestra di dialogo senza modalità.

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-dialogbox-l1-1-2 (introdotta in Windows 10, versione 10.0.10240)