IOperationsProgressDialog::StartProgressDialog 메서드(shobjidl_core.h)

지정된 진행률 대화 상자를 시작합니다.

구문

HRESULT StartProgressDialog(
  [in] HWND       hwndOwner,
  [in] OPPROGDLGF flags
);

매개 변수

[in] hwndOwner

형식: HWND

부모 창에 대한 핸들입니다.

[in] flags

형식:DWORD

작업을 사용자 지정하는 플래그입니다. 이러한 플래그는 Shlobj.h에서 선언됩니다. 다음 값의 조합입니다.

PROGDLG_NORMAL(0x00000000)

기본값인 일반 진행률 대화 상자 동작입니다.

PROGDLG_MODAL(0x00000001)

대화 상자는 hwndOwner에 대한 모달입니다. 기본 설정은 모덜리스입니다.

PROGDLG_AUTOTIME(0x00000002)

남은 시간으로 "Line3" 텍스트를 업데이트합니다. IOperationsProgressDialog::StartProgressDialog에서 시작한 진행률 대화 상자가 남은 시간을 자동으로 표시하므로 이 플래그를 암시적으로 설정할 필요가 없습니다.

PROGDLG_NOTIME(0x00000004)

남은 시간을 표시하지 마세요. 대화 상자의 목적에 어긋나므로 IOperationsProgressDialog 를 통해 이 플래그를 설정하지 않는 것이 좋습니다.

PROGDLG_NOMINIMIZE(0x00000008)

최소화 단추를 표시하지 마세요.

PROGDLG_NOPROGRESSBAR(0x00000010)

진행률 표시줄을 표시하지 마세요.

PROGDLG_MARQUEEPROGRESS(0x00000020)

이 메서드에서는 이 플래그가 잘못되었습니다. 진행률 표시줄을 선택 윤곽 모드로 설정하려면 IOperationsProgressDialog::SetMode의 플래그를 사용합니다.

PROGDLG_NOCANCEL(0x00000040)

작업을 취소할 수 없으므로 취소 단추를 표시하지 마세요. 반드시 필요한 경우에만 이 값을 사용합니다.

OPPROGDLG_DEFAULT(0x00000000)

Windows 7 이상. 기본 정상 작업 진행률 대화 상자 동작을 나타냅니다.

OPPROGDLG_ENABLEPAUSE(0x00000080)

일시 중지 단추를 표시합니다. 작업을 일시 중지할 수 있는 경우에만 사용합니다.

OPPROGDLG_ALLOWUNDO(0x00000100)

대화 상자를 통해 작업을 실행 취소할 수 있습니다. 중지 단추는 실행 취소가 됩니다. 키를 누르면 실행 취소 단추가 중지로 되돌아갑니다.

OPPROGDLG_DONTDISPLAYSOURCEPATH(0x00000200)

진행률 대화 상자에 원본 파일의 경로를 표시하지 마세요.

OPPROGDLG_DONTDISPLAYDESTPATH(0x00000400)

진행률 대화 상자에 대상 파일의 경로를 표시하지 마세요.

OPPROGDLG_NOMULTIDAYESTIMATES(0x00000800)

Windows 7 이상. 예상 완료 시간이 1일보다 큰 경우 시간을 표시하지 마세요.

OPPROGDLG_DONTDISPLAYLOCATIONS(0x00001000)

Windows 7 이상. 진행률 대화 상자에 위치 줄을 표시하지 마세요.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

진행률 대화 상자는 대화 상자가 보고하는 파일 작업과는 별도의 스레드에서 만들어야 합니다. 대화 상자가 파일 작업과 동일한 스레드에서 실행되는 경우 진행률 메시지는 리소스가 허용하는 경우에만 전송됩니다. 파일 작업과 동일한 스레드의 진행률 메시지는 전혀 전송되지 않을 수 있습니다.

IOperationsProgressDialog::StartProgressDialog가 호출되면 IProgressDialog, IActionProgressDialog 또는 IActionProgress에서 CLSID_ProgressDialog 개체의 instance 액세스할 수 없습니다. QueryInterface를 사용하여 이러한 인터페이스에 액세스할 수 있지만 대부분의 메서드는 호출할 수 없습니다. IOperationsProgressDialog 는 Windows Vista 이상 작업 엔진에 대한 새 진행률 대화 상자를 표시하는 데 사용되는 인터페이스입니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	shobjidl_core.h(Shobjidl.h 포함)