Класс CMFCRibbonProgressBar
Реализует элемент управления, который визуально показывает ход выполнения длительных операций.
Синтаксис
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);
Иерархия наследования
Требования
Заголовок: 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