Класс CMFCRibbonSlider

Класс CMFCRibbonSlider реализует ползунок, который можно добавить в панель ленты или строку состояния ленты. Элемент управления "ползунок" ленты напоминает ползунки масштаба, отображаемые в приложениях Office 2007.

Синтаксис

class CMFCRibbonSlider : public CMFCRibbonBaseElement

Участники

Открытые конструкторы

Имя	Описание
CMFCRibbonSlider::CMFCRibbonSlider	Создает и инициализирует элемент управления ползунок ленты.

Открытые методы

Имя	Описание
CMFCRibbonSlider::GetPos	Возвращает текущую позицию элемента управления ползунка.
CMFCRibbonSlider::GetRangeMax	Возвращает максимальное значение ползунка.
CMFCRibbonSlider::GetRangeMin	Возвращает минимальное значение ползунка.
CMFCRibbonSlider::GetRegularSize	Возвращает стандартный размер элемента ленты. (Переопределения CMFCRibbonBaseElement::GetRegularSize.)
CMFCRibbonSlider::GetZoomIncrement	Возвращает размер увеличения для элемента управления ползунка.
CMFCRibbonSlider::HasZoomButtons	Указывает, имеет ли ползунок кнопки масштабирования.
CMFCRibbonSlider::OnDraw	Вызывается платформой для отрисовки элемента ленты. (Переопределения CMFCRibbonBaseElement::OnDraw.)
CMFCRibbonSlider::SetPos	Задает текущую позицию элемента управления ползунка.
CMFCRibbonSlider::SetRange	Задает диапазон элемента управления ползунка, задав минимальные и максимальные значения.
CMFCRibbonSlider::SetZoomButtons	Отображает или скрывает кнопки масштабирования.
CMFCRibbonSlider::SetZoomIncrement	Задает размер увеличения для элемента управления ползунка.

Замечания

Метод можно использовать SetRange для настройки диапазона добавок масштабирования ползунка. Текущее положение ползунка можно задать с помощью SetPos метода.

С помощью SetZoomButtons метода можно отобразить кнопки кругового масштабирования в левой и правой части элемента управления ползунка. По умолчанию ползунок является горизонтальным, левая кнопка масштабирования отображает знак минуса, а правая кнопка масштабирования отображает знак плюса.

Метод SetZoomIncrement определяет приращение, добавляемое или вычитаемое из текущей позиции, когда пользователь щелкает кнопки масштабирования.

Пример

В следующем примере показано, как использовать различные методы в CMFCRibbonSlider классе для задания свойств ползунка. В примере показано, как создать CMFCRibbonSlider объект, отобразить кнопки масштабирования, задать текущую позицию элемента управления ползунка и задать диапазон значений для элемента управления ползунка.

// Create a ribbon slider.
CMFCRibbonSlider *ribbonSlider = new CMFCRibbonSlider();
// Set the various properties of the slider.
ribbonSlider->SetZoomButtons(true);
ribbonSlider->SetPos(50, TRUE);
ribbonSlider->SetRange(0, 100);
// Add the ribbon slider to the Favorites panel.
// CMFCRibbonPanel* pPanelFavorites
pPanelFavorites->Add(ribbonSlider);

Иерархия наследования

CObject

CMFCRibbonBaseElement

CMFCRibbonSlider

Требования

Заголовок: afxribbonslider.h

CMFCRibbonSlider::CMFCRibbonSlider

Создайте ползунок ленты.

CMFCRibbonSlider(
    UINT nID,
    int nWidth=100);

Параметры

Nid
[in] Идентификатор ползунка.

[in]. Ширина ползунка nWidth в пикселях.

Замечания

Создает ползунок ленты, который имеет ширину пикселей nWidth в категории панели, где добавляется ползунок. По умолчанию ползунок является горизонтальным.

CMFCRibbonSlider::GetPos

Возвращает текущую позицию элемента управления ползунка.

int GetPos() const;

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

Текущая позиция элемента управления ползунок, которая является позицией относительно начала ползунка.

CMFCRibbonSlider::GetRangeMax

Получает максимальное увеличение ползунка, которое ползунок может перемещаться по элементу управления ползунка.

int GetRangeMax() const;

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

Максимальное увеличение ползунка, которое ползунок может перемещаться по элементу управления ползунка.

CMFCRibbonSlider::GetRangeMin

Возвращает минимальное увеличение, которое ползунок может перемещаться по элементу управления ползунка.

int GetRangeMin() const;

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

Минимальное увеличение, которое ползунок может перемещаться по элементу управления ползунок.

CMFCRibbonSlider::GetRegularSize

Дополнительные сведения см. в исходном коде, расположенном в папке VC\atlmfc\src\mfc установки Visual Studio.

virtual CSize GetRegularSize(CDC* pDC);

Параметры

[in] Pdc

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

Замечания

CMFCRibbonSlider::GetZoomIncrement

Получите увеличение для элемента управления ползунка.

int GetZoomIncrement() const;

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

Увеличение для элемента управления ползунка.

CMFCRibbonSlider::HasZoomButtons

Указывает, имеет ли ползунок кнопки масштабирования.

BOOL HasZoomButtons() const;

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

ЗНАЧЕНИЕ TRUE, если ползунок имеет кнопки масштабирования; Значение FALSE в противном случае.

CMFCRibbonSlider::OnDraw

Дополнительные сведения см. в исходном коде, расположенном в папке VC\atlmfc\src\mfc установки Visual Studio.

virtual void OnDraw(CDC* pDC);

Параметры

[in] Pdc

Замечания

CMFCRibbonSlider::SetPos

Задайте текущую позицию элемента управления ползунка.

void SetPos(
    int nPos,
    BOOL bRedraw=TRUE);

Параметры

Npos
[in] Задает позицию для ползунка. Позиция относительно начала ползунка.

bRedraw
[in] Если значение TRUE, ползунок будет перезабран.

CMFCRibbonSlider::SetRange

Задайте диапазон значений для элемента управления ползунка.

void SetRange(
    int nMin,
    int nMax);

Параметры

nMin
[in] Задает минимальное значение элемента управления ползунка.

nMax
[in] Задает максимальное значение элемента управления ползунка.

Замечания

Задает диапазон значений для элемента управления ползунка, задав минимальные и максимальные значения.

CMFCRibbonSlider::SetZoomButtons

Отображение или скрытие кнопок масштабирования.

void SetZoomButtons(BOOL bSet=TRUE);

Параметры

[in]. bSet TRUE для отображения кнопок масштабирования; ЗНАЧЕНИЕ FALSE, чтобы скрыть их.

CMFCRibbonSlider::SetZoomIncrement

Задайте увеличение для элемента управления ползунка.

void SetZoomIncrement(int nZoomIncrement);

Параметры

nZoomIncrement
[in] Указывает увеличение элемента управления ползунка.

См. также

Диаграмма иерархии
Классы
Класс CMFCRibbonBaseElement