Metodo IOleWindow::GetWindow (oleidl.h)
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 |
|---|---|
|
L'oggetto è senza finestra. |
|
Il valore fEnterMode specificato non è valido. |
|
Memoria insufficiente per questa operazione. |
|
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 |