IOleDocumentView::UIActivate 메서드(docobj.h)

아티클
08/23/2023

메뉴, 도구 모음 및 액셀러레이터와 같은 문서 보기의 사용자 인터페이스 요소를 활성화하거나 비활성화합니다.

구문

HRESULT UIActivate(
  [in] BOOL fUIActivate
);

매개 변수

[in] fUIActivate

TRUE이면 보기는 사용자 인터페이스를 활성화하는 것입니다. FALSE이면 보기는 해당 사용자 인터페이스를 비활성화하는 것입니다.

반환 값

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

반환 코드	설명
E_FAIL	작업이 실패했습니다.
E_OUTOFMEMORY	작업에 사용할 수 있는 메모리가 부족합니다.
E_UNEXPECTED	예기치 않은 오류가 발생했습니다.

설명

발신자에게 참고 사항

IOleDocumentView::SetInPlaceSite를 호출하기 전에 이 메서드를 호출하면 보기가 자체 활성화되기 전에 보기 사이트와 연결되어야 하므로 E_UNEXPECTED 반환됩니다.

IOleDocumentView::UIActivate가 활성화 시퀀스의 일부로 호출되면 호출이 IOleDocumentView::SetRect 또는 IOleDocumentView::SetRectComplex 호출 앞에 와야 합니다. 그렇지 않으면 뷰 차원이 도구 모음 공간을 고려하지 않기 때문입니다.

보기를 비활성화하려면 컨테이너가 IOleDocumentView::Show with FALSE를 호출한 다음 , IOleDocumentView::UIActivate with FALSE를 호출해야 합니다.

구현자에 대한 참고 사항

이 메서드의 구현은 다음 의사 코드를 구현해야 합니다.

if (fActivate)
    {
    UI activate the view (do menu merging, show frame level tools, process accelerators)
    Take focus, and bring the view window forward.
    }
else
    call IOleInPlaceObject::UIDeactivate on this view

또한 보기는 확장 도움말 메뉴 병합에 참여할 수 있고 참여해야 합니다.

문서 개체의 모든 보기는 현재 위치 활성화를 지원해야 합니다. E_NOTIMPL 허용되는 반환 값이 아닙니다.

요구 사항


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