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)

Voir aussi

IShellView