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

진행률 대화 상자에 메시지를 표시합니다.

구문

HRESULT SetLine(
       DWORD   dwLineNum,
  [in] PCWSTR  pwzString,
       BOOL    fCompactPath,
       LPCVOID pvResevered
);

매개 변수

dwLineNum

형식:DWORD

텍스트를 표시할 줄 번호입니다. 현재 1, 2, 3의 세 줄이 있습니다. IProgressDialog::StartProgressDialog가 호출될 때 PROGDLG_AUTOTIME 플래그가 dwFlags 매개 변수에 포함된 경우 1줄과 2줄만 사용할 수 있습니다. 예상 시간은 3줄에 표시됩니다.

[in] pwzString

형식: PCWSTR

텍스트를 포함하는 null로 끝나는 유니코드 문자열입니다.

fCompactPath

형식: BOOL

TRUE 이면 경로 문자열이 너무 커서 줄에 맞지 않는 경우 압축됩니다. 경로는 PathCompactPath로 압축됩니다.

pvResevered

형식: LPCVOID

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

반환 값

형식: HRESULT

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

설명

이 함수는 일반적으로 "Item XXX가 현재 처리 중입니다."와 같은 메시지를 표시하는 데 사용됩니다. 일반적으로 메시지는 예상 시간 동안 예약된 줄 3과 함께 1줄과 2줄에 표시됩니다.

요구 사항

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

추가 정보

IProgressDialog