IVsUserContext Интерфейс

  • Ссылка

Определение

Пространство имен:
Microsoft.VisualStudio.Shell.Interop
Сборка:
Microsoft.VisualStudio.Shell.Interop.dll
Сборка:

Управляет атрибутами и ключевыми словами (контекст и подконтекст) в контейнере контекста или подконтекста.

public interface class IVsUserContext
public interface class IVsUserContext
__interface IVsUserContext
[System.Runtime.InteropServices.Guid("761081DF-D45F-4683-9B9E-1B7241E56F5C")]
[System.Runtime.InteropServices.InterfaceType(1)]
public interface IVsUserContext
[<System.Runtime.InteropServices.Guid("761081DF-D45F-4683-9B9E-1B7241E56F5C")>]
[<System.Runtime.InteropServices.InterfaceType(1)>]
type IVsUserContext = interface
Public Interface IVsUserContext
Атрибуты
GuidAttribute InterfaceTypeAttribute

Комментарии

Контекст и подконтекст состоят из ключевых слов F1 , ключевых слов поиска и атрибутов. Контейнеры контекста и подконтекстов являются COM-объектами ( IVsUserContext объектами), которые используются для группирования ключевых слов и атрибутов, связанных с определенным поставщиком контекста. Поставщики контекста — это компоненты среды, задействованные в выделении, такие как окна инструментов, редакторы и языковые службы. Подконтекст — это выбор в редакторе, окне инструментов или языковой службе. Примеры элементов подконтекста включают ключевое слово языка в языковой службе или команду в окне инструментов.

Поставщик контекста связывает контейнер контекста с выделенным фрагментом. Контейнер подконтекстов — это отдельный IVsUserContext объект, связанный с контейнером контекста. Так как в контейнере контекста указываются все связанные с ним контейнеры подконтекстов, ключевые слова и атрибуты, представленные в контейнерах контекста и подконтекстов, составляют весь контекст для компонента. Объединение контейнеров контекста и подконтекстов для каждого поставщика контекста в активном выделенном фрагменте описывает общий контекст в среде в определенный момент времени.

Прежде чем использовать методы IVsUserContext для управления контейнером контекста, сначала необходимо настроить компонент среды в качестве поставщика контекста, создав для него контейнер контекста. Чтобы создать новый контейнер контекста, вызовите QueryService службу, SVsMonitorUserContext чтобы получить указатель на IVsMonitorUserContext интерфейс. Получив указатель на этот интерфейс, вызовите метод, CreateEmptyContext чтобы создать новый контейнер контекста и получить указатель на IVsUserContext . Затем можно вызвать AddAttribute метод, чтобы добавить атрибуты, ключевые слова поиска или ключевые слова F1 в контейнер контекста. Используйте эту же процедуру для создания и заполнения контейнера подконтекста, а затем вызовите метод AddSubcontext , чтобы связать контейнер подконтекстов с контейнером контекста.

Примечания для тех, кто вызывает этот метод

Вызывайте этот интерфейс для добавления, удаления, перечисления или флага контекста и подконтекста.

Методы

AddAttribute(VSUSERCONTEXTATTRIBUTEUSAGE, String, String)

Добавляет атрибут, ключевое слово Lookup или ключевое слово F1 в контейнер контекста или подконтекста.
AddSubcontext(IVsUserContext, Int32, UInt32)

Связывает контейнер подконтекста с контейнером родительского контекста.
AdviseUpdate(IVsUserContextUpdate, UInt32)

Позволяет клиентам получать уведомления при изменении контейнера свойств контекста пользователя.
CountAttributes(String, Int32, Int32)

Возвращает число атрибутов или ключевых слов, представленных в контейнере контекста или подконтекста.
CountSubcontexts(Int32)

Возвращает количество наборов подконтекстов, связанных с набором контекста.
GetAttribute(Int32, String, Int32, String, String)

Возвращает указанный атрибут или ключевое слово из контейнера контекста или подконтекста на основании позиции в индексе или имени.
GetAttributePri(Int32, String, Int32, Int32, String, String)

Возвращает указанный атрибут или ключевое слово из контейнера контекста или подконтекста на основании позиции в индекса, имени или приоритета.
GetAttrUsage(Int32, Int32, VSUSERCONTEXTATTRIBUTEUSAGE[])

Возвращает тип контекста (атрибута, ключевое слово Lookup или ключевое слово F1), присутствующее в указанной позиции индекса в контексте контекста или подконтекста.
GetPriority(Int32)

Определяет приоритет атрибута или ключевого слова в наборе контекста или вложенного контекста.
GetSubcontext(Int32, IVsUserContext)

Возвращает указанный набор подконтекстов из родительского контейнера контекста.
IsDirty(Int32)

Определяет, изменился ли контекст пользователя в наборе контекста или вложенного контекста.
RemoveAllSubcontext()

Удаляет все наборы подконтекстов, связанные с набором контекста.
RemoveAttribute(String, String)

Удаляет атрибут или ключевое слово из набора контекста или подконтекста.
RemoveAttributeIncludeChildren(String, String)

Удаляет атрибут или ключевое слово из контейнера контекстов или из любых связанных контейнеров подконтекстов.
RemoveSubcontext(UInt32)

Удаляет указанный контейнер подконтекста.
SetDirty(Int32)

Помечает контейнер контекста или подконтекста для обновления.
UnadviseUpdate(UInt32)

Запрещает клиентам получать уведомления об обновлениях контекста пользователя.
Update()

Обновляет Контекст пользователя.

Применяется к