IOleInPlaceObject::UIDeactivate 메서드(oleidl.h)

아티클
03/05/2024

활성 현재 위치 개체의 사용자 인터페이스를 비활성화하고 제거합니다.

구문

HRESULT UIDeactivate();

반환 값

이 메서드는 성공에 대한 S_OK 반환합니다. 다른 가능한 반환 값은 다음과 같습니다.

반환 코드	설명
E_UNEXPECTED	예기치 않은 오류가 발생했습니다.

설명

발신자에게 참고 사항

예를 들어 사용자가 개체 외부의 클라이언트 영역을 클릭했을 때 개체의 직접 컨테이너에서 이 메서드를 호출합니다.

컨테이너가 IOleInPlaceObject::UIDeactivate를 호출한 경우 나중에 IOleInPlaceObject::InPlaceDeactivate를 호출하여 리소스를 제대로 클린 합니다. 컨테이너는 개체를 중지하거나 해제하면 필요한 경우 리소스가 정리된다고 가정할 수 있습니다. IOleInPlaceObject::InPlaceDeactivate가 호출되지 않은 경우 개체를 준비해야 합니다. 그러나 IOleInPlaceObject::UIDeactivate 또는 IOleObject::Close 가 호출되었습니다.

구현자에 대한 참고 사항

IOleInPlaceObject::InPlaceDeactivate 또는 IOleObject::Close를 호출하여 개체가 완전히 비활성화될 때까지 메뉴 및 창과 같은 리소스를 정리하거나 숨겨진 상태로 유지할 수 있습니다. 컨테이너를 프레임 창에서 먼저 분리할 수 있도록 개체 애플리케이션은 복합 메뉴로 작업을 수행하기 전에 IOleInPlaceSite::OnUIDeactivate 를 호출해야 합니다. 현재 위치 개체의 사용자 인터페이스를 비활성화하면 개체가 준비 상태로 유지되므로 빠르게 다시 활성화할 수 있습니다. 개체는 문서의 실행 취소 상태가 변경될 때까지 이 상태로 유지됩니다. 그런 다음 컨테이너는 IOleInPlaceObject::InPlaceDeactivate 를 호출하여 개체에 실행 취소 상태를 취소하도록 지시해야 합니다.

요구 사항

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