IVsUserContext.GetAttributePri Yöntem (Int32, String, Int32, Int32, String, String)

Makale
08/08/2016

Belirli bir öznitelik veya anahtar sözcüğü dizin konumu, adı ve önceliğe göre bağlamı veya alt bağlam paketi döndürür.

Ad Alanı: Microsoft.VisualStudio.Shell.Interop
Derleme: Microsoft.VisualStudio.Shell.Interop (Microsoft.VisualStudio.Shell.Interop.dll içinde)

Sözdizimi

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

Parametreler

iAttribute
Type: System.Int32

[in] Öznitelikler ve anahtar sözcükler bağlamı veya alt bağlam pakette koleksiyonuna dizin.

pszName
Type: System.String

[in] Öznitelik adı veya anahtar sözcüğü. Belirli bir öznitelik bağlamı veya alt bağlam pakette erişmek için öznitelik adı belirtin. Anahtar sözcüğü erişmek için belirtin bir F1 veya arama anahtar sözcüğü.

fIncludeChildren
Type: System.Int32

[in] Varsa true, sonra da içerik paketi ile ilişkili alt bağlam öğeleri de döndürülür. Varsa true, alt bağlam hariç sonra.

piPriority
Type: System.Int32

[out] Öznitelik veya anahtar sözcüğü önceliği. Bir listesi için piPriority değerler, bakın VSUSERCONTEXTPRIORITY.

pbstrName
Type: System.String

[out] Belirli bir öznitelik adı veya bir eşleşme bulunursa, değer anahtar sözcüğü, işaretçi.

pbstrValue
Type: System.String

[out, retval] Belirli bir öznitelik değeri veya bir eşleşme bulunursa, anahtar sözcüğü metin işaretçisi.

Dönüş Değeri

Type: System.Int32

Yöntem başarılı olursa, döndürür S_OK. Başarısız olursa, bir hata kodu döndürür.

Notlar

COM imza

Context.idl:

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

Bu yöntem çok benzer GetAttribute yöntemi, ancak ek olarak içerik veya alt bağlam paketindeki öznitelik veya anahtar sözcüğü önceliğini döndürür. Kullanmak için üç farklı yolu vardır IVsUserContext.GetAttributePri yöntemi:

Geçirin null değerini pszName parametre ve tüm öznitelikleri ve anahtar sözcükleri bağlamı veya alt bağlam paketi kullanarak yinelemek iAttribute parametresi. Öznitelikler ve anahtar sözcükler kullanılarak sayısını belirleyebilirsiniz CountAttributes yöntemi.
Tüm öznitelikleri ve anahtar sözcükleri yineleme yapma ve değeri için bir özel öznitelik adı veya anahtar sözcüğü geçirmesi pszName parametresi. Bir öznitelik adı ve değeri veya anahtar ve değer döndürülür pbstrName ve pbstrValue parametreleri, sırasıyla, adı, sağladıysanız eşleşen bağlamı veya alt bağlam pakette adı.
Geçirmek için -1 değeri iAttribute parametresi ve belirli bir öznitelik adı veya değeri için anahtar sözcüğü pszName parametresi. İlk öznitelik veya adıyla eşleşen anahtar sözcüğü döndürülür.

Bu yöntem için bir eşleşme bulursa pszName parametresi, ardından S_OK döndürür. Ardından yöntemi bir eşleşme bulamazsa, E_UNEXPECTED döndürür. Bu nedenle, bu değerleri ayarlamak mümkündür piPriority, pbstrName ve pbstrValue parametreleri null ve başarı veya başarısızlık yöntemin dönüş değerlerine göre değerlendirin.

Kullanım GetAttrUsage anahtar sözcüğü döndürülen olup olmadığını belirlemek için yöntemi IVsUserContext.GetAttributePri yöntemi bir F1 veya arama anahtar sözcüğü.

[!NOT]

Değeri fIncludeChildren parametresi hiçbir etkisi içerik paketi herhangi bir alt bağlam yoksa.

Ayrıca bkz.

IVsUserContext Arabirim
Microsoft.VisualStudio.Shell.Interop Ad Alanı

Başa dön

Aracılığıyla paylaş