ContextAttributes (Interfaz)

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

'Declaración
<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

El tipo ContextAttributes expone los siguientes miembros.

Propiedades

	Nombre	Descripción
	Count	Obtiene un valor que indica el número de objetos de la colección ContextAttributes.
	DTE	Obtiene el objeto de extensibilidad de nivel superior.
	HighPriorityAttributes	Obtiene la colección de atributos de prioridad alta.
	Parent	Obtiene el objeto primario inmediato de una colección ContextAttributes.
	Type	Obtiene una constante que indica el tipo de objeto.

Arriba

Métodos

	Nombre	Descripción
	Add	Agrega un par nombre-valor de atributo a la colección ContextAttributes.
	GetEnumerator()	Devuelve un enumerador que recorre en iteración una colección. (Se hereda de IEnumerable).
	GetEnumerator()	Devuelve un enumerador para los elementos de la colección.
	Item	Devuelve un objeto ContextAttribute que es un elemento de la colección ContextAttributes.
	Refresh	Actualiza el contenido de esta colección de atributos.

Arriba

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

Vea también

Referencia

EnvDTE (Espacio de nombres)