Класс CMFCRibbonProgressBar

Замечание

Библиотека классов Microsoft Foundation (MFC) продолжает поддерживаться. Однако мы больше не добавляем функции или обновляем документацию.

Реализует элемент управления, который визуально показывает ход выполнения длительных операций.

Синтаксис

class CMFCRibbonProgressBar : public CMFCRibbonBaseElement

Участники

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

Имя	Описание
CMFCRibbonProgressBar::CMFCRibbonProgressBar	Создает и инициализирует объект CMFCRibbonProgressBar.

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

Имя	Описание
CMFCRibbonProgressBar::GetPos	Возвращает текущий ход выполнения.
CMFCRibbonProgressBar::GetRangeMax	Возвращает максимальное значение текущего диапазона.
CMFCRibbonProgressBar::GetRangeMin	Возвращает минимальное значение текущего диапазона.
CMFCRibbonProgressBar::GetRegularSize	Возвращает стандартный размер элемента ленты. (Переопределения CMFCRibbonBaseElement::GetRegularSize.)
CMFCRibbonProgressBar::IsInfiniteMode	Указывает, работает ли индикатор выполнения в бесконечном режиме.
CMFCRibbonProgressBar::OnDraw	Вызывается платформой для отрисовки элемента ленты. (Переопределения CMFCRibbonBaseElement::OnDraw.)
CMFCRibbonProgressBar::SetInfiniteMode	Задает индикатор хода выполнения для работы в бесконечном режиме.
CMFCRibbonProgressBar::SetPos	Задает текущий ход выполнения.
CMFCRibbonProgressBar::SetRange	Задает минимальные и максимальные значения.

Замечания

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

Пример

В приведенном ниже примере демонстрируется использование различных методов класса CMFCRibbonProgressBar . В примере показано, как задать индикатор хода выполнения для работы в бесконечном режиме (где время завершения операции неизвестно), задать минимальное и максимальное значения для панели выполнения и задать текущее положение индикатора выполнения. Этот фрагмент кода является частью примера демонстрации MS Office 2007.

// int cxProgress
// BOOL m_bInfiniteProgressMode
CMFCRibbonProgressBar *pProgressBar = new CMFCRibbonProgressBar(ID_STATUSBAR_PROGRESS, cxProgress);

pProgressBar->SetInfiniteMode(m_bInfiniteProgressMode);
pProgressBar->SetRange(0, 200);
pProgressBar->SetPos(200, true);

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

CObject

CMFCRibbonBaseElement

CMFCRibbonProgressBar

Требования

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

CMFCRibbonProgressBar::CMFCRibbonProgressBar

Создает и инициализирует объект CMFCRibbonProgressBar .

CMFCRibbonProgressBar();

CMFCRibbonProgressBar(
    UINT nID,
    int nWidth = 90,
    int nHeight = 22);

Параметры

nID
[in] Указывает идентификатор команды для панели выполнения ленты.

nWidth
[in] Задает ширину (в пикселях) индикатора выполнения ленты.

nHeight
[in] Задает высоту в пикселях панели хода выполнения ленты.

CMFCRibbonProgressBar::GetPos

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

int GetPos () const;

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

Значение, представляющее текущее положение индикатора выполнения.

Замечания

Диапазон, заданный методом CMFCRibbonProgressBar::SetRange , должен находиться в диапазоне.

CMFCRibbonProgressBar::GetRangeMax

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

int GetRangeMax() const;

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

Максимальное значение текущего диапазона.

Замечания

CMFCRibbonProgressBar::GetRangeMin

Возвращает текущее минимальное значение диапазона индикатора выполнения.

int GetRangeMin() const;

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

Минимальное значение текущего диапазона.

CMFCRibbonProgressBar::GetRegularSize

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

virtual CSize GetRegularSize(CDC* pDC);

Параметры

[in] PDC

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

Замечания

CMFCRibbonProgressBar::IsInfiniteMode

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

BOOL IsInfiniteMode() const;

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

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

Замечания

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

CMFCRibbonProgressBar::OnDraw

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

virtual void OnDraw(CDC* pDC);

Параметры

[in] PDC

Замечания

CMFCRibbonProgressBar::SetInfiniteMode

Задает индикатор хода выполнения для работы в бесконечном режиме.

void SetInfiniteMode(BOOL bSet = TRUE);

Параметры

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

Замечания

Как правило, если индикатор выполнения находится в бесконечном режиме, он сообщает пользователю, что операция продолжается, но время завершения неизвестно. Таким образом, индикатор выполнения заполняется многократно из минимального значения до максимального значения.

CMFCRibbonProgressBar::SetPos

Задает текущее положение индикатора выполнения.

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

Параметры

nPos
[in] Указывает положение, для которого задана панель выполнения.

bRedraw
[in] Указывает, следует ли перезапись панели выполнения.

Замечания

Диапазон, заданный методом CMFCRibbonProgressBar::SetRange , должен находиться в диапазоне.

CMFCRibbonProgressBar::SetRange

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

void SetRange(
    int nMin,
    int nMax);

Параметры

nMin
[in] Задает минимальное значение диапазона.

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

Замечания

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

См. также

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