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

Permite que um objeto in-loco recupere as interfaces de janela que formam a hierarquia de objetos de janela e a posição na janela pai em que a janela de ativação in-loco do objeto deve estar localizada.

Sintaxe

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

Parâmetros

[out] ppFrame

Um ponteiro para uma variável de ponteiro IOleInPlaceFrame que recebe o ponteiro da interface para o quadro. Se ocorrer um erro, a implementação deverá definir ppFrame comoNULL.

[out] ppDoc

Um ponteiro para uma variável de ponteiro IOleInPlaceUIWindow que recebe o ponteiro de interface para a janela do documento. Se a janela do documento for igual à janela de quadro, ppDoc será definido como NULL. Nesse caso, o objeto só pode usar ppFrame ou negociação de borda. Se um erro for retornado, a implementação deverá definir ppDoc como NULL.

[out] lprcPosRect

Um ponteiro para uma estrutura RECT para o retângulo que contém a posição do objeto in-loco nas coordenadas do cliente de sua janela pai. Se um erro for retornado, esse parâmetro deverá ser definido como NULL.

[out] lprcClipRect

Um ponteiro para uma estrutura RECT para o retângulo externo que contém o retângulo de posição do objeto in-loco (lprcPosRect). Esse retângulo é relativo à área do cliente da janela pai do objeto. Se um erro for retornado, esse parâmetro deverá ser definido como NULL.

[in, out] lpFrameInfo

Um ponteiro para uma estrutura OLEINPLACEFRAMEINFO que o contêiner deve preencher com os dados apropriados. Se um erro for retornado, esse parâmetro deverá ser definido como NULL.

Valor retornado

Esse método retorna S_OK com êxito. Outros valores retornados possíveis incluem o seguinte.

Código de retorno	Descrição
E_INVALIDARG	Um ou mais ponteiros fornecidos são inválidos.
E_UNEXPECTED	Ocorreu um erro inesperado.

Comentários

A estrutura OLEINPLACEFRAMEINFO fornece dados necessários ao OLE para expedir aceleradores de pressionamento de tecla para um quadro de contêiner enquanto um objeto está ativo no local.

Quando um objeto é ativado, ele chama GetWindowContext de seu contêiner. O contêiner retorna o identificador para sua tabela de acelerador in-loco por meio da estrutura OLEINPLACEFRAMEINFO . Antes de chamar GetWindowContext, o objeto deve fornecer o tamanho da estrutura OLEINPLACEFRAMEINFO preenchendo o membro cb, apontado por lpFrameInfo.

Requisitos

Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	oleidl.h

Confira também

Ioleinplacesite