Metodo IOleDocumentView::Open (docobj.h)
Visualizza una visualizzazione documento in una finestra popup separata. La semantica equivale a IOleObject::D oVerb con OLEIVERB_OPEN.
Sintassi
HRESULT Open();
Valore restituito
Questo metodo restituisce S_OK se l'operazione ha esito positivo. Gli altri valori restituiti possibili includono i seguenti:
| Codice restituito | Descrizione |
|---|---|
|
Operazione non riuscita. |
|
Memoria insufficiente disponibile per l'operazione. |
|
Si è verificato un errore imprevisto. |
|
L'oggetto documento proprietario di questa visualizzazione non supporta l'attivazione separata della finestra. |
Commenti
Un utente che visualizza un oggetto documento in un'applicazione contenitore, ad esempio un browser o un "binder", può voler visualizzare due o più visualizzazioni o documenti contemporaneamente. Poiché il browser visualizza una sola visualizzazione alla volta, il contenitore richiede un modo per chiedere alle altre visualizzazioni o ai documenti di visualizzarsi, come richiesto, in finestre separate. Il metodo IOleDocumentView::Open fornisce questo modo.
Note ai chiamanti
Una chiamata a IOleDocumentView::Open deve essere seguita da una chiamata a IOleDocumentView::Show per nascondere la finestra o per visualizzare la finestra e portarla in primo piano. Mentre la visualizzazione è attiva nella finestra separata, un contenitore può visualizzare o nascondere la finestra tutte le volte che potrebbe essere necessaria.Note per gli implementatori
Un oggetto documento indica che non supporta l'attivazione in una finestra separata impostando il flag di stato DOCMISC_CANTOPENEDIT e restituendo E_NOTIMPL ai contenitori che chiamano questo metodo.L'implementazione è costituita principalmente dall'oggetto view che chiama il proprio metodo IOleInPlaceObject::InPlaceDeactivate , che lascia l'oggetto documento in uno stato di esecuzione ma senza attivazione sul posto. L'interfaccia utente dell'oggetto documento non è visibile fino a quando il contenitore chiama IOleDocumentView::Show (vedere Note ai chiamanti sopra).
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | docobj.h |