CTaskDialog::SetProgressBarRange

아티클
02/21/2013

진행률 표시줄의 범위를 조정합니다.

void SetProgressBarRange(
   int nRangeMin,
   int nRangeMax
);

매개 변수

[in] nRangeMin
진행률 표시줄의 하한값입니다.
[in] nRangeMax
진행률 표시줄의 상한입니다.

설명

상대적으로 진행률 표시줄의 위치는 nRangeMin 및 nRangeMax.예를 들어, 경우 nRangeMin 50 되 고 nRangeMax 100, 75 위치 진행률 표시줄을 중간 위치입니다.사용 CTaskDialog::SetProgressBarPosition 진행률 표시줄의 위치를 설정 합니다.

진행률 표시줄의 옵션을 표시 하려면 TDF_SHOW_PROGRESS_BAR 사용할 수 있어야 및 TDF_SHOW_MARQUEE_PROGRESS_BAR 사용할 수 있어야 합니다.이 메서드를 자동으로 설정 TDF_SHOW_PROGRESS_BAR 및 지웁니다 TDF_SHOW_MARQUEE_PROGRESS_BAR.사용 CTaskDialog::SetOptions 의이 인스턴스에 대 한 옵션을 수동으로 변경 하는 CTaskDialog 클래스.

이 메서드는 예외를 throw는 (MFC)를 확인 합니다. 매크로 경우 nRangeMin 것 보다 작지 않음 nRangeMax.이 메서드는 예외를 경우 throw는 CTaskDialog 움직이는 진행률 표시줄이 이미 표시 하 고 있습니다.

예제

// TODO: Replace the strings below with the appropriate message, 
// main instruction, and dialog title
CString message("This is an important message to the user.");
CString mainInstruction("Important!\nPlease read!");
CString title("Alert Dialog");

CTaskDialog taskDialog(message, mainInstruction, title, 
    TDCBF_YES_BUTTON | TDCBF_NO_BUTTON | TDCBF_CANCEL_BUTTON );

// Add a marquee progress bar.
taskDialog.SetProgressBarMarquee();

taskDialog.DoModal();

// Remove the marquee bar and replace it with a standard progress bar
taskDialog.SetProgressBarMarquee(0);
taskDialog.SetProgressBarRange(0, 100);
taskDialog.SetProgressBarPosition(75);
taskDialog.SetProgressBarState();

taskDialog.DoModal();