הפונקציה GetDlgItemInt מתרגם הטקסט של פקד שצוין בתיבת הדו-שיח ערך של מספר שלם.
(UINT GetDlgItemInt HWND hDlg, / / לטפל בתיבת הדו-שיחintnIDDlgItem, / / לשלוט מזההBOOL* lpTranslated, / / מצביע למשתנה לקבל הצלחה/כשלון / / מחווןBOOLbSigned / / מציין אם ערך חתומים או לא);
פרמטר זה הוא אופציונלי: הוא יכול להיות NULL. במקרה זה, הפונקציה מחזירה מידע אודות הצלחה או כישלון.
אם הפונקציה מצליחה, המשתנה הצביע על-ידי lpTranslated מוגדר כ- TRUE, הערך המוחזר הוא הערך מתורגם הטקסט בפקד.
אם הפעולה תיכשל, המשתנה הצביע על-ידי lpTranslated מוגדר כ- FALSE, הערך המוחזר הוא אפס. שים לב כי מאז אפס הוא ערך מתורגם אפשריים, ערך ההחזרה של אפס לא בפני עצמו להצביע כשל.
אם lpTranslated הוא NULL, הפונקציה מחזירה מידע אודות הצלחה או כישלון.
אם הפרמטר bSigned הוא TRUE, ציון הערך שיש לאחזר הוא ערך מספר שלם חתום, השליך את ערך ההחזרה מסוג int . כדי לקבל מידע שגיאות מורחב, לקרוא GetLastError.
הפונקציה GetDlgItemInt מאחזר את הטקסט של פקד נתון על-ידי שליחת הודעה WM_GETTEXT של הפקד. הפונקציה מתרגם הטקסט שאוחזרו על-ידי בנוכחות אחר רווחים מיותרים בתחילת הטקסט ולאחר מכן המרת ספרות עשרוניות. הפונקציה מפסיקה תרגום כאשר הוא מגיע לסוף הטקסט או נתקלת תווים שאינם מספריים.
אם הפרמטר bSigned הוא TRUE, הפונקציה GetDlgItemInt מחפש סימן חיסור (-) בתחילת הטקסט מתרגם הטקסט ערך מספר שלם חתום. אחרת, הפונקציה יוצרת ערך מספר שלם לא חתום.
הפונקציה GetDlgItemInt מחזירה אפס אם הערך מתורגם גדול יותר INT_MAX (עבור מספרים חתום) או UINT_MAX (עבור מספרים שאינם חתומים).
חלונות CE: לא ניתן היה לתרגם את מחרוזות טקסט עם יותר מ- 48 תווים.
nbsp; Windows &NT: מחייב גירסה 3.1 או גירסה מתקדמת יותר.
Windows:נדרש Windows 95 או גירסה מתקדמת יותר.
חלונות CE:דורש גירסה 1.0 ואילך.
כותרת עליונה:להצהיר על winuser.h.
ייבוא ספריית:השתמש user32.lib.
סקירה כללית של תיבות הדו-שיח, פונקציות של תיבת הדו-שיח, GetDlgCtrlID, GetDlgItem, GetDlgItemText, SetDlgItemInt