SetScrollPos

SetScrollPos функція визначає розташування бігунка (великого пальця) у вказаний прокрутки і, на прохання Перемальовує смуги прокручування для відображення нового розташування бігунка.

SetScrollPos функція призначена для зворотної сумісності. Нових програм, слід використовувати функцію SetScrollInfo.

int SetScrollPos ( HWND  hWnd, / / ручка вікна з смуги прокручуванняIntnBar, / / прапор, смуга прокручуванняIntnPos, / / нові позиції бігункаBOOLbRedraw / / перемальовування прапор);
 

Параметри

hWnd
Обробляти смуги прокрутки або вікно з стандартних прокрутки, залежно від значення параметра nBar.
nBar
Визначає встановити смугою прокрутки. Цей параметр може бути одне з таких значень:
Значення Значення
SB_CTL Визначає розташування бігунка в смуги прокрутки. HWnd параметр має бути маркер, щоб смуги прокрутки.
SB_HORZ Визначає розташування бігунка в у вікні стандартні Горизонтальна смуга прокрутки.
SB_VERT Визначає розташування бігунка в у вікні стандартні вертикальної смуги прокрутки.

nPos
Визначає нові положення бігунка. Позиція повинна бути в межах прокручування діапазону. Щоб отримати додаткові відомості про прокрутку діапазон побачити SetScrollRange функції.
bRedraw
Визначає, чи смуги прокручування є зміненні, щоб відобразити нове положення вікна прокрутки. Якщо цей параметр має значення TRUE, перемальовується смуги прокручування. Якщо він має значення FALSE, смуга прокручування не перемальовується.

Повернення значень

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

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

Зауваження

Якщо смуга прокручування перемальовується на наступні заклик до іншої функції, встановлення параметра bRedraw на ПОМИЛКОВИХ є корисним.

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

Однак, 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, SetScrollRange

Index