Функции-члены элемента управления "Ползунок"
Приложение может вызывать функции-члены элемента управления ползунка для получения сведений об элементе управления ползунка (CSliderCtrl) и изменении его характеристик.
Чтобы получить положение ползунка (то есть значение, выбранное пользователем), используйте функцию-член GetPos . Чтобы задать положение ползунка, используйте функцию-член SetPos . В любое время можно использовать функцию-член, VerifyPos чтобы убедиться, что ползунок находится между минимальными и максимальными значениями.
Диапазон элемента управления ползунка — это набор смежных значений, которые может представлять элемент управления ползунка. Большинство приложений используют функцию-член SetRange , чтобы задать диапазон элемента управления ползунка при первом создании. Приложения могут динамически изменять диапазон после создания элемента управления ползунка с помощью функций-членов SetRangeMax и SetRangeMin . Приложение, которое позволяет динамически изменять диапазон, обычно получает конечные параметры диапазона, когда пользователь завершит работу с ползунок. Чтобы получить эти параметры, используйте функции-члены GetRange, GetRangeMax и GetRangeMin.
Приложение может использовать стиль ТБS_AUTOTICKS для автоматического отображения меток элемента управления ползунка. Если приложению необходимо управлять положением или частотой меток, можно использовать ряд функций-членов.
Чтобы задать позицию галочки, приложение может использовать функцию-член SetTic . Функция-член SetTicFreq позволяет приложению задавать галочки, которые отображаются через регулярные интервалы в диапазоне элемента управления ползунка. Например, приложение может использовать эту функцию-член для отображения только 10 галок в диапазоне от 1 до 100.
Чтобы получить индекс в диапазоне, соответствующем метке, используйте функцию элемента GetTic . Функция-член GetTicArray извлекает массив этих индексов. Чтобы получить позицию галочки, в координатах клиента используйте функцию элемента GetTicPos . Приложение может получить количество тиковых меток с помощью функции-члена GetNumTics .
Функция-член ClearTics удаляет все галочки элемента управления ползунка.
Размер строки элемента управления ползунка определяет, насколько далеко ползунок перемещается, когда приложение получает ТБ_LINEDOWN или ТБ_LINEUP уведомление. Аналогичным образом размер страницы определяет ответ на сообщения ТБ_PAGEDOWN и ТБ_PAGEUP уведомления. Приложения могут получать и задавать значения размера строки и страницы с помощью функций-членов GetLineSize, SetLineSize, GetPageSize и SetPageSize.
Приложение может использовать функции-члены для получения измерений элемента управления ползунка. Функция-член GetThumbRect извлекает ограничивающий прямоугольник ползунка. Функция-член GetChannelRect извлекает ограничивающий прямоугольник для канала элемента управления ползунка. (Канал — это область перемещения ползунка, которая содержит выделение при выборе диапазона.)
Если элемент управления ползунка имеет стиль ТБS_ENABLESELRANGE, пользователь может выбрать диапазон смежных значений из него. Ряд функций-членов позволяет динамически настраивать диапазон выбора. Функция-член SetSelection задает начальные и конечные позиции выделения. Когда пользователь завершит настройку диапазона выбора, приложение может получить параметры с помощью функции-члена GetSelection . Чтобы очистить выбор пользователя, используйте функцию-член ClearSel .