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);
상속 계층 구조
요구 사항
헤더: 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] 범위의 최대값을 지정합니다.
설명
최소값과 최대값을 설정하여 진행률 표시줄의 범위를 정의하려면 이 메서드를 사용합니다.