ContextAttributes - интерфейс

Статья
11/01/2012

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

Пространство имен: 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 - пространство имен

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