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