ContextAttributes-Schnittstelle

Enthält alle Attribute, die mit einem globalen Kontext oder einem Fensterkontext im Fenster Dynamische Hilfe verknüpft sind.

Namespace:  EnvDTE
Assembly:  EnvDTE (in EnvDTE.dll)

Syntax

'Declaration
<GuidAttribute("33C5EBB8-244E-449D-9CEE-FAD70A774E59")> _
Public Interface ContextAttributes _
    Inherits IEnumerable
[GuidAttribute("33C5EBB8-244E-449D-9CEE-FAD70A774E59")]
public interface ContextAttributes : IEnumerable
[GuidAttribute(L"33C5EBB8-244E-449D-9CEE-FAD70A774E59")]
public interface class ContextAttributes : IEnumerable
[<GuidAttribute("33C5EBB8-244E-449D-9CEE-FAD70A774E59")>]
type ContextAttributes =  
    interface
        interface IEnumerable
    end
public interface ContextAttributes extends IEnumerable

Der ContextAttributes-Typ macht die folgenden Member verfügbar.

Eigenschaften

  Name Beschreibung
Öffentliche Eigenschaft Count Ruft einen Wert ab, der die Anzahl der in der ContextAttributes-Auflistung enthaltenen Objekte angibt.
Öffentliche Eigenschaft DTE Ruft das Erweiterbarkeitsobjekt der obersten Ebene ab.
Öffentliche Eigenschaft HighPriorityAttributes Ruft die Auflistung der Attribute mit hoher Priorität ab.
Öffentliche Eigenschaft Parent Ruft das unmittelbar übergeordnete Objekt einer ContextAttributes-Auflistung ab.
Öffentliche Eigenschaft Type Ruft eine Konstante ab, die den Objekttyp angibt.

Zum Seitenanfang

Methoden

  Name Beschreibung
Öffentliche Methode Add Fügt der ContextAttributes-Auflistung ein Name/Wert-Paar für ein Attribut hinzu.
Öffentliche Methode GetEnumerator() Gibt einen Enumerator zurück, der eine Auflistung durchläuft. (Von IEnumerable geerbt.)
Öffentliche Methode GetEnumerator() Gibt einen Enumerator für Elemente in der Auflistung zurück.
Öffentliche Methode Item Gibt ein ContextAttribute-Objekt zurück, das ein Element der ContextAttributes-Auflistung darstellt.
Öffentliche Methode Refresh Aktualisiert den Inhalt dieser Attributauflistung.

Zum Seitenanfang

Hinweise

Bei DTE.ContextAttributes betrifft dies die globale Kontextsammlung, die die niedrigste Rangordnung beim Sortieren von Themen besitzt.

Bei Window.ContextAttributes ist nur die Kontextsammlung für ein Fenster betroffen. Bei Toolfenstern sind die Attribute nur dann wirksam, wenn das Fenster den Fokus besitzt. Bei Editoren und Designern sind die Attribute wirksam, solang der Editor als letztes untergeordnetes MDI-Element aktiv ist. Wenn für die HighPriorityAttributes-Eigenschaft der Wert true festgelegt ist, sind die Attribute immer aktiv und besitzen die höchste Priorität.

Nach dem Abrufen einer ContextAttributes-Auflistung müssen Sie ContextAttributes.Refresh aufrufen, um sicherzustellen, dass die Attributauflistung auf dem neuesten Stand ist, was durch einfaches Abrufen des Objekts nicht gewährleistet wird. Beim Hinzufügen und Entfernen von Attributen wird die ContextAttributes-Auflistung jedoch implizit aktualisiert, sodass es sich bei dem Ergebnis des jeweiligen Vorgangs stets um den aktuellen Zustand handelt.

Beispiele

Sub ContextAttributesExample()
   ' Get a reference to Solution Explorer.
   Dim SolnEx As Window = DTE.Windows.Item _
   (Constants.vsWindowKindSolutionExplorer)
   Dim CA As ContextAttribute

   ' List the current attributes associated with Solution Explorer.
   ListAttr(SolnEx, CA)

   ' Associate a new F1 keyword with Solution Explorer.
   SolnEx.ContextAttributes.Add("ANewKeyword", 900, _
   vsContextAttributeType.vsContextAttributeLookupF1)
   ListAttr(SolnEx, CA)

   ' Delete the new F1 keyword from Solution Explorer.
   SolnEx.ContextAttributes.Item(3).Remove()
   ListAttr(SolnEx, CA)
End Sub

Sub ListAttr(ByVal SolnEx As Object, ByVal CA As ContextAttribute)
   ' Support function for CATest(). Lists the current attributes 
   ' associated with Solution Explorer.
   Dim msg As String

   MsgBox("Number of context attributes in Solution Explorer: " & _
   SolnEx.ContextAttributes.Count)
   For Each CA In SolnEx.ContextAttributes
      msg = msg & CA.Name & Chr(13)
   Next
   MsgBox(msg)
   msg = ""
End Sub

Siehe auch

Referenz

EnvDTE-Namespace