Classe SelectionContainer

Fornisce un'interfaccia unificata per accedere a un set di oggetti selezionati.

Gerarchia di ereditarietà

System.Object
  Microsoft.VisualStudio.Shell.SelectionContainer

Spazio dei nomi:  Microsoft.VisualStudio.Shell
Assembly:  Microsoft.VisualStudio.Shell.11.0 (in Microsoft.VisualStudio.Shell.11.0.dll)

Sintassi

'Dichiarazione
Public Class SelectionContainer _
    Implements ISelectionContainer
public class SelectionContainer : ISelectionContainer

Il tipo SelectionContainer espone i seguenti membri.

Costruttori

  Nome Descrizione
Metodo pubblico SelectionContainer() inizializza un nuovo oggetto di SelectionContainer .L'overload consente di limitare il controllo utente sulle raccolte di SelectedObjects e di SelectableObjects .
Metodo pubblico SelectionContainer(Boolean, Boolean) Crea un nuovo oggetto di SelectionContainer con la possibilità di limitare il controllo utente sulle raccolte di SelectedObjects e di SelectableObjects .

In alto

Proprietà

  Nome Descrizione
Proprietà pubblica SelectableObjects ottiene la raccolta di oggetti selezionabili.
Proprietà pubblica SelectedObjects ottiene o imposta la raccolta di oggetti selezionati.

In alto

Metodi

  Nome Descrizione
Metodo protetto ActivateObjects Eseguire l'override di questo metodo consente a un oggetto per rispondere quando selezionata.
Metodo pubblico Equals Determina se l'oggetto specificato equivale all'oggetto corrente. (Ereditato da Object)
Metodo protetto Finalize Consente a un oggetto di provare a liberare risorse ed eseguire altre operazioni di pulitura prima che l'oggetto stesso venga recuperato dalla procedura di Garbage Collection. (Ereditato da Object)
Metodo pubblico GetHashCode Funge da funzione hash per un determinato tipo. (Ereditato da Object)
Metodo pubblico GetType Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
Metodo protetto MemberwiseClone Consente di creare una copia dei riferimenti dell'oggetto Object corrente. (Ereditato da Object)
Metodo pubblico ToString Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

In alto

Eventi

  Nome Descrizione
Evento pubblico SelectedObjectsChanged Generato quando un oggetto esterno chiama il metodo di ISelectionContainer.SelectObjects con il flag impostato di SELECTED .

In alto

Campi

  Nome Descrizione
Campo pubblicoMembro statico ALL Fa riferimento a qualsiasi SelectableObjects.
Campo pubblicoMembro statico SELECTED Fa riferimento a qualsiasi SelectedObjects.

In alto

Implementazioni esplicite dell'interfaccia

  Nome Descrizione
Implementazione esplicita dell'interfacciaMetodo privato ISelectionContainer.CountObjects Determina il numero di oggetti gli elementi di ALL o di SELECTED .
Implementazione esplicita dell'interfacciaMetodo privato ISelectionContainer.GetObjects Imposta cObjects con il numero di elementi SELECTED o elementi di ALL e popola la matrice apUnkObjects con i puntatori a tali oggetti.
Implementazione esplicita dell'interfacciaMetodo privato ISelectionContainer.SelectObjects imposta la raccolta di oggetti selezionabili.

In alto

Note

La classe di SelectionContainer fornisce un'interfaccia unificata per accedere a un set di oggetti selezionati.Implementa tutti i metodi definiti dall'interfaccia di ISelectionContainer e aggiunge un nuovo metodo, ActivateObjects, che consente a un oggetto per rispondere quando selezionata.

In genere, il contenuto della casella di selezione viene modificato quando un oggetto esterno chiama [SelectObjects], che genera un evento di SelectedObjectsChanged (e può inoltre chiamare il metodo di ActivateObjects , se viene distribuito.) Il contenuto della casella di selezione può essere esaminato o modificato accesso alle proprietà di SelectableObjects o di SelectedObjects .

Quando si verificano modifiche che interessano la finestra di Proprietà , il package VS necessario segnalare all'ambiente chiamando il metodo di OnSelectChange con il contenitore di selezione che rifletta il contesto di selezione corrente.La shell quindi effettua chiamate ai metodi di SelectionContainer per recuperare uno o più oggetti di IDispatch , che forniscono accesso ai dati necessari per aggiornare la Finestra Proprietà.

Questa classe consente inoltre di semplificare alcuni problemi di interoperabilità con le interfacce di ISelectionContainer .Le versioni diverse delle versioni diverse di utilizzo di Visual Studio di ISelectionContainere SelectionContainer viene fornito da senza interoperabilità con le implementazioni diverse.

Note per gli implementatori

Un contenitore a selezione è il meccanismo utilizzato da windows per inserire le informazioni sulla finestra di Proprietà .Un VSPackage deve includere un oggetto di SelectionContainer per ogni oggetto (in genere una finestra) che contiene gli oggetti selezionabili con le proprietà correlate da visualizzare nella finestra di Proprietà .

Codice thread safe

Qualsiasi membro static (Shared in Visual Basic) pubblico di questo tipo è thread-safe. I membri di istanza non sono garantiti come thread-safe.

Vedere anche

Riferimenti

Spazio dei nomi Microsoft.VisualStudio.Shell

ISelectionContainer

Altre risorse

Selezione e la valuta nell'IDE