IActionProgress::UpdateText 메서드(shobjidl_core.h)

작업과 연결된 설명 텍스트가 변경되면 호출됩니다.

구문

HRESULT UpdateText(
  [in] SPTEXT  sptext,
  [in] LPCWSTR pszText,
  [in] BOOL    fMayCompact
);

매개 변수

[in] sptext

형식: SPTEXT

표시되는 텍스트의 형식을 지정하는 값입니다. 허용되는 값 은 SPTEXT 를 참조하세요.

[in] pszText

형식: LPCWSTR

표시할 와이드 문자열에 대한 포인터입니다.

[in] fMayCompact

형식: BOOL

화면의 사용 가능한 공간에 맞게 텍스트 문자열을 압축할 수 있는지 여부를 지정하는 값입니다.

반환 값

형식: HRESULT

성공하면 S_OK 반환하거나, 그렇지 않으면 오류 값을 반환합니다.

설명

이 메서드를 구현하는 클래스는 수행 중인 작업의 컨텍스트에서 sptext 및 fMayCompact 의 값과 사용자에게 진행률을 보여 주는 UI를 해석해야 합니다. sptext 값을 사용하여 변경 가능한 텍스트 줄을 구분할 수 있습니다. 종종 fMayCompact 값은 화면 공간을 절약하기 위해 텍스트 문자열을 줄임표(...)로 잘라낼 수 있는지 여부를 나타냅니다.

요구 사항

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

추가 정보

IActionProgress

SPTEXT