Metodo IOleInPlaceObject::InPlaceDeactivate (oleidl.h)

Articolo
03/05/2024

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
E_UNEXPECTED	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