ScrollWindow

הפונקציה ScrollWindow גלילת התוכן של אזור הלקוח של החלון שצוין. הפונקציה ScrollWindow קיימת לשם תאימות לאחור. יישומים חדשים צריך להשתמש בפונקציה ScrollWindowEx.

(BOOL ScrollWindow HWND  hWnd, / / לטפל לחלון כדי לגלולintXAmount, / / כמות אופקי גלילהintYAmount, / / כמות אנכי גלילה CONST RECT* lpRect,  / / כתובת של מבנה עם גלילה מלבןCONST RECT* lpClipRect / / כתובת של מבנה עם שמלבן);
 

פרמטרים

hWnd

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

XAmount

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

YAmount

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

lpRect

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

lpClipRect

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

להחזיר ערכים

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

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

הערות

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

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

אם הפרמטר lpRect הוא NULL, המיקום של כל חלונות צאצאים בחלון היסט בכמות שצוינה על-ידי פרמטרים XAmount ו- YAmount ; לא חוקי אזורים (לא צבוע) בחלון גם היסט. ScrollWindow יהיה מהיר יותר lpRect הוא NULL.

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

QuickInfo

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

ראה גם

מבט כולל על פסי גלילה, פונקציות פס הגלילה, RECT, ScrollDC, ScrollWindowEx, UpdateWindow

Index