GetDlgItemInt

La funzione GetDlgItemInt traduce il testo di un controllo specificato in una finestra di dialogo in un valore integer.

(UINT GetDlgItemInt HWND  hDlg, / / handle di finestra di dialogointnIDDlgItem, / / controllo identificatoreBOOL* lpTranslated,  / / punti alla variabile per ricevere successo/fallimento / / indicatoreBOOLbSigned / / specifica se il valore è firmato o senza firma);
 

Parametri

hDlg

Handle per la finestra di dialogo che contiene il controllo di interesse.

nIDDlgItem

Identificatore della voce di dialogo che specifica il controllo il cui testo è da tradurre.

lpTranslated

Puntatore a una variabile booleana che riceve un valore della funzione di successo/fallimento. TRUE indica il successo, FALSE indica fallimento.

Questo parametro è facoltativo: può essere NULL. In tal caso, la funzione non restituisce alcuna informazione circa il successo o il fallimento.

bSigned

Specifica se la funzione dovrebbe esaminare il testo di un segno meno all'inizio e restituire un valore integer con segno se ne trova uno. TRUE specifica che questo deve essere fatto, FALSE non dovrebbe.

Valori restituiti

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

Se la funzione ha esito negativo, la variabile indicata da lpTranslated è impostata su FALSE e il valore restituito è pari a zero. Si noti che, dal momento che zero è un possibile valore tradotto, un valore restituito di zero non di per sé indica fallimento.

Se lpTranslated è NULL, la funzione non restituisce alcuna informazione circa il successo o il fallimento.

Se il parametro bSigned è TRUE, specifica che il valore viene recuperato è un valore integer con segno, cast il valore restituito a un tipo int . Per ottenere informazioni di errore estese, chiamare GetLastError.

Osservazioni

La funzione GetDlgItemInt recupera il testo del controllo specificato mediante l'invio di un messaggio WM_GETTEXT il controllo. La funzione si traduce il testo recuperato da eventuali spazi aggiuntivi all'inizio del testo nudo e poi convertire le cifre decimali. La funzione si ferma quando raggiunge la fine del testo o incontra un carattere non numerico la traduzione.

Se il parametro bSigned è TRUE, i controlli della funzione GetDlgItemInt per un segno meno (-) all'inizio del testo e traduce il testo in un valore integer con segno. In caso contrario, la funzione crea un valore integer senza segno.

La funzione GetDlgItemInt restituisce zero se il valore tradotto è superiore a INT_MAX (per numeri firmati) o UINT_MAX (per i numeri senza segno).

Windows CE: Stringhe di testo con più di 48 caratteri non possono essere convertiti.

Descrizione

nbsp; Windows &NT: richiede 3.1 o versione successiva.
Windows:Richiede Windows 95 o versioni successive.
Windows CE:Richiede la versione 1.0 o successiva.
Intestazione:Dichiarati in winuser.
Importare librerie:Utilizzare user32.lib.

Vedi anche

Panoramica di finestre di dialogo, finestra di dialogo casella funzioni, GetDlgCtrlID, GetDlgItem, GetDlgItemText, SetDlgItemInt

Rimedio: Inserire il CD-ROM CD di MSDN Library.

Index