Линейки прокрутки. Основные сведения о линейках прокрутки, страница 5

SetScrolllnfo                                     • Windows 98   * Windows 2000

Описание

Функция SetScrolllnfo устанавливает параметры линейки прокрутки, включая минимальную и максимальную позиции прокрутки, размер страницы и позицию ползунка. При необходимости функция также выполняет повторный вывод линейки прокрутки.

Синтаксис

rat SetScrollInfo( HWND hWnd, 'mi nBar, LPSCROLLINFO Ipsi, BOOL bRedraw )

Параметры

hWnd

HWND. Дескриптор окна со стандартной линейкой прокрутки или элемента управления линейкой прокрутки, в зависимости от значения параметра nBar.

nBar

int. Тип линейки прокрутки, для которого должны быть установлены параметры. Этот параметр может иметь одно из значений, перечисленных в табл. 10.9.

Таблица 10.9. Значения параметра nBar функции SetScrolllnfo

Значение

Описание

SB_CTL

Установить параметры элемента управления линейкой прокрутки. Параметр /iwnd должен представлять собой дескриптор элемента управления линейкой прокрутки.

SB HORZ

Установить параметры стандартной горизонтальной линейки прокрутки окна.

SB_VERT

Установить параметры стандартной вертикальной линейки прокрутки окна.

Ipsi

LPSCROLLINFO. Указатель на структуру SCROLLINFO, которая содержит новые параметры линейки прокрутки. Перед вызовом функции SetScrolllnfo приложение должно инициализировать члены этой структуры /Mask и cbSize. См. приведенное ниже определение структуры SCROLLINFO в описании функции GetScrollInfo.

bRedraw

BOOL. Определяет, должна ли линейка прокрутки выводиться повторно для отражения в ней изменений. Если этот параметр — TRUE, линейка прокрутки должна выводиться повторно; в ином случае она повторно не выводится.

Возвращаемое значение

int. Текущая позиция ползунка.

Включаемый файл

winuser.h

См. также

GetScrollInfo, SetScroIlPos, SetScrollRange

Пример

Следующий пример, показанный на рис. 10.7, аналогичен приведенному в описании функции EnableScrollBar, за исключением того, что для установки диапазона линейки прокрутки и размера страницы применяется функция SetScrolllnfo. Обратите внимание, что поле прокрутки теперь пропорционально размеру страницы.

Ck.    \local-sources\chaplO\10-04. txt

ShowScrollBar                                    • Windows 98   • Windows 2000

Описание

Функция ShowScrollBar позволяет показать или скрыть линейку прокрутки. Эта функция применяется для скрытия или отображения линейки прокрутки при создании линейки прокрутки или в дальнейшем. Эту функцию не следует вызывать во время обработки сообщения линейки прокрутки.

Синтаксис

BOOL ShowScroIlBar( HWND hWnd, int nBar, BOOL bShow )

Параметры

hWnd

HWND. Дескриптор элемента управления линейкой прокрутки или окна со стандартной линейкой прокрутки, в зависимости от значения параметра nBar.

nBar

int. Линейка (линейки) прокрутки, которая должна быть отображена или скрыта. Этот параметр может иметь одно из значений, перечисленных в табл. 10.10.

Таблица 10. 10. Значения параметра nBar функции ShowScrollBar

Значение

Описание

SB_BOTH

Показать или скрыть стандартные горизонтальную и вертикальную линейки прокрутки окна.

SB_CTL

Показать или скрыть элемент управления линейкой прокрутки. Параметр hwnd должен представлять собой дескриптор элемента управления линейкой прокрутки.

SB_HORZ

Показать или скрыть стандартную горизонтальную линейку прокрутки окна.

SB_VERT

Показать или скрыть стандартную вертикальную линейку прокрутки окна.

bShow

BOOL. Определяет, должна ли быть линейка прокрутки показана или скрыта. Если этот параметр — TRUE, линейка прокрутки должна быть показана; в ином случае она должна быть скрыта.

Возвращаемое значение

BOOL. В случае успешного выполнения возвращаемое значение — TRUE; в ином случае возвращаемое значение — FALSE.

Включаемый файл

winuser.h

См. также

ShowWindow

Пример

См. пример применения функции EnableScrollBar.