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	최소값과 최대값을 설정합니다.

설명

A는 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] 리본 진행률 표시줄의 명령 ID를 지정합니다.

nWidth
[in] 리본 진행률 표시줄의 너비를 픽셀 단위로 지정합니다.

nHeight
[in] 리본 진행률 표시줄의 높이를 픽셀 단위로 지정합니다.

CMFCRibbonProgressBar::GetPos

진행률 표시줄의 현재 위치를 반환합니다.

int GetPos () const;

Return Value

진행률 표시줄의 현재 위치를 나타내는 값입니다.

설명

설정되는 범위는 CMFCRibbonProgressBar::SetRange 메서드로 지정된 범위 내에 있어야 합니다.

CMFCRibbonProgressBar::GetRangeMax

진행률 표시줄의 현재 최대값을 반환합니다.

int GetRangeMax() const;

Return Value

현재 범위의 최대값입니다.

설명

CMFCRibbonProgressBar::GetRangeMin

진행률 표시줄의 현재 최소 범위 값을 반환합니다.

int GetRangeMin() const;

Return Value

현재 범위의 최소값입니다.

CMFCRibbonProgressBar::GetRegularSize

자세한 내용은 Visual Studio 설치의 VC\atlmfc\src\mfc 폴더에 있는 소스 코드를 참조하세요.

virtual CSize GetRegularSize(CDC* pDC);

매개 변수

[in] Pdc

Return Value

설명

CMFCRibbonProgressBar::IsInfiniteMode

진행률 표시줄이 무한 모드에서 작동하는지 여부를 지정합니다.

BOOL IsInfiniteMode() const;

Return Value

진행률 표시줄이 무한 모드이면 TRUE이고, 그렇지 않으면 FALSE입니다.

설명

무한 모드에서 진행률 표시줄은 최소값에서 최대값까지 반복적으로 채웁니다. 무한 모드를 사용하여 작업이 진행 중이지만 완료 시간을 알 수 없음을 나타낼 수 있습니다.

CMFCRibbonProgressBar::OnDraw

자세한 내용은 Visual Studio 설치의 VC\atlmfc\src\mfc 폴더에 있는 소스 코드를 참조하세요.

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 클래스