GetNextDlgGroupItem

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

(HWND GetNextDlgGroupItem HWND  hDlg, / / לטפל בתיבת הדו-שיחHWNDhCtl, / / לטפל של פקדBOOLקודמות / / דגל הכיוון);
 

פרמטרים

hDlg
מזהה את תיבת הדו-שיח חיפוש.
hCtl
מזהה הפקד שישמש כנקודת עבור החיפוש. אם פרמטר זה הוא NULL, פונקציה זו עושה שימוש בפקד האחרון (או הראשונה) בתיבת הדו-שיח כמו נקודת ההתחלה עבור החיפוש.
קודמות
מציין כיצד הפונקציה היא לחפש את קבוצת הפקדים בתיבת הדו-שיח. אם פרמטר זה הוא TRUE, הפונקציה מחפשת הפקד הקודם בקבוצה. אם הוא FALSE, הפונקציה מחפשת הפקד הבא בקבוצה.

להחזיר ערכים

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

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

הערות

הפונקציה GetNextDlgGroupItem חיפוש פקדי סדר (או בסדר הפוך) נוצרו בתבנית בתיבת הדו-שיח. הפקד הראשון בקבוצה חייב להיות בסגנון WS_GROUP; כל הפקדים האחרים בקבוצה חייב ברצף שנוצרו, עליך לא יש את הסגנון WS_GROUP.

בעת חיפוש עבור הפקד הקודם, הפונקציה מחזירה את הפקד הראשון שהוא מאתר שאינו גלוי ולא לא זמין. אם בקרה שניתנו על ידי hCtl היא בסגנון WS_GROUP, הפונקציה באופן זמני הופך את החיפוש כדי לאתר את הפקד הראשון בעל סגנון WS_GROUP ולאחר מכן מתחדשת החיפוש בכיוון המקורי, החזרת את הפקד הראשון שהוא מאתר כלומר גלוי, לא נכים או חוזרים hwndCtrl אם לא נמצא כזה פקד.

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

QuickInfo

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

ראה גם

סקירה כללית של תיבות הדו-שיח, פונקציות של תיבת הדו-שיח, GetNextDlgTabItem

Index