CWnd::ScrollWindowEx

Int ScrollWindowEx ( int dx, int dy, LPCRECT lpRectScroll, LPCRECT lpRectClip, CRgn * prgnUpdate, LPRECT lpRectUpdate, UINT прапори );

Значення, яке повертається

Значення, що повертається, є SIMPLEREGION (прямокутні включить область), COMPLEXREGION (непрямокутних включить регіону; перекриття прямокутників) або NULLREGION (немає включить область), якщо функція успішно; в іншому випадку значення, що повертається, є помилка.

Параметри

dx

Визначає суму, пристрій одиниць, горизонтальної прокрутки. Цей параметр необхідно мати від'ємне значення для прокручування вліво.

dy

Визначає суму, пристрій одиниць, Вертикальне прокручування. Цей параметр необхідно мати від'ємне значення для прокрутки вгору.

lpRectScroll

Пункту до RECT структури, що визначає фрагмент області клієнта, щоб бути прокручуються. Якщо цей параметр має значення NULL, весь клієнтської області прокручується.

lpRectClip

Пункту до RECT структури, що визначає прямокутник обрізання прокрутки. Ця структура має пріоритет над прямокутник, вказав на lpRectScroll. Є прокручується тільки біти усередині цього прямокутника. Біти за межами цього прямокутник не змінюються, навіть якщо вони знаходяться в lpRectScroll прямокутника. Якщо цей параметр має значення NULL, не відсічного здійснюється на прямокутник прокручування.

prgnUpdate

Визначає область, які змінені провести регіону, видалені за допомогою прокрутки. Цей параметр може бути NULL.

lpRectUpdate

Пункту до RECT структури, яка буде отримувати межі прямокутник, видалені за допомогою прокрутки. Цей параметр може бути NULL.

прапори

Може мати одне з таких значень:

• SW_ERASEnbsp;  Коли вказана з SW_I&NVALIDATE, стирає регіоні нещодавно включить відправивши на WM_ERASEBKGND повідомлення до вікна.
  
  
• SW_I&NVALIDATEnbsp;  Скасовуються регіону, визначені prgnUpdate після прокручування.
  
  
• SW_SCROLLCHILDRE&Nnbsp;  Прокручується всі дочірні вікна, які перетинаються прямокутник, вказував на lpRectScroll кількість пікселів у dx і dy. Windows надсилає на WM_MOVE повідомлення на всі дочірні вікна, які перетинаються lpRectScroll, навіть якщо вони не переміщуються. На знак вставлення переміщено, коли прокручується дочірнього вікна і курсор прямокутник перетинається прокручування прямокутник.

Зауваження

Прокручується вміст у вікні клієнтської області. Ця функція схожа на ScrollWindow функцію, має деякі додаткові можливості.

If SW_INVALIDATE and SW_ERASE are not specified, the ScrollWindowEx member function does not invalidate the area that is scrolled away from. If either of these flags is set, ScrollWindowEx invalidates this area. The area is not updated until the application calls the UpdateWindow member function, calls the RedrawWindow member function (specifying RDW_UPDATENOW or RDW_ERASENOW), or retrieves the WM_PAINT message from the application queue.

Якщо вікно на WS_CLIPCHILDREN стилю, повернуті областей, вказаний на prgnUpdate і lpRectUpdate представляють Загальна площа прокручувати вікно, який необхідно оновити, включаючи будь-які райони в windows дітей, які потребують оновлення.

Якщо в SW_SCROLLCHILDREN прапор вказано, Windows не правильно оновити екрані якщо прокручується частиною дочірнього вікна. Частиною прокручується дочірнього вікна, що лежить за межами прямокутника джерело не видаляється і не буде перемальовує належним чином у свої нові призначення. Використання на DeferWindowPos Windows функції переміщення дитини Windows, які не повністю лежать у межах прямокутника, lpRectScroll . Курсор переміщено, якщо прапор SW_SCROLLCHILDREN має значення, а клавішна прямокутник перетинається прокручування прямокутник.

Всі вводу та виводу координат (для lpRectScroll, lpRectClip, lpRectUpdateі prgnUpdate), як передбачається, буде в координатах клієнт, незалежно від того, чи вікно має клас стиль CS_OWNDC або CS_CLASSDC . Використання на LPtoDP і DPtoLP Windows функції перетворення і з логічним координати, якщо це необхідно.

Огляд CWnd |nbsp; Члени класу | Ієрархічна діаграма

Дивіться такожnbsp;CWnd::RedrawWindow, CDC::ScrollDC, CWnd::ScrollWindow, CWnd::UpdateWindow, :: DeferWindowPos, :: ScrollWindowEx