GetScrollPos

הפונקציה GetScrollPos מאחזר את המיקום הנוכחי של תיבת הגלילה (אצבע) בפס הגלילה שצוין. המיקום הנוכחי הוא ערך יחסי תלויה בטווח הגלילה הנוכחי. לדוגמה, אם הטווח גלילה הוא 0 עד 100 הוא תיבת הגלילה באמצע הסרגל, המיקום הנוכחי הוא 50.

הפונקציה GetScrollPos מסופק לצורך תאימות לאחור. יישומים חדשים צריך להשתמש בפונקציה GetScrollInfo.

int GetScrollPos ( HWND  hWnd, / / לטפל לחלון באמצעות פס גלילהintnBar / / דגלים פס גלילה);
 

פרמטרים

hWnd

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

nBar

מציין את פס הגלילה כדי להיבדק. פרמטר זה יכול להיות אחד מהבאים:

ערך	משמעות
SB_CTL	מאחזר את מיקום תיבת הגלילה בפקד סרגל הגלילה. הפרמטר hWnd חייב להיות נקודת האחיזה כדי פקד פס גלילה.
SB_HORZ	מאחזר את מיקום תיבת הגלילה בפס הגלילה האופקי הרגיל של חלון.
SB_VERT	מאחזר את מיקום תיבת הגלילה בפס הגלילה האנכי הרגיל של חלון.

להחזיר ערכים

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

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

הערות

הפונקציה GetScrollPos מאפשר ליישומים להשתמש במיקומים הגלילה של 32 סיביות. למרות למקם הודעות המציינות את פס הגלילה, WM_HSCROLL, WM_VSCROLL, מוגבלות ל- 16 סיביות של מיקום נתונים, פונקציות SetScrollPos, SetScrollRange, GetScrollPosו- GetScrollRange תמיכה נתונים מיקום פס הגלילה של 32 סיביות. לכן, יישום ניתן להתקשר GetScrollPos בעת עיבוד הודעות או WM_HSCROLL או WM_VSCROLL כדי לקבל נתונים מיקום פס הגלילה של 32 סיביות.

כדי לקבל את מיקום 32 סיביות של תיבת הגלילה (אצבע) במהלך הודעה SB_THUMBTRACK הודעה WM_HSCROLL או WM_VSCROLL, השתמש בפונקציה GetScrollInfo.

QuickInfo

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

ראה גם

מבט כולל על פסי גלילה, פונקציות פס הגלילה, GetScrollInfo, GetScrollRange, SetScrollInfo, SetScrollPos, SetScrollRange, WM_HSCROLL, WM_VSCROLL

Index