Método IOleInPlaceUIWindow::SetActiveObject (oleidl.h)

Proporciona un canal directo de comunicación entre el objeto y cada una de las ventanas de marco y documento.

Sintaxis

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

Parámetros

[in] pActiveObject

Puntero a la interfaz IOleInPlaceActiveObject del objeto activo en contexto.

[in] pszObjName

Puntero a una cadena que contiene un nombre que describe el objeto que un contenedor de inserción puede usar para componer su título de ventana. Puede ser NULL si el objeto no requiere que el contenedor cambie sus títulos de ventana. Los contenedores deben omitir este parámetro y usar siempre su propio nombre en la barra de título.

Valor devuelto

Este método devuelve S_OK cuando funciona correctamente. Otros posibles valores devueltos son los siguientes.

Código devuelto	Descripción
E_UNEXPECTED	Se produjo un error inesperado.

Comentarios

Por lo general, un objeto incrustado debe pasar NULL para el parámetro pszObjName (vea Notas a los implementadores a continuación). Sin embargo, si está trabajando junto con un contenedor que muestra el nombre del objeto activo en contexto en su barra de título, debe crear una cadena en el siguiente formato: <nombre> de aplicación : <nombre de objeto de> tipo corto.

Notas a los autores de llamadas

El objeto llama a IOleInPlaceUIWindow::SetActiveObject para establecer un vínculo de comunicación directa entre sí mismo y las ventanas de marco y documento.

Cuando se desactiva, el objeto llama a IOleInPlaceUIWindow::SetActiveObject, pasando NULL para los parámetros pActiveObject y pszObjName.

Un objeto debe llamar a IOleInPlaceUIWindow::SetActiveObject antes de llamar a IOleInPlaceFrame::SetMenu para proporcionar al contenedor el puntero al objeto activo. A continuación, el contenedor usa este puntero en el procesamiento de IOleInPlaceFrame::SetMenu y para pasar a OleSetMenuDescriptor.

Notas para los implementadores

La Guía de diseño de la interfaz de usuario de Microsoft Windows recomienda que un contenedor local omita el parámetro pszObjName pasado en este método. La guía indica que la barra de título no se ve afectada por la activación local. Siempre muestra el nombre del contenedor de nivel superior".

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	oleidl.h

Consulte también

IOleInPlaceFrame::SetMenu

IOleInPlaceUIWindow

OleSetMenuDescriptor