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

Таблица 10.1. Функциилинейкипрокрутки

Функция

Назначение

EnableScrollBar

Разрешает или запрещает элемент управления линейкой прокрутки

GetScrolllnfo

Выбирает параметры линейки прокрутки

GetScrollPos

Выбирает текущую позицию ползунка линейки прокрутки

GetScrollRange

Выбирает минимальный и максимальный диапазон значений линейки прокрутки

ScroJIDC

Выполняет прокрутку области в контексте устройства и вычисляет области обновления

ScroHWindowEx

Выполняет прокрутку информационного наполнения клиентской области окна

SetScrolllnfo

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

ShowScrollBar

Отображает линейку прокрутки, предоставляя возможность подключить ее к рамке окна

EnableScrollBar                                 • Windows 98   • Windows 2000

Описание

Функция EnableScrollBar разрешает или запрещает одну или обе стрелю линейки прокрутки. Если линейка прокрутки запрещена, при попытке ис пользовать линейку прокрутки не выполняются никакие действия и hi выдаются сообщения.

Синтаксис

BOOL EnableScrollBar( HWND hWnd, UINT uSB flags, UINT uArrowFlags )

Параметры

hWnd

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

uSBFIags

UINT. Тип линейки прокрутки, которая должна быть разрешена или зап решена. Этот параметр может иметь одно из значений, перечисленных i табл. 10.2.

Таблица 10.2. ЗначенияпараметраuSBFIags функцииEnableScrollBar

Значение

Описание

SB_BOTH

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

SB_CTL

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

SB_HORZ

Разрешить или запретить горизонтальную линейку прокрутки, связанную с окном. Параметр hwnd должен представлять собой дескриптор окна.

SB_VERT

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

uArrowFlags

UINT. Определяет, разрешены или запрещены стрелки линейки прокрутки и указывает, какие стрелки разрешены или запрещены. Этот параметр может иметь одно из значений, перечисленных в табл. 10.3.

Таблица 10.3. ЗначенияпараметраuArrowFlags функцииEnableScrollBar

Значение

Описание

ESB_DISABLE  BOTH

Запретить обе стрелки на линейке прокрутки

ESB_DISABLE_DOWN

Запретить стрелку вниз на вертикальной линейке прокрутки

ESB_DISABLE_LEFT

Запретить стрелку влево на горизонтальной линейке прокрутки

ESB_DISABLE_LTUP

Запретить стрелку влево на горизонтальной или стрелку вверх на вертикальной линейке прокрутки

ESB DISABLEJHGHT

Запретить стрелку вправо на горизонтальной линейке прокрутки

ESB_DISABLE_RTDN

Запретить стрелку вправо на горизонтальной или стрелку вниз на вертикальной линейке прокрутки

ESB_DISABLE_UP

Запретить стрелку вверх на вертикальной линейке прокрутки

ESB_ENABLE  BOTH

Разрешить обе стрелки на линейке прокрутки

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

BOOL TRUE, если стрелки разрешены или запрещены, как указано. FALSE, если стрелки — уже в требуемом состоянии или произошла ошибка.

Включаемый файл winuser.h                       ^: ,

См. также

ShowScrollBar

Пример

В следующем примере показано, как использовать функцию EnableScrollBar, чтобы запретить линейку прокрутки до тех пор, пока она не потребуется. Каждый раз, когда пользователь выбирает опции меню Test!, наращивается счетчик и в окно добавляется новая строка текста. После того как общее число строк перестает помещаться в клиентской области окна, линейка прокрутки становится разрешенной. Если размеры окна изменяются соответственно количеству добавленных строк, линейка прокрутки снова становится запрещенной. На рис. 10.4 показан вид приложения после добавления девяти элементов.

См.    \local-aources\cbaplO\10-01 . txt