GetDlgItemInt

Funcția GetDlgItemInt se traduce textul o comandă specificată din caseta de dialog într-o valoare de tip întreg.

(UINT GetDlgItemInt HWND  hDlg, / / ocupa la caseta de dialogintnIDDlgItem, / / controlul identificatorBOOL* lpTranslated,  / / punctele variabile pentru a primi succes/eroare / / indicatoareBOOLbSigned / / specifică dacă valoarea este semnate sau nesemnate);
 

Parametrii

hDlg
Mâner pentru caseta de dialog care conține controlul de interes.
nIDDlgItem
Dialog identificator de articol care specifică controlul al cărui text este de a fi tradus.
lpTranslated
Indicatorul pentru a o variabilă Boolean care primește o valoare de succes/eroare funcție. ADEVĂRAT indică succesul, FALSE indică nerespectarea.

Acest parametru este opțional: poate fi nul. În acest caz, funcția întoarce nici o informație despre succesul sau eșecul.

bSigned
Specifică dacă funcția ar trebui să examineze textul pentru un semn minus la începutul și întoarce o valoare întreg cu semn dacă constată una. ADEVĂRAT specifică că acest lucru ar trebui să fie făcut, fals că nu ar trebui.

Valorile întroarse

Dacă funcția reușește, variabila a subliniat de lpTranslated este setat la adevărat, și valoarea returnată este valoarea traduse din textul de control.

Dacă funcția nu reușește, variabila a subliniat de lpTranslated este setat la FALSE și valoarea returnată este zero. Rețineți că, deoarece zero este o posibilă valoare traduse, o valoare returnată de zero nu de sine indică nerespectarea.

În cazul în care lpTranslated este NULL, funcția întoarce nici o informație despre succesul sau eșecul.

Dacă parametrul bSigned este TRUE, specificând că valoarea care urmează să fie regăsite este o valoare de tip întreg semnat, exprimate valoarea returnată un tip int . Pentru a obține extins informa?ii eroare, apel GetLastError.

Observații

Funcția GetDlgItemInt preia textul controlului dat de control a trimite un mesaj WM_GETTEXT. Funcția traduce textul regăsite de separare spații suplimentare la începutul textului și apoi convertind cifre zecimale. Funcția se oprește traducerea atunci când acesta ajunge la sfârșitul textului sau întâlnește un caracter nenumerice.

Dacă parametrul bSigned este TRUE, funcția GetDlgItemInt controalele pentru un semn minus (-) la începutul textului și traduce textul într-o valoare întreg cu semn. Altfel, funcția creează o valoare de tip întreg nesemnate.

Funcția GetDlgItemInt returnează zero dacă valoarea traduse este mai mare decât INT_MAX (pentru numere semnat) sau UINT_MAX (pentru nesemnate numere).

Windows CE: Șiruri de text cu caractere mai mult 48 nu poate fi tradus.

QuickInfo

nbsp; Windows &NT: necesită versiunea 3.1 sau mai târziu.
Windows:Necesită Windows 95 sau o versiune ulterioară.
Windows CE:Necesită versiunea 1.0 sau mai târziu.
Antet:A declarat în winuser.h.
Import Biblioteca:Utilizarea user32.lib.

A se vedea, de asemenea

Prezentare generală a casete de dialog, funcții caseta de Dialog, GetDlgCtrlID, GetDlgItem, GetDlgItemText, SetDlgItemInt

Index