IOleInPlaceUIWindow::SetActiveObject 메서드(oleidl.h)
개체와 각 프레임 및 문서 창 간의 직접 통신 채널을 제공합니다.
구문
HRESULT SetActiveObject(
[in] IOleInPlaceActiveObject *pActiveObject,
[in] LPCOLESTR pszObjName
);
매개 변수
[in] pActiveObject
현재 위치 개체의 IOleInPlaceActiveObject 인터페이스에 대한 포인터입니다.
[in] pszObjName
포함 컨테이너가 창 제목을 작성하는 데 사용할 수 있는 개체를 설명하는 이름을 포함하는 문자열에 대한 포인터입니다. 개체에 컨테이너가 창 제목을 변경할 필요가 없는 경우 NULL 일 수 있습니다. 컨테이너는 이 매개 변수를 무시하고 항상 제목 표시줄에서 자신의 이름을 사용해야 합니다.
반환 값
이 메서드는 성공에 대한 S_OK 반환합니다. 다른 가능한 반환 값은 다음과 같습니다.
| 반환 코드 | 설명 |
|---|---|
|
예기치 않은 오류가 발생했습니다. |
설명
일반적으로 포함된 개체는 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 |