Класс 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);
Иерархия наследования
Требования
Заголовок: 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] Указывает увеличение элемента управления ползунка.