SetScrollPos

SetScrollPos функция устанавливает позицию (бегунком) полосы прокрутки в указанном прокрутки и, при наличии просьбы, перерисовывает отразить новое положение ползунка полосы прокрутки.

Функция SetScrollPos предназначена для обеспечения обратной совместимости. Новые приложения должны использовать функцию SetScrollInfo.

int () SetScrollPos HWND  hWnd, / / обработать для окна с полосой прокруткиintnBar, / / полоса флаг прокруткиintНСС, / / новая позиция бегункаBOOLbRedraw / / перерисовать флаг);
 

Параметры

hWnd
Дескриптор управления полосы прокрутки или окно со стандартным прокрутки, в зависимости от значения параметра nBar.
nBar
Указывает полосу прокрутки, чтобы установить. Этот параметр может принимать одно из следующих значений:
Значение Значение
SB_CTL Устанавливает положение указателя полосы прокрутки в элементе управления полосы прокрутки. HWnd параметр должен быть дескриптор управления полосы прокрутки.
SB_HORZ Устанавливает положение ползунка в стандартной горизонтальной прокрутки окна.
SB_VERT Устанавливает положение ползунка в окна стандартных вертикальной полосы прокрутки.

нСС
Определяет новое положение ползунка. Позиция должна быть в пределах диапазона прокрутки. Для получения дополнительных сведений о прокрутки диапазон см SetScrollRange функции.
bRedraw
Определяет ли полоса прокрутки перерисовывается, чтобы отразить новую позицию прокрутки окна. Если этот параметр имеет значение TRUE, полоса прокрутки перерисовывается. Если FALSE, полоса прокрутки не перерисовывается.

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

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

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

Примечания

Если полоса прокрутки перерисовывается при следующем вызове другой функции, установка для параметра bRedraw значение FALSE является полезным.

Так как сообщения, указывающие положение, WM_HSCROLL и WM_VSCROLL, ограничены до 16 бит данных, приложения, которые полагаются исключительно на эти сообщения для позиции данных имеют практический максимальное значение 65535 для параметра SetScrollPos функции НСС.

Однако потому что SetScrollInfo, SetScrollPos, SetScrollRange, GetScrollInfo, GetScrollPosи GetScrollRange функции поддерживают 32-разрядных прокрутки бар позиции данных, есть способ обойти 32-16-разрядные барьер WM_HSCROLL и WM_VSCROLL сообщений. Смотрите описание техники GetScrollInfo.

QuickInfo

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

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

Обзор полосы прокрутки, полоса прокрутки функций, GetScrollInfo, GetScrollPos, GetScrollRange, SetScrollInfo, SetScrollRange

Index