сообщение SBM_GETSCROLLINFO
Сообщение SBM_GETSCROLLINFO отправляется для получения параметров полосы прокрутки.
Приложения не должны отправлять это сообщение напрямую. Вместо этого они должны использовать функцию GetScrollInfo . Окно получает это сообщение через функцию WindowProc . Приложения, реализующие пользовательский элемент управления полосой прокрутки, должны реагировать на эти сообщения, чтобы функция GetScrollInfo работала правильно.
Параметры
-
wParam
-
Этот параметр не используется.
-
lParam
-
Указатель на структуру SCROLLINFO . Перед вызовом GetScrollInfo задайте для элемента cbSize структуры значение sizeof(SCROLLINFO) и задайте элемент fMask , чтобы указать извлекаемые параметры полосы прокрутки. Перед возвратом сообщение копирует указанные параметры в соответствующие элементы структуры.
Элемент fMask может иметь одно или несколько из следующих значений.
Значение Значение - SIF_ALL
Сочетание SIF_PAGE, SIF_POS, SIF_RANGE и SIF_TRACKPOS. - SIF_PAGE
Копирует страницу прокрутки в элемент nPage. - SIF_POS
Копирует позицию прокрутки в элемент nPos. - SIF_RANGE
Копирует диапазон прокрутки в элементы nMin и nMax. - SIF_TRACKPOS
Копирует текущую позицию отслеживания поля прокрутки в элемент nTrackPos.
Возвращаемое значение
Если сообщение извлекло какие-либо значения, возвращается значение TRUE; в противном случае — FALSE.
Комментарии
Сообщения, указывающие положение полосы прокрутки, WM_HSCROLL и WM_VSCROLL, предоставляют только 16 битов данных о положении. Однако структура SCROLLINFO , используемая SBM_GETSCROLLINFO, SBM_SETSCROLLINFO, GetScrollInfo и SetScrollInfo , предоставляет 32 бита данных о положении полосы прокрутки. Эти сообщения и функции можно использовать при обработке WM_HSCROLL или WM_VSCROLL сообщений для получения данных о положении 32-разрядной полосы прокрутки.
Чтобы получить 32-разрядную позицию поля прокрутки (большой палец) во время SB_THUMBTRACK кода запроса в WM_HSCROLL или WM_VSCROLL сообщении, отправьте SBM_GETSCROLLINFO со значением SIF_TRACKPOS в элементе fMask структуры SCROLLINFO . Сообщение возвращает позицию отслеживания поля прокрутки в элементе nTrackPos структуры SCROLLINFO . Это позволяет получить положение поля прокрутки по мере перемещения пользователя. Кроме того, для получения той же информации можно использовать функцию GetScrollInfo .
Требования
Требование | Значение |
---|---|
Минимальная версия клиента |
Windows Vista [только классические приложения] |
Минимальная версия сервера |
Windows Server 2003 [только классические приложения] |
Заголовок |
|
См. также раздел
-
Справочные материалы