Méthode IOleInPlaceObject ::UIDeactivate (oleidl.h)

Article
03/04/2024

Désactive et supprime l’interface utilisateur d’un objet actif sur place.

Syntaxe

HRESULT UIDeactivate();

Valeur de retour

Cette méthode retourne S_OK en cas de réussite. Les autres valeurs de retour possibles sont les suivantes.

Code de retour	Description
E_UNEXPECTED	Une erreur inattendue s’est produite.

Remarques

Remarques aux appelants

Cette méthode est appelée par le conteneur immédiat de l’objet lorsque, par exemple, l’utilisateur a cliqué dans la zone cliente en dehors de l’objet.

Si le conteneur a appelé IOleInPlaceObject ::UIDeactivate, il doit ensuite appeler IOleInPlaceObject ::InPlaceDeactivate pour propre correctement les ressources. Le conteneur peut supposer que l’arrêt ou la libération de l’objet nettoie les ressources si nécessaire. L’objet doit être prêt à le faire si IOleInPlaceObject ::InPlaceDeactivate n’a pas été appelé. mais IOleInPlaceObject ::UIDeactivate ou IOleObject ::Close a été appelé.

Remarques aux implémenteurs

Les ressources telles que les menus et les fenêtres peuvent être nettoyées ou conservées dans un état masqué jusqu’à ce que votre objet soit complètement désactivé par des appels à IOleInPlaceObject ::InPlaceDeactivate ou À IOleObject ::Close. L’application objet doit appeler IOleInPlaceSite ::OnUIDeactivate avant d’effectuer quoi que ce soit avec les menus composites afin que le conteneur puisse d’abord être détaché de la fenêtre frame. Lors de la désactivation de l’interface utilisateur de l’objet sur place, l’objet est laissé dans un état prêt afin qu’il puisse être rapidement réactivé. L’objet reste dans cet état jusqu’à ce que l’état d’annulation du document change. Le conteneur doit ensuite appeler IOleInPlaceObject ::InPlaceDeactivate pour indiquer à l’objet d’ignorer son état d’annulation.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	oleidl.h