Champs et interfaces de fenêtre Propriétés
Le modèle pour la sélection détermine les informations sont affichées dans la fenêtre de Propriétés est basée sur la fenêtre qui a le focus dans l'IDE. Chaque fenêtre, et l'objet dans la fenêtre sélectionnée, peut avoir son objet de contexte de sélection de type push au contexte global de sélection. L'environnement met à jour le contexte global de sélection avec des valeurs d'un frame de fenêtre lorsque cette fenêtre a le focus. Lorsque le focus est modifié, fait le contexte de sélection.
Sélection de traçage dans l'IDE
Le frame de fenêtre ou le site, détenu par l'IDE, a un service intitulé STrackSelection. Les étapes suivantes indiquent comment une modification dans une sélection, provoquée par l'utilisateur modifiant le focus vers une autre fenêtre active ou la sélection d'un élément de projet différent dans Explorateur de solutions, est implémenté pour modifier le contenu affiché dans la fenêtre de Propriétés .
L'objet créé par votre VSPackage qui se trouve dans la fenêtre sélectionnée appelle QueryService pour faire appeler STrackSelectionITrackSelection.
Le conteneur de sélection, le cas par la fenêtre sélectionnée, crée son propre objet d' ISelectionContainer . Lorsque la sélection change, le VSPackage appelle l' OnSelectChange pour notifier à tous les écouteurs dans l'environnement, y compris la fenêtre de Propriétés , la modification. Elle fournit également l'accès à la hiérarchie et l'élément des informations relatives à la nouvelle sélection.
L' OnSelectChange appelant et le passer les éléments sélectionnés de hiérarchie du paramètre d' VSHPROPID_BrowseObject remplit l'objet d' ISelectionContainer .
Un objet dérivé d' IDispatch Interface est retourné pour VSHPROPID_BrowseObject pour l'élément demandé, et l'environnement l'encapsule dans ISelectionContainer (consultez l'étape suivante). Si l'appel échoue, l'environnement fait un deuxième appel à IVsHierarchy::GetProperty, en lui passant le conteneur VSHPROPID_SelContainer de choix que le ou les éléments de la hiérarchie fournissent.
Votre projet VSPackage ne crée pas ISelectionContainer car la fenêtre environnement-fournie VSPackage qui l'implémente (par exemple, Explorateur de solutions) construit ISelectionContainer de sa part.
L'environnement appelle les méthodes d' ISelectionContainer pour obtenir les objets basées sur l'interface d' IDispatch de terminer la fenêtre de Propriétés .
Lorsqu'une valeur dans la fenêtre de Propriétés est modifiée, VSPackages implémentent IVsTrackSelectionEx::OnElementValueChangeEx et IVsTrackSelectionEx::OnSelectionChangeEx pour stocker la modification apportée à la valeur d'élément. L'environnement appelle ensuite IVsUIShell ou IConnectionPointContainer pour gérer les informations affichées dans la fenêtre de Propriétés synchronisée avec les valeurs de propriété. Pour plus d'informations, consultez Comment : valeurs de propriété de mise à jour dans la fenêtre Propriétés.
En plus de sélectionner un élément de projet différent dans Explorateur de solutions aux propriétés d'affichage en rapport avec cet élément, vous pouvez également choisir un autre objet d'un formulaire ou d'une fenêtre de document à l'aide de la liste déroulante disponible dans la fenêtre de Propriétés . Pour plus d'informations, consultez Liste d'objet fenêtre Propriétés.
Vous pouvez modifier la façon dont les informations sont affichées dans la grille de fenêtre de Propriétés d'alphabétique à par catégorie, et, si disponible, vous pouvez également ouvrir une page de propriétés pour un objet sélectionné en cliquant sur les boutons appropriés dans la fenêtre de Propriétés . Pour plus d'informations, consultez Boutons de la fenêtre Propriétés et Pages de propriétés.
Enfin, le bas de la fenêtre de Propriétés contient également une description du champ sélectionné dans la grille de fenêtre de Propriétés . Pour plus d'informations, consultez Comment : Récupérez les descriptions de champ de la fenêtre Propriétés.