IViewObjectEx::GetViewStatus 메서드(ocidl.h)

개체의 불투명도 및 지원되는 그리기 측면에 대한 정보를 검색합니다.

구문

HRESULT GetViewStatus(
  [out] DWORD *pdwStatus
);

매개 변수

[out] pdwStatus

뷰 상태 대한 포인터입니다. 이 정보는 VIEWSTATUS 열거형 값의 조합으로 반환됩니다.

반환 값

이 메서드는 성공에 대한 S_OK 반환합니다.

설명

그리기 프로세스를 최적화하기 위해 컨테이너는 개체가 불투명한지 여부와 견고한 배경이 있는지 여부를 확인할 수 있어야 합니다. 완전히 불투명한 개체로 완전히 적용되는 개체를 다시 그릴 필요는 없습니다. 예를 들어 스크롤과 같은 다른 작업은 개체가 불투명하고 견고한 배경이 있는 경우에도 고도로 최적화할 수 있습니다.

IViewObjectEx::GetViewStatus 메서드는 개체가 완전히 불투명(VIEWSTATUS_OPAQUE 비트)인지 여부와 배경이 단색인지(VIEWSTATUS_SOLIDBKGND 비트)를 반환합니다. 이 정보는 시간에 따라 변경 될 수 있습니다. 개체는 지정된 시간에 불투명할 수 있으며 나중에 BackStyle 속성의 변경으로 인해 완전히 또는 부분적으로 투명해질 수 있습니다. 개체는 IAdviseSinkEx::OnViewStatusChange 를 사용하여 변경되면 사이트에 알리므로 사이트에서 빠른 액세스를 위해 이 정보를 캐시할 수 있습니다.

IViewObjectEx를 지원하지 않는 개체는 항상 투명한 것으로 간주됩니다.

IViewObjectEx::GetViewStatus 메서드는 지원되는 측면을 나타내는 비트 조합도 반환합니다.

지정된 그리기 측면이 지원되지 않는 경우 그리기 측면을 입력 매개 변수로 사용하는 모든 IViewObjectEx 메서드가 실패하고 E_INVALIDARG 반환해야 합니다. IViewObjectEx::GetViewStatus 메서드를 사용하면 컨테이너가 한 번의 빠른 호출로 모든 그리기 측면에 대한 정보를 다시 가져올 수 있습니다. 일반적으로 지원되는 그리기 측면 집합은 시간에 따라 변경되지 않아야 합니다. 그러나 그렇지 않은 경우 개체는 IAdviseSinkEx::OnViewStatusChange를 사용하여 컨테이너에 알려야 합니다.

지원되는 그리기 측면은 개체가 불투명하거나 부분적으로 투명하거나 완전히 투명한지와 무관합니다. 특히 DVASPECT_TRANSPARENT 지원하지 않는 투명 개체는 DVASPECT_CONTENT 사용하여 백투트 프런트 패스 중에 올바르게 그려야 합니다. 그러나 이로 인해 깜박임이 더 발생할 수 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	ocidl.h

추가 정보

IAdviseSinkEx::OnViewStatusChange

IViewObjectEx

VIEWSTATUS