GetScrollInfo

Функція GetScrollInfo повертає параметри прокручування Бар, включаючи мінімум і максимум прокручування позиції, розмір сторінки та розташування бігунка (великого пальця).

(BOOL GetScrollInfo HWND  hwnd, / / ручка вікна з смуги прокручуванняIntfnBar, / / прапор, смуга прокручуванняLPSCROLLINFOlpsi / / вказівник на структуру для прокручування параметрів);
 

Параметри

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

lpsi
Вказівник на структуру SCROLLINFO . Перед викликом GetScrollInfo, встановити структури, член cbSize на sizeof(SCROLLINFO) і встановити, щоб визначити параметри прокручування бар для отримання, член fMask . Для повернення, функція копіювання Указані параметри членам відповідні структури.

Член fMask може бути поєднання таких значень:
Значення Значення
SIF_PAGE Копії прокручування сторінки на SCROLLINFO структури, член nPage вказав на lpsi.
SIF_POS Копії прокручування позиції на SCROLLINFO структури, член nPos вказав на lpsi.
SIF_RANGE Копіювання діапазону прокручування до nMin і nMax члени структури SCROLLINFO вказав на lpsi.
SIF_TRACKPOS Копії поточного бігунка відстеження позицій на SCROLLINFO структури, член nTrackPos вказав на lpsi.

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

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

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

Зауваження

Функція GetScrollInfo дозволяє застосункам використовувати 32-розрядну прокручування позиції. Хоча повідомлення, які вказують на позицію смуги прокрутки, WM_HSCROLL і WM_VSCROLL, надають тільки 16 бітів даних позиції, функції SetScrollInfo і GetScrollInfo забезпечити 32 біти даних позиції смуги прокручування. Таким чином, застосування можна назвати GetScrollInfo під час обробки повідомлення WM_HSCROLL або WM_VSCROLL для отримання 32-розрядних смуги прокручування розташування даних.

Для отримання 32-розрядних позиції бігунка (великого пальця) під час SB_THUMBTRACK повідомлення в WM_HSCROLL або WM_VSCROLL повідомлення, зателефонуйте GetScrollInfo структури, SCROLLINFO , член fMask , вартість SIF_TRACKPOS. Функція повертає відстеження бігунка в SCROLLINFO структурі, член nTrackPos . Це дає змогу отримати позиції бігунка, як користувач переміщує його. Наведений нижче зразок код ілюструє техніка.

SCROLLINFO с. і.;
справа WM_HSCROLL:
    Switch(LOWORD(wparam)) {
        справа SB_THUMBTRACK:
          / / Ініціалізація SCROLLINFO структури
 
            ZeroMemory (amp; с. і., sizeof(SCROLLINFO));
            Si.cbSize = sizeof(SCROLLINFO);
            Si.fMask = SIF_TRACKPOS;
 
          / / Відстеження виклику GetScrollInfo, щоб отримати поточні / / позиції в si.nTrackPos
 
            Якщо (!.GetScrollInfo(hwnd, SB_HORZ, &si))
                повернення 1; / / GetScrollInfo не вдалося
            перерви;
        .
        .
        .
    } 

QuickInfo

nbsp; Windows &NT: вимагає 3.51 або пізнішої версії.
Windows:Вимагає Windows 95 або пізнішої версії.
Windows CE:Потрібна Версія 1.0 або пізнішу версію.
Заголовка:Оголошена в winuser.h.
Імпортувати бібліотеки:Використання user32.lib.

Дивіться також

Прокрутіть барів огляд, функції смуги прокрутки, SCROLLINFO, SetScrollInfo, WM_HSCROLL, WM_VSCROLL

Index