ContextAttributes, interface
Mise à jour : novembre 2007
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
<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
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