다음을 통해 공유


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 반환합니다. 다른 가능한 반환 값은 다음과 같습니다.

반환 코드 설명
VIEW_S_ALREADY_FROZEN
프레젠테이션이 이미 고정되었습니다. pdwFreeze 값은 이미 고정된 개체의 식별 키입니다.
OLE_E_BLANK
프레젠테이션이 캐시에 없습니다.
DV_E_LINDEX
lindex의 값이 잘못되었습니다. 현재; -1만 지원됩니다.
DV_E_DVASPECT
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

추가 정보

DVASPECT

IViewObject

IViewObject::Unfreeze