IOleInPlaceUIWindow::SetActiveObject 메서드(oleidl.h)

아티클
03/05/2024

개체와 각 프레임 및 문서 창 간의 직접 통신 채널을 제공합니다.

구문

HRESULT SetActiveObject(
  [in] IOleInPlaceActiveObject *pActiveObject,
  [in] LPCOLESTR               pszObjName
);

매개 변수

[in] pActiveObject

현재 위치 개체의 IOleInPlaceActiveObject 인터페이스에 대한 포인터입니다.

[in] pszObjName

포함 컨테이너가 창 제목을 작성하는 데 사용할 수 있는 개체를 설명하는 이름을 포함하는 문자열에 대한 포인터입니다. 개체에 컨테이너가 창 제목을 변경할 필요가 없는 경우 NULL 일 수 있습니다. 컨테이너는 이 매개 변수를 무시하고 항상 제목 표시줄에서 자신의 이름을 사용해야 합니다.

반환 값

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

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

설명

일반적으로 포함된 개체는 pszObjName 매개 변수에 대해 NULL을 전달해야 합니다(아래 구현자에 대한 참고 사항 참조). 그러나 제목 표시줄에 현재 위치 활성 개체의 이름을 표시하는 컨테이너와 함께 작업하는 경우 애플리케이션 이름> – <개체 짧은 형식 이름> 형식 < 의 문자열을 작성해야 합니다.

발신자에게 참고 사항

IOleInPlaceUIWindow::SetActiveObject 는 개체에서 호출되어 자체와 문서 및 프레임 창 간에 직접 통신 링크를 설정합니다.

비활성화할 때 개체는 IOleInPlaceUIWindow::SetActiveObject를 호출하여 pActiveObject 및 pszObjName 매개 변수에 대해 NULL을 전달합니다.

개체는 IOleInPlaceFrame::SetMenu를 호출하기 전에 IOleInPlaceUIWindow::SetActiveObject를 호출하여 컨테이너에 활성 개체에 대한 포인터를 제공해야 합니다. 그런 다음 컨테이너는 IOleInPlaceFrame::SetMenu 를 처리하는 데 이 포인터를 사용하고 OleSetMenuDescriptor에 전달합니다.

구현자에 대한 참고 사항

Microsoft Windows 사용자 인터페이스 디자인 가이드에서는 현재 위치 컨테이너가 이 메서드에 전달된 pszObjName 매개 변수를 무시하는 것이 좋습니다. 가이드는 "제목 표시줄은 현재 위치 활성화의 영향을 받지 않습니다. 항상 최상위 컨테이너의 이름이 표시됩니다."

요구 사항

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