SetScrollRange

הפונקציה SetScrollRange מגדיר את ערכי המינימום והמקסימום מיקום פס הגלילה שצוין.

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

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

פרמטרים

hWnd

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

nBar

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

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

nMinPos

ציון המינימום גלילה מיקום.

nMaxPos

ציון מרבי גלילה מיקום.

bRedraw

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

להחזיר ערכים

אם הפונקציה מצליחה, הערך המוחזר אינו אפס.

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

הערות

באפשרותך להשתמש SetScrollRange כדי להסתיר את סרגל הגלילה על-ידי הגדרת nMinPos nMaxPos ערך זהה. יישום צריך לא לפונקציה SetScrollRange כדי להסתיר את סרגל גלילה בעת עיבוד הודעה פס הגלילה. יישומים חדשים צריך להשתמש בפונקציה ShowScrollBar כדי להסתיר את סרגל הגלילה.

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

הטווח המוגדר כברירת מחדל עבור פס גלילה סטנדרטי הוא 0 עד 100. טווח ברירת המחדל עבור פקד פס גלילה ריקה (ערכי פרמטר גם nMinPos וגם nMaxPos הם אפס). ההפרש בין הערכים שצוינו על-ידי פרמטרים nMinPos ו- nMaxPos אינו יכול להיות גדול יותר מהערך של MAXLONG.

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

עם זאת, מאחר 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, SetScrollPos, ShowScrollBar

Index