Método IOleInPlaceSite::GetWindowContext (oleidl.h)

Permite que un objeto local recupere las interfaces de ventana que forman la jerarquía de objetos de ventana y la posición en la ventana primaria donde se debe ubicar la ventana de activación local del objeto.

Sintaxis

HRESULT GetWindowContext(
  [out]     IOleInPlaceFrame      **ppFrame,
  [out]     IOleInPlaceUIWindow   **ppDoc,
  [out]     LPRECT                lprcPosRect,
  [out]     LPRECT                lprcClipRect,
  [in, out] LPOLEINPLACEFRAMEINFO lpFrameInfo
);

Parámetros

[out] ppFrame

Puntero a una variable de puntero IOleInPlaceFrame que recibe el puntero de interfaz al marco. Si se produce un error, la implementación debe establecer ppFrame en NULL.

[out] ppDoc

Puntero a una variable de puntero IOleInPlaceUIWindow que recibe el puntero de interfaz a la ventana del documento. Si la ventana del documento es la misma que la ventana de marco, ppDoc se establece en NULL. En este caso, el objeto solo puede usar ppFrame o negociación de borde. Si se devuelve un error, la implementación debe establecer ppDoc en NULL.

[out] lprcPosRect

Puntero a una estructura RECT para el rectángulo que contiene la posición del objeto en contexto en las coordenadas del cliente de su ventana primaria. Si se devuelve un error, este parámetro debe establecerse en NULL.

[out] lprcClipRect

Puntero a una estructura RECT para el rectángulo externo que contiene el rectángulo de posición del objeto en contexto (lprcPosRect). Este rectángulo es relativo al área cliente de la ventana primaria del objeto. Si se devuelve un error, este parámetro debe establecerse en NULL.

[in, out] lpFrameInfo

Puntero a una estructura OLEINPLACEFRAMEINFO que el contenedor debe rellenar con los datos adecuados. Si se devuelve un error, este parámetro debe establecerse en NULL.

Valor devuelto

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

Código devuelto	Descripción
E_INVALIDARG	Uno o varios de los punteros proporcionados no son válidos.
E_UNEXPECTED	Se produjo un error inesperado.

Comentarios

La estructura OLEINPLACEFRAMEINFO proporciona datos necesarios por OLE para enviar aceleradores de pulsaciones de teclas a un marco de contenedor mientras un objeto está activo en su lugar.

Cuando se activa un objeto, llama a GetWindowContext desde su contenedor. El contenedor devuelve el identificador a su tabla de aceleradores en contexto a través de la estructura OLEINPLACEFRAMEINFO . Antes de llamar a GetWindowContext, el objeto debe proporcionar el tamaño de la estructura OLEINPLACEFRAMEINFO rellenando el miembro cb, al que apunta lpFrameInfo.

Requisitos

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

IOleInPlaceSite