Metodo IOleInPlaceObject::UIDeactivate (oleidl.h)

Articolo
03/01/2024

Disattiva e rimuove l'interfaccia utente di un oggetto attivo sul posto.

Sintassi

HRESULT UIDeactivate();

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 dell'oggetto quando, ad esempio, l'utente ha fatto clic nell'area client all'esterno dell'oggetto.

Se il contenitore ha chiamato IOleInPlaceObject::UIDeactivate, dovrebbe chiamare in seguito IOleInPlaceObject::InPlaceDeactivate per pulire correttamente le risorse. Il contenitore può presumere che l'arresto o il rilascio dell'oggetto pulisca le risorse, se necessario. L'oggetto deve essere preparato per eseguire questa operazione se non è stato chiamato IOleInPlaceObject::InPlaceDeactivate . ma è stato chiamato IOleInPlaceObject::UIDeactivate o IOleObject::Close .

Note per gli implementatori

Le risorse come menu e finestre possono essere pulite o mantenute in uno stato nascosto fino a quando l'oggetto non viene completamente disattivato dalle chiamate a IOleInPlaceObject::InPlaceDeactivate o IOleObject::Close. L'applicazione dell'oggetto deve chiamare IOleInPlaceSite::OnUIDeactivate prima di eseguire qualsiasi operazione con i menu compositi in modo che il contenitore possa essere prima scollegato dalla finestra del frame. Durante la disattivazione dell'interfaccia utente dell'oggetto sul posto, l'oggetto viene lasciato in uno stato pronto in modo che possa essere riattivato rapidamente. L'oggetto rimane in questo stato fino a quando lo stato di annullamento del documento viene modificato. Il contenitore deve quindi chiamare IOleInPlaceObject::InPlaceDeactivate per indicare all'oggetto di ignorare lo stato di annullamento.

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