ContextAttributes (Interfaz)
Actualización: noviembre 2007
Contiene todos los atributos asociados a un contexto global o al contexto de una ventana en la ventana Ayuda dinámica.
Espacio de nombres: EnvDTE
Ensamblado: EnvDTE (en EnvDTE.dll)
Sintaxis
<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
Comentarios
En el caso de DTE.ContextAttributes, esto afecta al conjunto de contextos globales, que tiene la menor prioridad para ordenar temas.
En el caso de Window.ContextAttributes, afecta al conjunto de contextos de una ventana. En el caso de las ventanas de herramientas, los atributos sólo estarán en vigor cuando la ventana tenga el foco. En el caso de los editores y diseñadores, los atributos estarán en vigor mientras el editor sea la última ventana secundaria MDI activa. Si la propiedad HighPriorityAttributes está establecida en true, los atributos siempre estarán en vigor y tendrán la máxima prioridad.
Tras obtener una colección ContextAttributes, es preciso llamar a ContextAttributes.Refresh para asegurarse de que la colección de atributos esté actualizada, ya que la mera obtención del objeto no lo garantiza. Sin embargo, al agregar y quitar atributos se actualiza implícitamente la colección ContextAttributes, de modo que los resultados de las operaciones de agregar o quitar están actualizados.
Ejemplos
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