ScrollWindowEx

הפונקציה ScrollWindowEx גולל את התוכן של אזור הלקוח של החלון שצוין.

int ScrollWindowEx ( HWND  hWnd, / / לטפל לחלון כדי לגלולint dx, / / כמות אופקי גלילהint dy, / / כמות אנכי גלילהCONST RECT* prcScroll,  / / כתובת של מבנה עם גלילה מלבןCONST RECT* prcClip,  / / כתובת של מבנה עם שמלבןHRGNhrgnUpdate, / / לטפל כדי לעדכן את האזורLPRECTprcUpdate, / / כתובת של מבנה עבור עדכון מלבןUINTדגלים / / גלילה דגלים);
 

פרמטרים

hWnd

לטפל לחלון בו היא אזור הלקוח ניתן לגלול.

dx

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

dy

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

prcScroll

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

prcClip

מצביע למבנה RECT המכיל את הקואורדינטות של מלבן החיתוך. רק התקן סיביות בתוך מלבן החיתוך מושפעות. Bits לגלול מבחוץ המלבן הפנימי צבועים; bits לגלול מהחלק הפנימי של המלבן החוצה לא צבועים.

hrgnUpdate

לטפל באזור לשנותם כדי להחזיק את האזור תוקפם על-ידי גלילה. פרמטר זה עשוי להיות NULL.

prcUpdate

מצביע למבנה RECT מקבל את הגבולות של המלבן תוקפם על-ידי גלילה. פרמטר זה עשוי להיות NULL.

דגלים

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

ערך	משמעות
SW_ERASE	מוחק את האזור שבו יפוג תוקפם לאחרונה על-ידי שליחת הודעה WM_ERASEBKGND החלון כאשר מצוין עם הדגל SW_INVALIDATE.
SW_INVALIDATE	מבטלת את תוקף את האזור המזוהה על-ידי הפרמטר hrgnUpdate לאחר גלילה.
SW_SCROLLCHILDREN	גלילת כל החלונות הילד נחתכים המלבן הצביע על-ידי הפרמטר prcScroll . חלונות צאצאים שמתחתיהן לפי מספר הפיקסלים שצוין על-ידי פרמטרים dx , dy . המערכת שולחת הודעה WM_MOVE כל החלונות הילד נחתכים מלבן prcScroll , גם אם הם אינם זזים.
SW_SMOOTHSCROLL	Windows NT 5.0 ואילך: מגילות באמצעות הגלילה החלקה. להשתמש בחלק HIWORD של פרמטר דגלים כדי לציין כמה זמן צריך לקחת פעולת גלילה חלקה.

להחזיר ערכים

אם הפונקציה מצליחה, ערך ההחזרה הוא SIMPLEREGION (אזור שבו יפוג תוקפם מלבנית), COMPLEXREGION (לא מלבנית האזור שבו יפוג תוקפם; חופפים מלבנים) או NULLREGION (אזור שבו יפוג תוקפם לא).

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

הערות

אם לא צוינו דגלים SW_INVALIDATE, SW_ERASE, ScrollWindowEx לא לבטל תוקף את האזור שנגללו אל פי. אם אחת משתי דגלים אלה מוגדר, ScrollWindowEx מבטלת את תוקף באזור זה. האזור אינו מעודכן עד שיחות יישום UpdateWindow הפונקציה, שיחות RedrawWindow לתפקד (המציין את הדגל RDW_UPDATENOW או RDW_ERASENOW), או אחזור הודעת WM_PAINT מתור היישומים.

אם החלון היא בסגנון WS_CLIPCHILDREN, אזורים שהוחזרו שצוין על-ידי hrgnUpdate ו- prcUpdate לייצג את האזור הכולל של החלון scrolled שיש לעדכן, כולל אזורים ב- windows הילד אשר זקוקים לעדכון.

אם צוין דגל SW_SCROLLCHILDREN, המערכת לא כראוי עדכון המסך אם שהחלונות חלק חלון צאצא. החלק של חלון צאצא scrolled שבו נמצא מחוץ למלבן מקור לא נמחק, לא מצויר כראוי בהיעד החדש שלה. כדי להזיז חלונות צאצאים אשר לא משקרים לחלוטין בתוך המלבן שצוין על-ידי prcScroll, השתמש בפונקציה DeferWindowPos . הסמן תמוקם מחדש אם הדגל SW_SCROLLCHILDREN מוגדר המלבן קארה מצטלב עם המלבן גלילה.

כל קלט ופלט קואורדינטות ( prcScroll, prcClip, prcUpdateאו hrgnUpdate) נקבעים כ קואורדינטות הלקוח, ללא תלות אם החלון יש את סגנון המחלקה CS_OWNDC או CS_CLASSDC. השתמש בפונקציות LPtoDP ו- DPtoLP להמרת קואורדינטות לוגי, וממנו במידת הצורך.

חלונות CE: פרמטר דגלים אינו תומך SW_SCROLLCHILDREN.

רק אחד מהפרמטרים dx , dy יכול להיות שונה מאפס.

QuickInfo

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

ראה גם

מבט כולל על פסי גלילה, פועל פס הגלילה, DeferWindowPos, DPtoLP, LPtoDP, RECT, RedrawWindow, UpdateWindow

Index