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 |