ContextAttributes - интерфейс

Статья
08/11/2011

Содержит все атрибуты, связанные с глобальным контекстом или контекстом окна в окне динамической справки.

Пространство имен: EnvDTE
Сборка: EnvDTE (в EnvDTE.dll)

Синтаксис

'Декларация
<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

Тип ContextAttributes предоставляет следующие члены.

Свойства

	Имя	Описание
	Count	Получает значение, указывающее число объектов в коллекции ContextAttributes.
	DTE	Возвращает объект расширения верхнего уровня.
	HighPriorityAttributes	Возвращает атрибуты коллекции с высоким приоритетом.
	Parent	Получает ближайший родительский объект коллекции ContextAttributes.
	Type	Получает константу, определяющую тип объекта.

В начало страницы

Методы

	Имя	Описание
	Add	Добавляет в коллекцию ContextAttributes пару имя/значение.
	GetEnumerator()	Возвращает перечислитель, который выполняет итерацию по элементам коллекции. (Унаследовано от IEnumerable.)
	GetEnumerator()	Возвращает перечислитель элементов данной коллекции.
	Item	Возвращает объект ContextAttribute, который является элементом коллекции ContextAttributes.
	Refresh	Обновляет содержимое коллекции атрибутов.

В начало страницы

Заметки

Для DTE.ContextAttributes эта коллекция затрагивает весь глобальный контекст, который применяется в последнюю очередь при сортировке разделов.

Для Window.ContextAttributes затрагивается контекст для окна. Для окон служебных программ атрибуты имеют силу только тогда, когда окно имеет фокус. Для редакторов и конструкторов атрибуты имеют силу до тех пор, пока редактор является последним активным дочерним элементом MDI. Если свойство HighPriorityAttributes равно true, то атрибуты действуют всегда и применяются в первую очередь.

После получения коллекции ContextAttributes необходимо вызвать ContextAttributes.Refresh для обеспечения того, чтобы коллекция атрибутов не устарела, так как это не делается при простом извлечении объекта. Тем не менее добавление и удаление атрибутов неявно вызывает обновление коллекции ContextAttributes, так что результаты операций обновления и удаления верны на текущий момент.

Примеры

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

См. также

Ссылки

EnvDTE - пространство имен

Поделиться через