IOleInPlaceActiveObject::OnDocWindowActivate 메서드(oleidl.h)

아티클
03/01/2024

컨테이너의 문서 창이 활성화되거나 비활성화되면 현재 위치 개체에 알립니다.

구문

HRESULT OnDocWindowActivate(
  [in] BOOL fActivate
);

매개 변수

[in] fActivate

MDI 자식 문서 창의 상태입니다. 이 매개 변수가 TRUE이면 창이 활성화 동작에 있습니다. FALSE이면 비활성화하는 작업입니다.

반환 값

이 메서드는 성공에 대한 S_OK 반환합니다.

설명

발신자에게 참고 사항

MDI 자식 문서 창이 활성화되거나 비활성화되고 개체가 현재 문서의 활성 개체인 경우 IOleInPlaceActiveObject::OnDocWindowActivate 를 호출합니다.

구현자에 대한 참고 사항

개체를 활성화하는 동안 프레임 수준 도구를 설치하는 코드를 이 메서드에 포함해야 합니다. 이러한 도구에는 공유 복합 메뉴 및/또는 선택적 도구 모음 및 프레임 장식이 포함됩니다. 그런 다음 초점을 맞추어야 합니다. 비활성화할 때 개체는 프레임 수준 도구를 제거해야 합니다. pborderwidths가 NULL로 설정된 IOleInPlaceUIWindow::SetBorderSpace를 호출하지 않으면 테두리 공간을 재협상할 필요가 없습니다.

IOleInPlaceActiveObject::OnDocWindowActivate를 실행하는 동안 PeekMessage 또는 GetMessage 함수 또는 대화 상자를 호출하지 마세요. 이렇게 하면 시스템이 교착 상태에 빠질 수 있습니다. IOleInPlaceActiveObject::OnDocWindowActivate 내에서 OLE 인터페이스 메서드 및 함수를 호출할 수 있는 추가 제한 사항이 있습니다.

요구 사항

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