Udostępnij za pośrednictwem

Metoda IVsUserContext.GetAttributePri — (Int32, String, Int32, Int32, String, String)

  • Artykuł

 

Zwraca wartość określonego atrybutu lub słowa kluczowego ze zbioru kontekstu lub kontekst podrzędny na podstawie pozycji indeksu, nazwa lub priorytetu.

Przestrzeń nazw:   Microsoft.VisualStudio.Shell.Interop
Zestaw:  Microsoft.VisualStudio.Shell.Interop (w Microsoft.VisualStudio.Shell.Interop.dll)

Składnia

int GetAttributePri(
    int iAttribute,
    string pszName,
    int fIncludeChildren,
    out int piPriority,
    out string pbstrName,
    out string pbstrValue
)

int GetAttributePri(
    int iAttribute,
    String^ pszName,
    int fIncludeChildren,
    [OutAttribute] int% piPriority,
    [OutAttribute] String^% pbstrName,
    [OutAttribute] String^% pbstrValue
)

abstract GetAttributePri : 
        iAttribute:int *
        pszName:string *
        fIncludeChildren:int *
        piPriority:int byref *
        pbstrName:string byref *
        pbstrValue:string byref -> int

Function GetAttributePri (
    iAttribute As Integer,
    pszName As String,
    fIncludeChildren As Integer,
    <OutAttribute> ByRef piPriority As Integer,
    <OutAttribute> ByRef pbstrName As String,
    <OutAttribute> ByRef pbstrValue As String
) As Integer

Parametry

  • iAttribute
    Type: System.Int32

    [in] Indeks kolekcji atrybutów i słów kluczowych w zbiorze kontekstu lub kontekst podrzędny.

  • pszName
    Type: System.String

    [in] Nazwa atrybutu lub słowo kluczowe. Określ nazwę atrybutu, aby uzyskać dostęp do określonego atrybutu w zbiorze kontekstu lub kontekst podrzędny. Określ słowo kluczowe, aby uzyskać dostęp do F1 lub słowo kluczowe wyszukiwania.

  • fIncludeChildren
    Type: System.Int32

    [in] Jeśli true, zwracana kontekst podrzędny elementy skojarzone z zbioru kontekstu są również. Jeśli true, a następnie kontekst podrzędny jest wyłączona.

  • pbstrName
    Type: System.String

    [out] Wskaźnik do nazwy określonego atrybutu lub słowa kluczowego wartość, jeśli zostanie znalezione dopasowanie.

  • pbstrValue
    Type: System.String

    [out, retval] Wskaźnik do wartości określonego atrybutu lub słowa kluczowego tekstu, jeśli zostanie znalezione dopasowanie.

Wartość zwracana

Type: System.Int32

Jeśli metoda zakończy się pomyślnie, zwraca S_OK. Jeśli nie, zwraca kod błędu.

Uwagi

Podpis COM

Z context.idl:

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

Ta metoda jest bardzo podobny do GetAttribute metody, ale dodatkowo zwraca priorytet atrybutu lub słowa kluczowego w zbiorze kontekstu lub kontekst podrzędny. Istnieją trzy sposoby używania IVsUserContext.GetAttributePri metody:

  • Podawać null dla wartości pszName parametr i wszystkie atrybuty i słów kluczowych w kontekście lub za pomocą zbioru kontekst podrzędny iteracji iAttribute parametru. Można określić liczbę atrybutów i za pomocą słów kluczowych CountAttributes metody.

  • Iterowanie wszystkich atrybutów i słów kluczowych i podaj nazwę określonego atrybutu lub słowa kluczowego dla wartości pszName parametru. Nazwa atrybutu i wartości lub słowa kluczowego oraz wartości są zwracane w pbstrName i pbstrValue Parametry, odpowiednio, tylko jeśli podana nazwa pasuje do nazwy w zbiorze kontekstu lub kontekst podrzędny.

  • Podaj wartość -1 dla iAttribute parametr i nazwę określonego atrybutu lub słowa kluczowego dla wartości pszName parametru. Pierwszy atrybutu lub słowa kluczowego, który pasuje do nazwy jest zwracana.

Jeśli ta metoda znajdzie dopasowania do pszName parametru, a następnie go zwraca S_OK. Jeśli metoda nie znajdzie dopasowanie, następnie zwraca E_UNEXPECTED. W związku z tym można ustawić wartości jest piPriority, pbstrName i pbstrValue Parametry null i ocena powodzenie lub Niepowodzenie metody opartej na zwracane wartości.

Użyj GetAttrUsage można określić, czy słowa kluczowego zwracane z IVsUserContext.GetAttributePri jest metoda F1 lub słowo kluczowe wyszukiwania.

[!UWAGA]

Wartość fIncludeChildren parametru nie obowiązuje, jeśli zbiór kontekstu nie ma żadnych kontekst podrzędny.

Zobacz też

Interfejs IVsUserContext
Przestrzeń nazw Microsoft.VisualStudio.Shell.Interop

Powrót do początku