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 , SetScrollPos , параметр bRedraw повинні бути нуль, щоб запобігти розробляється двічі смуги прокручування.

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

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

Однак, SetScrollInfo, SetScrollPos, SetScrollRange, GetScrollInfo, GetScrollPosта GetScrollRange функцій підтримує 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