IViewObject::Freeze 메서드(oleidl.h)
IViewObject::Unfreeze 메서드가 호출될 때까지 개체가 변경되지 않도록 개체의 그리기 표현을 고정합니다. 이 메서드의 가장 일반적인 용도는 묶은 인쇄입니다.
구문
HRESULT Freeze(
[in] DWORD dwDrawAspect,
[in] LONG lindex,
[in] void *pvAspect,
[out] DWORD *pdwFreeze
);
매개 변수
[in] dwDrawAspect
개체를 표현할 방법을 지정합니다. 표현에는 콘텐츠, 아이콘, 썸네일 또는 인쇄된 문서가 포함됩니다. 유효한 값은 열거형 DVASPECT에서 가져옵니다. 자세한 내용은 DVASPECT 열거형을 참조하세요.
[in] lindex
그리기 작업의 대상인 개체의 부분입니다. 해석은 dwAspect에 따라 다릅니다. 자세한 내용은 DVASPECT 열거형을 참조하세요.
[in] pvAspect
dwAspect에 지정된 개체의 뷰에 대한 추가 정보에 대한 포인터입니다. 현재 측면 중 어느 것도 추가 정보를 지원하지 않으므로 pvAspect 는 항상 NULL이어야 합니다.
[out] pdwFreeze
식별 DWORD 키가 반환되는 위치에 대한 포인터입니다. 이 고유 키는 나중에 IViewObject::Unfreeze를 호출하여 고정을 취소하는 데 사용됩니다. 이 키는 기본 캐시가 고정된 개체를 추적하는 데 사용하는 인덱스입니다.
반환 값
이 메서드는 성공에 대한 S_OK 반환합니다. 다른 가능한 반환 값은 다음과 같습니다.
반환 코드 | 설명 |
---|---|
|
프레젠테이션이 이미 고정되었습니다. pdwFreeze 값은 이미 고정된 개체의 식별 키입니다. |
|
프레젠테이션이 캐시에 없습니다. |
|
lindex의 값이 잘못되었습니다. 현재; -1만 지원됩니다. |
|
dwAspect의 값이 잘못되었습니다. |
설명
IViewObject::Freeze 메서드를 사용하면 IViewObject::Unfreeze에 대한 후속 호출이 해제될 때까지 뷰 개체가 그린 표현을 고정합니다. IViewObject::Freeze를 호출한 후 동일한 매개 변수를 사용하여 IViewObject::D raw에 대한 연속 호출은 IViewObject::Unfreeze가 호출될 때까지 동일한 그림을 생성합니다.
IViewObject::Freeze 는 개체의 영구 상태에 속하지 않으며 개체의 언로드 및 다시 로드에서 계속되지 않습니다.
이 메서드의 가장 일반적인 용도는 묶은 인쇄입니다.
고정 상태인 동안에는 보기 알림이 전송되지 않습니다. 보류 중인 보기 알림은 IViewObject::Unfreeze에 대한 후속 호출로 지연됩니다.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
대상 플랫폼 | Windows |
헤더 | oleidl.h |