IConsole2::SetStatusText 메서드(mmc.h)

IConsole2::SetStatusText 메서드를 사용하면 스냅인에서 상태 표시줄의 텍스트를 변경할 수 있습니다. IComponent 인스턴스에서만 사용됩니다.

구문

HRESULT SetStatusText(
  [in] LPOLESTR pszStatusText
);

매개 변수

[in] pszStatusText

상태 표시줄에 표시할 텍스트가 포함된 null로 끝나는 문자열에 대한 포인터입니다.

반환 값

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

설명

상태 막대에는 파이프 문자(|)로 구분된 세 개의 섹션이 있습니다. 예를 들어 상태 막대의 텍스트를 "Left| 중간| 오른쪽"은 상태 막대의 왼쪽 섹션에 "왼쪽", 가운데 섹션의 "가운데", 오른쪽 섹션의 "오른쪽"을 배치합니다.

세 개 이상의 필드(즉, 파이프가 두 개 이상 있음)가 표시되면 네 번째 및 상위 필드에 배치되는 모든 필드가 생략됩니다.

또한 중간 섹션은 진행률 표시줄로 작동하도록 설계되었습니다. 이 기능은 '%' 문자를 첫 번째 문자로 전달한 다음 0에서 100 사이의 숫자를 가운데 섹션에 전달하여 호출됩니다. 텍스트 대신 이 섹션은 0~100% 완료된 진행률 표시줄을 표시합니다. 예를 들어 "Done|%75"를 전달하면 왼쪽 섹션에 "완료"가 배치되고 중간 섹션에서 진행률 표시줄이 75% 완료됩니다.

상태 막대의 가운데 섹션에 '%'로 시작하는 문자열을 표시하려면 '%%'로 문자열을 시작합니다. 이렇게 하면 중간 섹션에 텍스트가 표시되고 첫 번째 '%'가 제거됩니다. 예를 들어 "Today is|%%Wednesday%"는 왼쪽 섹션에 "Today is"가 포함되고 중간 섹션에는 "%Wednesday%"가 포함됩니다. '%' 다음에 중간 섹션에 잘못된 숫자 또는 숫자가 아닌 텍스트를 입력하면 가운데 섹션이 비어 있습니다. '%'이(가) 섹션의 유일한 문자인 경우 텍스트로 표시됩니다.

이 메서드는 IComponent를 통해 가져온 IConsole2 인터페이스 포인터에서 호출해야 합니다.

현재 선택한 scope 항목을 소유하는 스냅인만 상태 막대 텍스트를 변경할 수 있습니다.

MMC 버전 1.1 이상에서는 각 MDI(다중 문서 인터페이스) 자식 창에 상태 막대가 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista
지원되는 최소 서버	Windows Server 2008
대상 플랫폼	Windows
헤더	mmc.h
DLL	Mmcndmgr.dll

추가 정보

IConsole2