SetScrollInfo

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

int SetScrollInfo ( HWND  hwnd, / / לטפל לחלון באמצעות פס גלילהintfnBar, / / דגל פס גלילהLPSCROLLINFOlpsi,  / / מצביע למבנה עם פרמטרים גלילהBOOLfRedraw / / לצייר מחדש של הדגל);

פרמטרים

hwnd

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

fnBar

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

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

lpsi

מצביע למבנה SCROLLINFO . לפני הקריאה SetScrollInfo, להגדיר את האיבר cbSize של המבנה כדי sizeof(SCROLLINFO), להגדיר את האיבר fMask כדי לציין פרמטרים נכנסים כדי לקבוע וכדי לציין את ערכי הפרמטר החדש אצל החברים המתאימים.

חבר fMask יכול להיות שילוב של הערכים הבאים:

ערך משמעות

SIF_DISABLENOSCROLL מבטלת את פס הגלילה במקום להסיר אותו, אם פרמטרים חדשים של פס הגלילה בפס הגלילה מיותרים.

SIF_PAGE הגדרת דף הגלילה לערך שצוין חבר nPage של מבנה SCROLLINFO הצביע על-ידי lpsi.

SIF_POS קביעת מיקום הגלילה לערך שצוין חבר וכמבקר של מבנה SCROLLINFO הצביע על-ידי lpsi.

SIF_RANGE קובעת את טווח הגלילה לערך שצוין ב- nMin ו nMax חברים של מבנה SCROLLINFO הצביע על-ידי lpsi.

fRedraw

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

ערך	משמעות
SIF_DISABLENOSCROLL	מבטלת את פס הגלילה במקום להסיר אותו, אם פרמטרים חדשים של פס הגלילה בפס הגלילה מיותרים.
SIF_PAGE	הגדרת דף הגלילה לערך שצוין חבר nPage של מבנה SCROLLINFO הצביע על-ידי lpsi.
SIF_POS	קביעת מיקום הגלילה לערך שצוין חבר וכמבקר של מבנה SCROLLINFO הצביע על-ידי lpsi.
SIF_RANGE	קובעת את טווח הגלילה לערך שצוין ב- nMin ו nMax חברים של מבנה SCROLLINFO הצביע על-ידי lpsi.

להחזיר ערכים

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

הערות

הפונקציה SetScrollInfo מבצע טווח בדיקת הערכים המוגדרים על-ידי חברי nPage , עמותות של מבנה SCROLLINFO . החבר nPage , עליך לציין ערך בין 0 ל- nMax - nMin +1. חבר וכמבקר עליך לציין ערך בין nMin ל- nMax - מקסימום(nPage -1, 0). אם ערך אחד הוא מעבר לטווח שלו, הפונקציה מגדיר אותו ערך רק בתוך הטווח.

חלונות CE: ב- Windows CE 2.0, אם אתה מעביר את מצביע ריק בפרמטר lpsi , SetScrollInfo מחזירה אפס, ולא את המיקום הנוכחי של תיבת הגלילה.

QuickInfo

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

ראה גם

מבט כולל על פסי גלילה, פונקציות פס הגלילה, GetScrollInfo, SCROLLINFO