SetScrollPos

הפונקציה SetScrollPos מגדירה את מיקום תיבת הגלילה (אצבע) בפס הגלילה שצוין, אם המבוקש, ציור מחדש את פס הגלילה כדי לשקף את המיקום החדש של תיבת הגלילה.

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

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

פרמטרים

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

עמותות
מציין את המיקום החדש של תיבת הגלילה. המיקום חייב להיות בטווח גלילה. לקבלת מידע נוסף אודות טווח גלילה, עיין בפונקציה SetScrollRange.
bRedraw
מציין אם פס הגלילה מצויר כדי לשקף את המיקום החדש של תיבת הגלילה. אם פרמטר זה הוא TRUE, מצויר על פס הגלילה. אם הוא FALSE, פס הגלילה לא מצויר.

להחזיר ערכים

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

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

הערות

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

מכיוון הודעות המציינות את מיקום פס הגלילה, WM_HSCROLL, WM_VSCROLL, מוגבלות ל- 16 סיביות של הצב נתונים, יישומים המתבססים על הודעות אלה עבור נתוני מיקום בלבד יש ערך מרבי המעשית של 65,535 עבור הפונקציה SetScrollPos וכמבקר פרמטר.

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

QuickInfo

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

ראה גם

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

Index