SelectionContainer, classe

Fournit une interface unifiée pour accéder à un jeu d'objets sélectionnés.

Hiérarchie d'héritage

System.Object
  Microsoft.VisualStudio.Shell.SelectionContainer

Espace de noms :  Microsoft.VisualStudio.Shell
Assembly :  Microsoft.VisualStudio.Shell.11.0 (dans Microsoft.VisualStudio.Shell.11.0.dll)

Syntaxe

'Déclaration
Public Class SelectionContainer _
    Implements ISelectionContainer

public class SelectionContainer : ISelectionContainer

Le type SelectionContainer expose les membres suivants.

Constructeurs

	Nom	Description
	SelectionContainer()	Initialise un nouvel objet SelectionContainer.La surcharge fournit la capacité de restreindre le contrôle utilisateur sur les collections d'SelectableObjects et d'SelectedObjects.
	SelectionContainer(Boolean, Boolean)	Crée un nouvel objet d'SelectionContainer avec la capacité de restreindre le contrôle utilisateur sur les collections d'SelectableObjects et d'SelectedObjects.

Début

Propriétés

	Nom	Description
	SelectableObjects	Obtient la collection d'objets sélectionnables.
	SelectedObjects	Obtient ou définit la collection d'objets sélectionnés.

Début

Méthodes

	Nom	Description
	ActivateObjects	Substituer cette méthode permet à un objet pour répondre une fois sélectionné.
	Equals	Détermine si l'objet Object spécifié est égal à l'objet Object actuel. (Hérité de Object.)
	Finalize	Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)
	GetHashCode	Sert de fonction de hachage pour un type particulier. (Hérité de Object.)
	GetType	Obtient le Type de l'instance actuelle. (Hérité de Object.)
	MemberwiseClone	Crée une copie superficielle de l'objet Object actuel. (Hérité de Object.)
	ToString	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object.)

Début

Événements

	Nom	Description
	SelectedObjectsChanged	Déclenché lorsqu'un objet externe appelle la méthode d'ISelectionContainer.SelectObjects avec l'ensemble de balise d'SELECTED.

Début

Champs

	Nom	Description
	ALL	Fait référence à tout l'SelectableObjects.
	SELECTED	Fait référence à tout l'SelectedObjects.

Début

Implémentations d'interface explicite

	Nom	Description
	ISelectionContainer.CountObjects	Détermine le nombre d'objets ces éléments d'SELECTED ou d'ALL.
	ISelectionContainer.GetObjects	Définit cObjects avec le nombre d'éléments SELECTED ou d'éléments d'ALL et remplit matrice apUnkObjects avec des pointeurs à ces objets.
	ISelectionContainer.SelectObjects	Définit la collection d'objets sélectionnables.

Début

Remarques

La classe d'SelectionContainer fournit une interface unifiée pour accéder à un jeu d'objets sélectionnés.Il implémente toutes les méthodes définies par l'interface d'ISelectionContainer, et ajoute une nouvelle méthode, ActivateObjects, qui permet à un objet pour répondre lorsqu'elle est sélectionnée.

En général, le contenu du conteneur de sélection est modifié lorsqu'un objet externe appelle [SelectObjects], qui déclenche un événement d'SelectedObjectsChanged (et peut également appeler la méthode d'ActivateObjects, si elle est implémentée.) Le contenu du conteneur de sélection peut également être révisé ou modifié en accédant aux propriétés d'SelectedObjects ou d'SelectableObjects.

Lorsque les modifications se produisent qui affectent la fenêtre de Propriétés, le VSPackage doit alerter l'environnement en appelant la méthode d'OnSelectChange avec le conteneur de sélection qui reflète le contexte actuel de sélection.Le shell fait ensuite des appels aux méthodes d'SelectionContainer pour extraire un ou plusieurs objets d'IDispatch, qui permettent d'accéder aux données nécessaires pour mettre à jour la fenêtre Propriétés.

Cette classe simplifie également quelques problèmes d'interopérabilité avec les interfaces d'ISelectionContainer.Les différentes versions de Visual Studio implémentent différentes versions d'ISelectionContainer, et SelectionContainer fournit à l'interopérabilité transparente les implémentations différentes.

Remarques à l'attention des implémenteurs

Un conteneur de sélection est le mécanisme utilisé par des fenêtres pour effectuer un push les informations dans la fenêtre de Propriétés.Un VSPackage doit comprendre un objet d'SelectionContainer pour chaque objet (en général une fenêtre) qui contient les objets sélectionnables avec des propriétés connexes à afficher dans la fenêtre de Propriétés.

Sécurité des threads

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Voir aussi

Référence

Microsoft.VisualStudio.Shell, espace de noms

ISelectionContainer

Autres ressources

Sélection et la devise dans l'IDE