GetDlgItem

הפונקציה GetDlgItem מאחזרת את נקודת האחיזה של הפקד בתיבת הדו-שיח שצוין.

(HWND GetDlgItem HWND  hDlg, / / לטפל בתיבת הדו-שיחintnIDDlgItem / / המזהה של הפקד);
 

פרמטרים

hDlg
מזהה את תיבת דו-שיח המכילה את פקד.
nIDDlgItem
קביעת המזהה של הפקד שיש לאחזר.

להחזיר ערכים

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

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

הערות

באפשרותך להשתמש בפונקציה GetDlgItem עם זוג חלון כלשהו של אב-צאצא, ולא רק עם תיבות דו-שיח. כל עוד הפרמטר hDlg מציין חלון אב חלון צאצא יש מזהה ייחודי (כפי שצוין על-ידי הפרמטר hMenu את הפונקציה של createwindow ליצירת או CreateWindowEx שיצר את חלון צאצא), GetDlgItem מחזירה מזהה ייחודי חוקי אל חלון צאצא.

חלונות CE: הפונקציה GetDlgItem פועלת רק עבור פקדי צאצא מיידית של תיבת דו-שיח — לא יחפש דרך תיבות דו-שיח מקוננים.

QuickInfo

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

ראה גם

סקירה כללית של תיבות הדו-שיח, פונקציות של תיבת הדו-שיח, של createwindow ליצירת, CreateWindowEx, GetDlgItemInt, GetDlgItemText

Index