Metodo IOleDocumentSite::ActivateMe (docobj.h)
Chiede a un sito documento di attivare il documento che effettua la chiamata come oggetto documento anziché a un oggetto attivo sul posto e, facoltativamente, specifica la visualizzazione del documento oggetto da attivare.
Sintassi
HRESULT ActivateMe(
[in] IOleDocumentView *pViewToActivate
);
Parametri
[in] pViewToActivate
Puntatore a un puntatore all'interfaccia IOleDocumentView che rappresenta la visualizzazione documento da usare per attivare l'oggetto documento. Questo parametro può essere NULL, nel qual caso il contenitore deve chiamare IOleDocument::CreateView per ottenere un puntatore di visualizzazione documento.
Valore restituito
Questo metodo restituisce S_OK se l'operazione ha esito positivo.
Commenti
Quando un contenitore chiama IOleObject::D oVerb per attivare un documento, un oggetto documento ignora la normale sequenza di attivazione sul posto chiamando IOleDocumentSite::ActivateMe.
Quando si chiama IOleObject::D oVerb in un oggetto documento, il verbo di attivazione più appropriato è in genere OLEIVERB_SHOW. Altri verbi consentiti includono OLEIVERB_PRIMARY e OLEIVERB_UIACTIVATE. OLEIVERB_OPEN è sconsigliato perché significa aprire un oggetto incorporato in una finestra separata, che è contrario alla finalità dell'attivazione dell'oggetto documento.
Note ai chiamanti
Solo gli oggetti documento devono chiamare questo metodo. Un normale documento attivo sul posto deve rispondere alla chiamata di un contenitore a IOleObject::D oVerb chiamando IOleInPlaceSite.Un oggetto documento deve avviare l'attivazione chiamando IOleDocumentSite::ActivateMe. Se il contenitore non implementa IOleDocumentSite, il documento deve essere predefinito nella normale sequenza di attivazione sul posto.
Un oggetto documento che supporta più visualizzazioni dei dati può specificare quale visualizzazione attivare passando un puntatore all'interfaccia IOleDocumentView della visualizzazione in pViewToActivate.
Tuttavia, il puntatore IOleDocumentView viene ottenuto, il contenitore deve rilasciare il puntatore quando non è più necessario.
Note per gli implementatori
Questa funzione deve essere completamente implementata in un contenitore di oggetti documento; E_NOTIMPL non è un valore restituito accettabile.Se un oggetto documento passa un puntatore IOleDocumentView in pViewToActivate, l'implementazione del contenitore di IOleDocumentSite::ActivateMe deve chiamare IOleDocumentView::SetInPlaceSite e passare un puntatore alla relativa interfaccia IOleInPlaceSite all'oggetto view. Se il contenitore tiene premuto il puntatore IOleDocumentView , che normalmente sarà il caso, deve seguire la chiamata a IOleDocumentView::SetInPlaceSite con una chiamata a IUnknown::AddRef.
Se pViewToActivate è NULL, il contenitore può ottenere un puntatore a una visualizzazione documento eseguendo una query sul documento per IOleDocument, chiamando IOleDocument::CreateView e passando il puntatore IOleInPlaceSite .
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 |