Структура SCROLLINFO (winuser.h)

  • Статья

Структура SCROLLINFO содержит параметры полосы прокрутки, которые задаются функцией SetScrollInfo (или SBM_SETSCROLLINFO сообщением) или извлекаются функцией GetScrollInfo (или SBM_GETSCROLLINFO сообщением).

Синтаксис

typedef struct tagSCROLLINFO {
  UINT cbSize;
  UINT fMask;
  int  nMin;
  int  nMax;
  UINT nPage;
  int  nPos;
  int  nTrackPos;
} SCROLLINFO, *LPSCROLLINFO;

Члены

cbSize

Тип: UINT

Задает размер этой структуры (в байтах). Вызывающий объект должен задать для этого параметра значение sizeof(SCROLLINFO).

fMask

Тип: UINT

Указывает параметры полосы прокрутки для задания или извлечения. Этот элемент может быть сочетанием следующих значений:

Значение Значение
SIF_ALL
 Сочетание SIF_PAGE, SIF_POS, SIF_RANGE и SIF_TRACKPOS.
SIF_DISABLENOSCROLL
 Это значение используется только при задании параметров полосы прокрутки. Если новые параметры полосы прокрутки делают полосу прокрутки ненужной, отключите полосу прокрутки, а не удаляйте ее.
SIF_PAGE
 Элемент nPage содержит размер страницы для пропорциональной полосы прокрутки.
SIF_POS
 Элемент nPos содержит положение поля прокрутки, которое не обновляется при перетаскивании пользователем.
SIF_RANGE
 Члены nMin и nMax содержат минимальное и максимальное значения для диапазона прокрутки.
SIF_TRACKPOS
 Элемент nTrackPos содержит текущую позицию поля прокрутки, пока пользователь перетаскивает его.

nMin

Тип: int

Указывает минимальную позицию прокрутки.

nMax

Тип: int

Задает максимальную позицию прокрутки.

nPage

Тип: UINT

Задает размер страницы в единицах устройства. Полоса прокрутки использует это значение для определения соответствующего размера пропорционального поля прокрутки.

nPos

Тип: int

Указывает положение поля прокрутки.

nTrackPos

Тип: int

Указывает непосредственное положение поля прокрутки, которое перетаскивает пользователь. Приложение может получить это значение при обработке кода запроса SB_THUMBTRACK. Приложение не может задать немедленную позицию прокрутки; Функция SetScrollInfo игнорирует этот элемент.

Требования

   
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Верхняя часть winuser.h (включая Windows.h)

См. также раздел

GetScrollInfo

Справочные материалы

SBM_GETSCROLLINFO

SBM_SETSCROLLINFO

SetScrollInfo