ContextAttributes, interface

Article
08/10/2011

Contient tous les attributs associés à un contexte global ou au contexte d'une fenêtre dans la fenêtre d'aide dynamique.

Espace de noms : EnvDTE
Assembly : EnvDTE (dans EnvDTE.dll)

Syntaxe

'Déclaration
<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

Le type ContextAttributes expose les membres suivants.

Propriétés

	Nom	Description
	Count	Obtient une valeur indiquant le nombre d'objets de la collection ContextAttributes.
	DTE	Obtient l'objet d'extensibilité de niveau supérieur.
	HighPriorityAttributes	Obtient la collection d'attributs High Priority.
	Parent	Obtient l'objet parent immédiat d'une collection ContextAttributes.
	Type	Obtient une constante indiquant le type de l'objet.

Début

Méthodes

	Nom	Description
	Add	Ajoute une paire nom/valeur d'attribut à la collection ContextAttributes.
	GetEnumerator()	Retourne un énumérateur qui itère au sein d'une collection. (Hérité de IEnumerable.)
	GetEnumerator()	Retourne un énumérateur pour les éléments de la collection.
	Item	Retourne un objet ContextAttribute qui est un élément de la collection ContextAttributes.
	Refresh	Actualise le contenu de cette collection d'attributs.

Début

Notes

Dans le cas de DTE.ContextAttributes, cette collection affecte le sac de contextes globaux qui possède la plus basse priorité pour le tri des rubriques.

Dans le cas de Window.ContextAttributes, cette collection affecte le sac de contextes d'une fenêtre. Pour les fenêtres Outils, les attributs n'entrent en vigueur que lorsque la fenêtre est active. Pour les éditeurs et les concepteurs, les attributs sont appliqués aussi longtemps que l'éditeur est le dernier enfant MDI active. Si la propriété HighPriorityAttributes a la valeur true, les attributs sont toujours actifs et ont la priorité la plus élevée.

Lorsque vous avez obtenu une collection ContextAttributes, vous devez appeler ContextAttributes.Refresh pour vous assurer que la collection d'attributs est à jour, car la simple extraction de l'objet n'effectue pas cette vérification. Par contre, l'ajout et la suppression d'attributs actualisent implicitement la collection ContextAttributes afin que les résultats des opérations Ajouter ou Supprimer soient mis à jour.

Exemples

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

Voir aussi

Référence

EnvDTE, espace de noms

Partager via