SetScrollRange

SetScrollRange функция устанавливает позицию минимального и максимального значения для указанного прокрутки.

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

 (BOOL SetScrollRange HWND  hWnd, / / обработать для окна с полосой прокруткиintnBar, / / полоса флаг прокруткиintnMinPos, / / минимальной прокрутки позицииintnMaxPos, / / максимальное прокрутки позицииBOOLbRedraw / / перерисовать флаг);
 

Параметры

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

nMinPos
Определяет минимум прокрутки позиция.
nMaxPos
Указывает максимальный прокрутки позиция.
bRedraw
Определяет ли полосы прокрутки должны быть перерисованы для отражения изменений. Если этот параметр имеет значение TRUE, полоса прокрутки перерисовывается. Если FALSE, полоса прокрутки не перерисовывается.

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

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

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

Примечания

Можно использовать SetScrollRange для скрыть полосу прокрутки параметра nMinPos и nMaxPos то же значение. Приложение не следует вызывать функцию SetScrollRange для скрыть полосу прокрутки при обработке сообщения панель прокрутки. Новые приложения должны использовать функцию ShowScrollBar для скрыть полосу прокрутки.

Если вызов SetScrollRange непосредственно следует вызов функции SetScrollPos , параметр bRedraw в SetScrollPos должно быть 0 для предотвращения полосу прокрутки дважды.

Диапазон по умолчанию для стандартных прокрутки — от 0 до 100. Диапазон по умолчанию на элементе управления полосы прокрутки является пустым (значения параметров nMinPos и nMaxPos равны нулю). Разница между значениями, определенных параметрами nMinPos и nMaxPos не должна быть больше, чем значение MAXLONG.

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

Однако потому что 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, SetScrollPos, ShowScrollBar

Index