Interfaccia ContextAttributes

Articolo
09/12/2008

Aggiornamento: novembre 2007

Contiene tutti gli attributi associati a un contesto globale o a un contesto di una finestra nella finestra Guida dinamica.

Spazio dei nomi: EnvDTE
Assembly: EnvDTE (in EnvDTE.dll)

Sintassi

<GuidAttribute("33C5EBB8-244E-449D-9CEE-FAD70A774E59")> _
Public Interface ContextAttributes _
    Implements IEnumerable

Dim instance As ContextAttributes

[GuidAttribute("33C5EBB8-244E-449D-9CEE-FAD70A774E59")]
public interface ContextAttributes : IEnumerable

[GuidAttribute(L"33C5EBB8-244E-449D-9CEE-FAD70A774E59")]
public interface class ContextAttributes : IEnumerable

public interface ContextAttributes extends IEnumerable

Note

Per DTE.ContextAttributes, influisce sull'elenco globale dei contesti, che ha la precedenza più bassa per l'ordinamento degli argomenti.

Per Window.ContextAttributes, influisce sull'elenco dei contesti di una finestra. Per le finestre degli strumenti, gli attributi sono attivi soltanto quando la finestra è attiva. Per gli editor e le finestre di progettazione, gli attributi sono attivi finché l'editor è l'ultimo elemento figlio MDI attivo. Se la proprietà HighPriorityAttributes è impostata su true, gli attributi sono sempre attivi e hanno la precedenza più alta.

Dopo avere ottenuto un insieme ContextAttributes, è necessario chiamare ContextAttributes.Refresh per far sì che l'insieme di attributi venga aggiornato, in quanto il semplice recupero dell'oggetto non comporta questa operazione. Aggiungendo e rimuovendo attributi, tuttavia, si aggiorna in modo implicito l'insieme ContextAttributes, quindi i risultati delle operazioni di aggiunta e rimozione risultano aggiornati.

Esempi

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

Vedere anche

Riferimenti

Membri ContextAttributes

Spazio dei nomi EnvDTE

Condividi tramite