GetDlgItemInt

הפונקציה GetDlgItemInt מתרגם הטקסט של פקד שצוין בתיבת הדו-שיח ערך של מספר שלם.

(UINT GetDlgItemInt HWND  hDlg, / / לטפל בתיבת הדו-שיחintnIDDlgItem, / / לשלוט מזההBOOL* lpTranslated,  / / מצביע למשתנה לקבל הצלחה/כשלון / / מחווןBOOLbSigned / / מציין אם ערך חתומים או לא);
 

פרמטרים

hDlg
לטפל אל תיבת הדו-שיח המכילה את פקד עניין.
nIDDlgItem
מזהה פריט של דו-שיח המציין את הפקד שאת הטקסט הוא לתרגם.
lpTranslated
המצביע משתנה בוליאני מקבלת את הערך הצלחה/כשלון הפונקציה. TRUE ציון הצלחה, FALSE מעיד על כשל.

פרמטר זה הוא אופציונלי: הוא יכול להיות NULL. במקרה זה, הפונקציה מחזירה מידע אודות הצלחה או כישלון.

bSigned
מציין אם הפונקציה אמורה לבחון את הטקסט עבור סימן חיסור בתחילת להחזיר ערך מספר שלם חתום של אם ימצא אותו. TRUE מציין כי זה אמור להיות בוצע, FALSE שהוא אמור להיות לא.

להחזיר ערכים

אם הפונקציה מצליחה, המשתנה הצביע על-ידי lpTranslated מוגדר כ- TRUE, הערך המוחזר הוא הערך מתורגם הטקסט בפקד.

אם הפעולה תיכשל, המשתנה הצביע על-ידי lpTranslated מוגדר כ- FALSE, הערך המוחזר הוא אפס. שים לב כי מאז אפס הוא ערך מתורגם אפשריים, ערך ההחזרה של אפס לא בפני עצמו להצביע כשל.

אם lpTranslated הוא NULL, הפונקציה מחזירה מידע אודות הצלחה או כישלון.

אם הפרמטר bSigned הוא TRUE, ציון הערך שיש לאחזר הוא ערך מספר שלם חתום, השליך את ערך ההחזרה מסוג int . כדי לקבל מידע שגיאות מורחב, לקרוא GetLastError.

הערות

הפונקציה GetDlgItemInt מאחזר את הטקסט של פקד נתון על-ידי שליחת הודעה WM_GETTEXT של הפקד. הפונקציה מתרגם הטקסט שאוחזרו על-ידי בנוכחות אחר רווחים מיותרים בתחילת הטקסט ולאחר מכן המרת ספרות עשרוניות. הפונקציה מפסיקה תרגום כאשר הוא מגיע לסוף הטקסט או נתקלת תווים שאינם מספריים.

אם הפרמטר bSigned הוא TRUE, הפונקציה GetDlgItemInt מחפש סימן חיסור (-) בתחילת הטקסט מתרגם הטקסט ערך מספר שלם חתום. אחרת, הפונקציה יוצרת ערך מספר שלם לא חתום.

הפונקציה GetDlgItemInt מחזירה אפס אם הערך מתורגם גדול יותר INT_MAX (עבור מספרים חתום) או UINT_MAX (עבור מספרים שאינם חתומים).

חלונות CE: לא ניתן היה לתרגם את מחרוזות טקסט עם יותר מ- 48 תווים.

QuickInfo

nbsp; Windows &NT: מחייב גירסה 3.1 או גירסה מתקדמת יותר.
Windows:נדרש Windows 95 או גירסה מתקדמת יותר.
חלונות CE:דורש גירסה 1.0 ואילך.
כותרת עליונה:להצהיר על winuser.h.
ייבוא ספריית:השתמש user32.lib.

ראה גם

סקירה כללית של תיבות הדו-שיח, פונקציות של תיבת הדו-שיח, GetDlgCtrlID, GetDlgItem, GetDlgItemText, SetDlgItemInt

Index