IProgressDialog::StartProgressDialog 메서드(shlobj_core.h)

아티클
03/02/2024

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

구문

HRESULT StartProgressDialog(
  [in] HWND     hwndParent,
       IUnknown *punkEnableModless,
       DWORD    dwFlags,
       LPCVOID  pvResevered
);

매개 변수

[in] hwndParent

형식: HWND

대화 상자의 부모 창에 대한 핸들입니다.

punkEnableModless

형식: IUnknown*

예약되어 있습니다. NULL로 설정합니다.

dwFlags

형식:DWORD

진행률 대화 상자의 작업을 제어하는 플래그입니다. 다음 값의 조합입니다.

PROGDLG_NORMAL

일반 진행률 대화 상자 동작입니다.

PROGDLG_MODAL

진행률 대화 상자는 hwndParent로 지정된 창으로 모달됩니다. 기본적으로 진행률 대화 상자는 모덜리스입니다.

PROGDLG_AUTOTIME

나머지 시간을 자동으로 예측하고 3줄에 예상 시간을 표시합니다. 이 플래그가 설정되면 IProgressDialog::SetLine 을 사용하여 줄 1과 2에 텍스트를 표시할 수 있습니다.

PROGDLG_NOTIME

"남은 시간" 텍스트를 표시하지 마세요.

PROGDLG_NOMINIMIZE

대화 상자의 캡션 표시줄에 최소화 단추를 표시하지 마세요.

PROGDLG_NOPROGRESSBAR

진행률 표시줄을 표시하지 마세요. 일반적으로 애플리케이션은 남은 작업의 양을 정량적으로 결정하고 주기적으로 해당 값을 IProgressDialog::SetProgress에 전달할 수 있습니다. 진행률 대화 상자는 이 정보를 사용하여 진행률 표시줄을 업데이트합니다. 이 플래그는 일반적으로 호출 애플리케이션이 작업이 완료되기를 기다려야 하지만 대화 상자를 업데이트하는 데 사용할 수 있는 정량적 정보가 없을 때 설정됩니다.

PROGDLG_MARQUEEPROGRESS

Windows Vista 이상. 진행률 표시줄을 네온 모드로 설정합니다. 이렇게 하면 진행률 표시줄이 선택 윤곽 표시와 유사하게 가로로 스크롤됩니다. 진행 중이지만 작업에 필요한 시간을 알 수 없음을 나타내려면 이 작업을 사용합니다.

PROGDLG_NOCANCEL

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

pvResevered

형식: LPCVOID

예약되어 있습니다. NULL로 설정합니다.

반환 값

형식: HRESULT

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

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional, Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	shlobj_core.h
DLL	Shell32.dll(버전 5.0 이상)

추가 정보

IProgressDialog

다음을 통해 공유