ContextAttributes ContextAttributes ContextAttributes ContextAttributes Interface

Definition

Contains all attributes associated with a global context or window's context in the Dynamic Help window.

public interface class ContextAttributes : System::Collections::IEnumerable
[System.Runtime.InteropServices.Guid("33C5EBB8-244E-449D-9CEE-FAD70A774E59")]
[System.Runtime.InteropServices.TypeLibType(4160)]
public interface ContextAttributes : System.Collections.IEnumerable
type ContextAttributes = interface
    interface IEnumerable
Public Interface ContextAttributes
Implements IEnumerable
Attributes
Implements

Examples

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  

Remarks

For DTE.ContextAttributes, this affects the global context bag, which has the lowest precedence for sorting topics.

For Window.ContextAttributes, this affects the context bag for a window. For tool windows, the attributes are in effect only when the window has focus. For editors and designers, the attributes are in effect as long as the editor is the last active MDI child. If the HighPriorityAttributes property is set to true, then the attributes are always in effect and highest in precedence.

After getting a ContextAttributes collection, you must call ContextAttributes.Refresh to ensure that the collection of attributes is up to date, because simply fetching the object does not do so. Adding and removing attributes, however, implicitly refreshes the ContextAttributes collection so that the results of add or remove operations are current.

Properties

Count Count Count Count

Gets the number of objects in the ContextAttributes collection.

DTE DTE DTE DTE

Gets the top-level extensibility object.

HighPriorityAttributes HighPriorityAttributes HighPriorityAttributes HighPriorityAttributes

Gets the High Priority attributes collection.

Parent Parent Parent Parent

Gets the immediate parent object of a ContextAttributes collection.

Type Type Type Type

Gets a constant indicating the object type.

Methods

Add(String, String, vsContextAttributeType) Add(String, String, vsContextAttributeType) Add(String, String, vsContextAttributeType) Add(String, String, vsContextAttributeType)

Adds an attribute name/value pair to the ContextAttributes collection.

GetEnumerator() GetEnumerator() GetEnumerator() GetEnumerator()

Returns an enumerator for items in the collection.

Item(Object) Item(Object) Item(Object) Item(Object)

Returns a ContextAttribute object that is an item of the ContextAttributes collection.

Refresh() Refresh() Refresh() Refresh()

Refresh the contents of this attribute collection.

Applies to