Metodo IOleInPlaceSite::GetWindowContext (oleidl.h)

Articolo
08/25/2023

Consente a un oggetto sul posto di recuperare le interfacce finestra che formano la gerarchia degli oggetti finestra e la posizione nella finestra padre in cui deve essere posizionata la finestra di attivazione sul posto dell'oggetto.

Sintassi

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

Parametri

[out] ppFrame

Puntatore a una variabile puntatore IOleInPlaceFrame che riceve il puntatore dell'interfaccia al frame. Se si verifica un errore, l'implementazione deve impostare ppFrame su NULL.

[out] ppDoc

Puntatore a una variabile puntatore IOleInPlaceUIWindow che riceve il puntatore di interfaccia alla finestra del documento. Se la finestra del documento è uguale alla finestra cornice, ppDoc è impostato su NULL. In questo caso, l'oggetto può usare solo ppFrame o negoziazione border. Se viene restituito un errore, l'implementazione deve impostare ppDoc su NULL.

[out] lprcPosRect

Puntatore a una struttura RECT per il rettangolo contenente la posizione dell'oggetto sul posto nelle coordinate client della relativa finestra padre. Se viene restituito un errore, questo parametro deve essere impostato su NULL.

[out] lprcClipRect

Puntatore a una struttura RECT per il rettangolo esterno contenente il rettangolo di posizione dell'oggetto sul posto (lprcPosRect). Questo rettangolo è relativo all'area client della finestra padre dell'oggetto. Se viene restituito un errore, questo parametro deve essere impostato su NULL.

[in, out] lpFrameInfo

Un puntatore a una struttura OLEINPLACEFRAMEINFO il contenitore deve inserire i dati appropriati. Se viene restituito un errore, questo parametro deve essere impostato su NULL.

Valore restituito

Questo metodo restituisce S_OK se l'operazione ha esito positivo. Gli altri valori restituiti possibili includono i seguenti:

Codice restituito	Descrizione
E_INVALIDARG	Uno o più puntatori forniti non sono validi.
E_UNEXPECTED	Si è verificato un errore imprevisto.

Commenti

La struttura OLEINPLACEFRAMEINFO fornisce i dati necessari a OLE per inviare i tasti di scelta rapida a un frame del contenitore mentre un oggetto è attivo sul posto.

Quando un oggetto viene attivato, chiama GetWindowContext dal relativo contenitore. Il contenitore restituisce l'handle alla tabella dell'acceleratore sul posto tramite la struttura OLEINPLACEFRAMEINFO . Prima di chiamare GetWindowContext, l'oggetto deve fornire le dimensioni della struttura OLEINPLACEFRAMEINFO compilando il membro cb, a cui punta lpFrameInfo.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	oleidl.h

Vedi anche

IOleInPlaceSite

Condividi tramite