Share via

Metodo IOleWindow::GetWindow (oleidl.h)

  • Articolo

Recupera un handle in una delle finestre che partecipano all'attivazione sul posto (cornice, documento, padre o finestra oggetto sul posto).

Sintassi

HRESULT GetWindow(
  [out] HWND *phwnd
);

Parametri

[out] phwnd

Puntatore a una variabile che riceve l'handle della finestra.

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_FAIL
 L'oggetto è senza finestra.
E_INVALIDARG
 Il valore fEnterMode specificato non è valido.
E_OUTOFMEMORY
 Memoria insufficiente per questa operazione.
E_UNEXPECTED
 Si è verificato un errore imprevisto.

Commenti

Cinque tipi di finestre comprendono la gerarchia delle finestre. Quando un oggetto è attivo sul posto, ha accesso ad alcune o a tutte queste finestre.

Finestra Descrizione
Frame Finestra principale più esterna in cui si trova il menu principale dell'applicazione contenitore.
Documento Finestra che visualizza il documento composto contenente l'oggetto incorporato all'utente.
Riquadro Sottofinestra della finestra del documento che contiene la visualizzazione dell'oggetto. Applicabile solo per le applicazioni con finestre a riquadri separati.
Parent Finestra contenitore contenente la visualizzazione dell'oggetto. L'applicazione oggetto installa la relativa finestra come elemento figlio di questa finestra.
Sul posto Finestra contenente l'oggetto attivo sul posto. L'applicazione oggetto crea questa finestra e la installa come elemento figlio della finestra del tratteggio, figlio della finestra padre del contenitore.
 

Ogni tipo di finestra ha un ruolo diverso nell'architettura di attivazione sul posto. Tuttavia, non è necessario utilizzare una finestra fisica separata per ogni tipo. Molte applicazioni contenitore usano la stessa finestra per la cornice, il documento, il riquadro e le finestre padre.

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

IOleWindow