Méthode IShellView ::UIActivate (shobjidl_core.h)
Appelé lorsque l’état d’activation de la fenêtre d’affichage est modifié par un événement qui n’est pas dû à la vue Shell elle-même. Par exemple, si la touche TAB est enfoncée lorsque l’arborescence a le focus, le focus doit être mis sur la vue.
Syntaxe
HRESULT UIActivate(
UINT uState
);
Paramètres
uState
Type : UINT
Indicateur spécifiant l’état d’activation de la fenêtre. Ce paramètre peut prendre les valeurs suivantes.
SVUIA_ACTIVATE_FOCUS
Windows Explorer vient de créer la fenêtre d’affichage avec le focus d’entrée. Cela signifie que la vue Shell doit être en mesure de définir les éléments de menu appropriés pour l’état prioritaire.
SVUIA_ACTIVATE_NOFOCUS
La vue Shell perd le focus d’entrée ou vient d’être créée sans le focus d’entrée. La vue Shell doit être en mesure de définir des éléments de menu appropriés pour l’état non centré. Cela signifie qu’aucun élément spécifique à la sélection ne doit être ajouté.
SVUIA_DEACTIVATE
Windows Explorer est sur le point de détruire la fenêtre de vue Shell. La vue Shell doit supprimer toutes les interfaces utilisateur étendues. Il s’agit généralement de menus fusionnés et de fenêtres contextuelles sans mode fusionnées.
SVUIA_INPLACEACTIVATE
La vue Shell est active sans focus. Cet indicateur est utilisé uniquement lorsque UIActivate est exposé via l’interface IShellView2 .
Valeur retournée
Type : HRESULT
Retourne S_OK en cas de réussite, ou une valeur d’erreur définie par COM dans le cas contraire.
Remarques
Avant de réactiver les éléments de menu, la vue Shell connecte généralement le message WM_SETFOCUS et appelle la méthode OnViewWindowActive . La vue Shell ne doit pas crocheter le message NM_KILLFOCUS pour réinsèrer les éléments de menu.
Remarques relatives à l’appel d’applications
Appelez cette méthode pour informer la vue d’un changement d’état d’activation.Notes aux implémenteurs
Utilisez cette méthode pour suivre l’état d’activation et modifier tout comportement, le cas échéant.Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows XP [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | shobjidl_core.h (inclure Shobjidl.h) |
| DLL | Shell32.dll (version 4.0 ou ultérieure) |