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

Makale
08/08/2016

Belirtilen öznitelik veya anahtar sözcüğü dizin konumu veya adı temel 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 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

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 erişmek için öznitelik adı belirtin. "Anahtar sözcüğü" erişimi 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 paketleri de döndürülür. Varsa false, sonra üzere tutulur.

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::GetAttribute(
   [in] int iAttribute,
   [in] LPCOLESTR pszName,
   [in] BOOL fIncludeChildren,
   [out] BSTR * pbstrName,
   [out, retval] BSTR * pbstrValue
);

Kullanmak için üç farklı yolu vardır IVsUserContext.GetAttribute yöntemi:

Geçirin null değerini pszName parametre ve tüm öznitelikleri ve bağlamı kullanarak paketi anahtar sözcükleri yinelemek iAttribute parametresi. Öznitelikleri sayısını belirleyebilirsiniz ve anahtar sözcükleri bağlamı veya alt bağlam paket kullanarak 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 anahtar sözcüğü değerini 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 bulduğunda pszName parametresi, ardından döndürür S_OK. Yöntemi bir eşleşme bulamaz sonra döndürür E_UNEXPECTED. Bu nedenle, bu değerleri ayarlamak mümkündür *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 GetAttributePri kendi önceliğe göre erişim özniteliklerine veya anahtar sözcükler için yöntemi. Öncelik hakkında daha fazla bilgi için bkz: VSUSERCONTEXTPRIORITY. Kullanım GetAttrUsage yöntemi bir anahtar sözcük döndürülen olup olmadığını belirlemek için IVsUserContext::GetAttribute yöntemi bir F1 veya arama anahtar sözcüğü.

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ş