GetScrollInfo

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

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

פרמטרים

hwnd

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

fnBar

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

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

lpsi

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

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

ערך משמעות

SIF_PAGE עותקים בעמוד גלילה אל חבר nPage של מבנה SCROLLINFO הצביע על-ידי lpsi.

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

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

SIF_TRACKPOS עותקים תיבת הגלילה הנוכחי מעקב מיקום אל חבר nTrackPos של מבנה SCROLLINFO הצביע על-ידי lpsi.

ערך	משמעות
SIF_PAGE	עותקים בעמוד גלילה אל חבר nPage של מבנה SCROLLINFO הצביע על-ידי lpsi.
SIF_POS	עותקים מיקום הגלילה אל חבר וכמבקר של מבנה SCROLLINFO הצביע על-ידי lpsi.
SIF_RANGE	מעתיק את הטווח הגלילה כדי nMin ו nMax חברים של מבנה SCROLLINFO הצביע על-ידי lpsi.
SIF_TRACKPOS	עותקים תיבת הגלילה הנוכחי מעקב מיקום אל חבר nTrackPos של מבנה SCROLLINFO הצביע על-ידי lpsi.

להחזיר ערכים

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

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

הערות

הפונקציה GetScrollInfo מאפשר ליישומים להשתמש במיקומים הגלילה של 32 סיביות. למרות הודעות המציינות את מיקום פס הגלילה, WM_HSCROLL , WM_VSCROLL, לספק רק 16 סיביות של מיקום נתונים, פונקציות SetScrollInfo GetScrollInfo מספקים 32 סיביות של נתוני מיקום פס הגלילה. לכן, יישום ניתן להתקשר GetScrollInfo בעת עיבוד הודעות WM_HSCROLL או WM_VSCROLL כדי לקבל נתוני מיקום פס הגלילה של 32 סיביות.

כדי לקבל את מיקום 32 סיביות של תיבת הגלילה (אצבע) במהלך הודעה SB_THUMBTRACK הודעה WM_HSCROLL או WM_VSCROLL, התקשרו GetScrollInfo בעלי ערך SIF_TRACKPOS חבר fMask של מבנה SCROLLINFO . הפונקציה מחזירה את מיקום תיבת הגלילה מעקב חבר nTrackPos של מבנה SCROLLINFO . פעולה זו מאפשרת לך לקבל את מיקום תיבת הגלילה כשהמשתמש עובר אותו. הקוד לדוגמה שלהלן מדגים את הטכניקה.

סי SCROLLINFO;
במקרה WM_HSCROLL:
    switch(LOWORD(wparam)) {
        במקרה SB_THUMBTRACK:
          / / לאתחל מבנה SCROLLINFO
 
            ZeroMemory (כח; סי, sizeof(SCROLLINFO));
            si.cbSize = sizeof(SCROLLINFO);
            si.fMask = SIF_TRACKPOS;
 
          / / שיחה GetScrollInfo כדי לקבל הנוכחי מעקב / / תפקיד ב- si.nTrackPos
 
            אם (!.GetScrollInfo(hwnd, SB_HORZ, &si))
                להחזיר 1; / / GetScrollInfo נכשל
            מעבר;
        .
        .
        .
    }

QuickInfo

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

ראה גם

מבט כולל על פסי גלילה, פועל פס הגלילה, SCROLLINFO, SetScrollInfo, WM_HSCROLL, WM_VSCROLL

Index