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 , содержащий координаты прямоугольника отсечения. Затрагивает только устройство бит в прямоугольник отсечения. Биты, скроллировать с внешней стороны прямоугольника на внутренней краска; биты, прокрутку внутри прямоугольника для внешнего мира не окрашенные.
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 часть параметра flags указать, сколько времени прокрутки гладкая операция должна занять.

Возвращаемые значения

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

Если вызов функции был неуспешен, возвращается ошибка. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError.

Примечания

Если не заданы флаги SW_INVALIDATE и SW_ERASE, ScrollWindowEx не делает недействительными область, которая прокручивает от. Если любой из этих флагов, ScrollWindowEx делает недействительным этой области. Области не обновляется до приложение вызывает UpdateWindow функция, звонки RedrawWindow функционировать (с указанием флага RDW_UPDATENOW или RDW_ERASENOW), или получает сообщение WM_PAINT из очереди приложений.

Если окно имеет стиль WS_CLIPCHILDREN, возвращенный области, указанного в hrgnUpdate и prcUpdate представляют собой общая площадь прокрученного окна, которое необходимо обновить, включая любые области, в дочерних окон, которые нуждаются в обновлении.

Если задан флаг SW_SCROLLCHILDREN, система не обновляются должным образом экрана прокрутке части дочернего окна. Часть, расположенную за пределами исходного прямоугольника прокручиваемого дочернего окна не стирается и не перерисовывается должным образом в новое место назначения. Чтобы переместить дочерних окон, которые не полностью внутри прямоугольника, определяемого prcScroll, используйте функцию DeferWindowPos . Курсор месте если установлен флаг SW_SCROLLCHILDREN, и курсор прямоугольник пересекается прокрутки прямоугольник.

Все входные и выходные координаты ( prcScroll, prcClip, prcUpdateи hrgnUpdate) определяются как координаты клиента, вне зависимости от того, имеет ли окно стилем класса CS_OWNDC или CS_CLASSDC. При необходимости использовать функции LPtoDP и DPtoLP для преобразования и логические координаты.

Windows CE: Параметр flags не поддерживает SW_SCROLLCHILDREN.

Только один из параметров dx и dy может быть ненулевой.

QuickInfo

nbsp; Windows &NT: требует версии 3.1 или более поздней версии.
Windows:Требует Windows 95 или более поздней версии.
Windows CE:Требует версии 1.0 или более поздней версии.
Заголовок:Объявленные в winuser.h.
Импорта библиотеки:Использование user32.lib.

Родственные слова

Прокрутка полосы обзор, функции, полоса прокрутки, DeferWindowPos, DPtoLP LPtoDP RECT, RedrawWindow UpdateWindow

Index