IVsUserContext.GetAttributePri Метод

  • Ссылка

Определение

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

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

public:
 int GetAttributePri(int iAttribute, System::String ^ pszName, int fIncludeChildren, [Runtime::InteropServices::Out] int % piPriority, [Runtime::InteropServices::Out] System::String ^ % pbstrName, [Runtime::InteropServices::Out] System::String ^ % pbstrValue);
int GetAttributePri(int iAttribute, std::wstring const & pszName, int fIncludeChildren, [Runtime::InteropServices::Out] int & piPriority, [Runtime::InteropServices::Out] std::wstring const & & pbstrName, [Runtime::InteropServices::Out] std::wstring const & & pbstrValue);
public int GetAttributePri (int iAttribute, string pszName, int fIncludeChildren, out int piPriority, out string pbstrName, out string pbstrValue);
abstract member GetAttributePri : int * string * int * int * string * string -> int
Public Function GetAttributePri (iAttribute As Integer, pszName As String, fIncludeChildren As Integer, ByRef piPriority As Integer, ByRef pbstrName As String, ByRef pbstrValue As String) As Integer

Параметры

iAttribute
Int32

[in] Индекс в коллекцию атрибутов и ключевых слов в контексте или контейнере вложенного контекста.

pszName
String

[in] Имя или ключевое слово атрибута. Укажите имя атрибута для доступа к определенному атрибуту в контейнере контекста или подконтекста. Укажите ключевое слово для доступа к ключевому слову F1 или Lookup.

fIncludeChildren
Int32

[in] Если значение true, также возвращаются элементы вложенного контекста, связанные с этим контейнером контекста. Если значение true, вложенный контекст исключается.

piPriority
Int32

[out] Приоритет атрибута или ключевого слова. Список значений piPriority см. в VSUSERCONTEXTPRIORITY.

pbstrName
String

[out] Указатель на конкретное имя атрибута или ключевое слово значения, если найдено соответствие.

pbstrValue
String

[out, retval] Указатель на определенное значение атрибута или текст ключевого слова, если найдено соответствие.

Возвращаемое значение

Int32

Если метод завершается успешно, возвращает значение S_OK. В противном случае функция возвращает код ошибки.

Комментарии

Подпись COM

Из context. IDL:

HRESULT IVsUserContext::GetAttributePri(  
   [in] int iAttribute,  
   [in] LPCOLESTR pszName,  
   [in] BOOL fIncludeChildren,  
   [out] int *piPriority,  
   [out] BSTR * pbstrName,  
   [out, retval] BSTR * pbstrValue  
);

Этот метод очень похож на GetAttribute метод, но дополнительно Возвращает приоритет атрибута или ключевого слова в контейнере контекста или подконтексте. Существует три разных способа использования IVsUserContext.GetAttributePri метода:

  • Передайте null значение pszName параметра и пройдите по всем атрибутам и ключевым словам в контексте контекста или подконтекста с помощью iAttribute параметра. Количество атрибутов и ключевых слов можно определить с помощью CountAttributes метода.

  • Выполните итерацию всех атрибутов и ключевых слов и передайте определенное имя атрибута или ключевое слово в качестве значения pszName параметра. Имя атрибута и значение или ключевое слово и значение возвращаются в pbstrName pbstrValue параметрах и соответственно, только если указанное имя соответствует имени в контейнере контекста или подконтексте.

  • Передайте значение-1 для iAttribute параметра и имя конкретного атрибута или ключевого слова для значения pszName параметра. Возвращается первый атрибут или ключевое слово, соответствующие имени.

Если этот метод находит соответствие для pszName параметра, возвращается S_OK. Если метод не находит совпадения, возвращается E_UNEXPECTED. Таким способом, можно задать значения piPriority параметров, и, а также pbstrName pbstrValue null оценить успешное или неуспешное выполнение метода на основе возвращаемых значений.

Используйте метод, чтобы определить, является ли ключевое слово, GetAttrUsage возвращаемое IVsUserContext.GetAttributePri методом, ключевым словом F1 или Lookup.

Примечание

Значение fIncludeChildren параметра не действует, если в контейнере контекста отсутствует подконтекст.

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