IVsUserContext.GetAttribute – metoda (Int32, String, Int32, String, String)

Článek
08/05/2016

Vrátí z vaku kontext nebo kontext na základě pozice indexu nebo název zadaný atribut nebo klíčové slovo.

Obor názvů: Microsoft.VisualStudio.Shell.Interop
Sestavení: Microsoft.VisualStudio.Shell.Interop (v Microsoft.VisualStudio.Shell.Interop.dll)

Syntaxe

int GetAttribute(
    int iAttribute,
    string pszName,
    int fIncludeChildren,
    out string pbstrName,
    out string pbstrValue
)

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

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

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

Parametry

iAttribute
[v] Index do kolekce atributů a klíčová slova ve vaku kontext nebo kontext.

pszName
[v] Název atributu nebo klíčové slovo.Zadejte název atributu přístup určitý atribut.Zadejte "klíčové slovo" přístup F1 nebo vyhledat klíčové slovo.

fIncludeChildren
[v] Pokud true, vrácena kontext vaky přidružené k vaku kontextu jsou také.Pokud false, pak je vyloučeno kontext.

pbstrName
[výstup] Ukazatel na určitý atribut názvu nebo klíčové hodnoty, pokud je nalezena shoda.

pbstrValue
[out retval] Ukazatel hodnota určitého atributu nebo klíčové slovo text, pokud je nalezena shoda.

Vrácená hodnota

Type: System.Int32

Pokud metoda uspěje, vrací S_OK.Pokud se nezdaří, vrátí kód chyby.

Poznámky

Podpis COM

Z context.idl:

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

Existují tři různé způsoby použití IVsUserContext.GetAttribute metoda:

Průchod v null pro hodnotu pszName parametr a iterovat všechny atributy a klíčová slova v kontextu pomocí vaku iAttribute parametr.Můžete určit počet atributů a klíčová slova v kontext nebo kontext pytel pomocí CountAttributes metoda.
Iterovat všechny atributy a klíčová slova a předejte klíčové slovo nebo název určitého atributu pro hodnotu pszName parametr.Název atributu a hodnoty nebo klíčové slovo a hodnoty jsou vráceny v pbstrName a pbstrValue parametry, pouze pokud název podle odpovídající název ve vaku kontext nebo kontext.
Hodnota-1 pro předání iAttribute parametr a název určitý atribut nebo hodnota klíčového slova pszName parametr.První atribut nebo klíčové slovo, který odpovídá názvu je vrácena.

Pokud tato metoda najde odpovídající pszName parametr, pak vrátí S_OK.Pokud metoda není nalezena shoda, je vrátí E_UNEXPECTED.Proto je možné nastavit hodnoty *pbstrName a *pbstrValue parametry null a vyhodnocení úspěchu nebo selhání metody založené na vrácené hodnoty.

Použití GetAttributePri metoda přístupu atributy nebo klíčová slova na základě jejich priority.Další informace o prioritu viz VSUSERCONTEXTPRIORITY.Použití GetAttrUsage metoda k určení, zda klíčové slovo vrátil IVsUserContext::GetAttribute metoda je F1 nebo vyhledat klíčové slovo.

Hodnota fIncludeChildren parametr nemá žádný účinek, pokud vaku kontextu nemá žádné kontext.

Viz také

IVsUserContext – rozhraní
Microsoft.VisualStudio.Shell.Interop – obor názvů

Zpátky na začátek

Sdílet prostřednictvím