Metodo IOleInPlaceObject::InPlaceDeactivate (oleidl.h)
Disattiva un oggetto sul posto attivo e rimuove lo stato di annullamento dell'oggetto.
Sintassi
HRESULT InPlaceDeactivate();
Valore restituito
Questo metodo restituisce S_OK se l'operazione ha esito positivo. Gli altri valori restituiti possibili includono i seguenti:
| Codice restituito | Descrizione |
|---|---|
|
Si è verificato un errore imprevisto. |
Commenti
Note ai chiamanti
Questo metodo viene chiamato dal contenitore immediato di un oggetto attivo per disattivare l'oggetto attivo ed eliminarlo.Note per gli implementatori
Al ritorno da IOleInPlaceObject::InPlaceDeactivate, l'oggetto rimuove lo stato di annullamento. L'applicazione oggetto non deve essere arrestata immediatamente dopo questa chiamata. Deve invece attendere che una chiamata esplicita a IOleObject::Close o il conteggio dei riferimenti dell'oggetto raggiunga lo zero.Prima di disattivare, l'applicazione oggetto deve dare al contenitore la possibilità di ripristinare l'interfaccia utente nella finestra cornice chiamando IOleInPlaceSite::OnUIDeactivate.
Se l'interfaccia utente sul posto è ancora visibile durante la chiamata a IOleInPlaceObject::InPlaceDeactivate, l'applicazione oggetto deve chiamare il proprio metodo IOleInPlaceObject::InPlaceDeactivate per nascondere l'interfaccia utente. L'interfaccia utente sul posto può essere eliminata facoltativamente durante le chiamate a IOleInPlaceObject::InPlaceDeactivate e IOleInPlaceObject::InPlaceDeactivate. Tuttavia, se l'interfaccia utente non è già stata eliminata definitivamente quando il contenitore chiama IOleObject::Close, deve essere eliminato definitivamente durante la chiamata a IOleObject::Close.
Durante la chiamata a IOleObject::Close, l'oggetto deve verificare se è ancora attivo. In tal caso, deve chiamare IOleInPlaceObject::InPlaceDeactivate.
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 | oleidl.h |
Vedi anche
IOleInPlaceSite::OnInPlaceDeactivate