Método IVsUserContext.GetAttributePri (Int32, String, Int32, Int32, String, String)

Artigo
08/03/2016

Publicado: abril de 2016

Retorna um atributo especificado ou a palavra-chave do conjunto de contexto ou subcontexto com base na posição de índice, nome ou prioridade.

Namespace: Microsoft.VisualStudio.Shell.Interop
Assembly: Microsoft.VisualStudio.Shell.Interop (em Microsoft.VisualStudio.Shell.Interop.dll)

Sintaxe

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

Parâmetros

iAttribute
[in] Indexar na coleção de atributos e palavras-chave na maleta contexto ou subcontexto.

pszName
[in] Nome do atributo ou palavra-chave.Especifique o nome de atributo para acessar um atributo específico na maleta contexto ou subcontexto.Especificar a palavra-chave para acessar um F1 ou procurar a palavra-chave.

fIncludeChildren
[in] Se true, e em seguida, os elementos de subcontexto associados com o conjunto de propriedades de contexto também são retornados.Se true, e em seguida, o subcontexto é excluído.

piPriority
[out] Prioridade do atributo ou palavra-chave.Para obter uma lista de piPriority valores, consulte VSUSERCONTEXTPRIORITY.

pbstrName
[out] Ponteiro para o nome de atributo específico ou a palavra chave valor, se uma correspondência for encontrada.

pbstrValue
[out, retval] Ponteiro para o valor de atributo específico ou o texto de palavra-chave, se uma correspondência for encontrada.

Valor de retorno

Type: System.Int32

Se o método for bem-sucedido, ele retorna S_OK.Se ele falhar, ele retorna um código de erro.

Comentários

COM assinatura

De context.idl:

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

Este método é muito semelhante do GetAttribute método, mas Além disso, retorna a prioridade do atributo ou palavra-chave na maleta contexto ou subcontexto.Existem três maneiras diferentes de usar o IVsUserContext.GetAttributePri método:

Passar na null o valor para o pszName parâmetro e iterar em todos os atributos e palavras-chave no contexto ou usando o subcontexto saco o iAttribute parâmetro.Você pode determinar a contagem de atributos e palavras-chave usando o CountAttributes método.
Iterar em todos os atributos e palavras-chave e passe um nome de atributo específico ou a palavra-chave para o valor da pszName parâmetro.Um nome de atributo e o valor ou a palavra-chave e o valor são retornados a pbstrName e pbstrValue parâmetros, respectivamente, somente se o nome fornecido correspondem ao nome no conjunto de contexto ou subcontexto.
Passar um valor -1 para o iAttribute parâmetro e um nome de atributo específico ou a palavra-chave para o valor da pszName parâmetro.O primeiro atributo ou palavra-chave que corresponda ao nome é retornado.

Se esse método encontra uma correspondência para o pszName parâmetro, em seguida, ele retorna S_OK.Se não encontrar uma correspondência, o método retorna E_UNEXPECTED.Assim, é possível definir os valores da piPriority, pbstrName e pbstrValue parâmetros para null e avaliar o êxito ou falha do método com base nos valores de retorno.

Use o GetAttrUsage método para determinar se a palavra-chave retornado do IVsUserContext.GetAttributePri método é um F1 ou procurar a palavra-chave.

Observação
O valor da fIncludeChildren parâmetro não tem efeito se a bolsa de contexto não tem qualquer subcontexto.

Consulte também

Interface IVsUserContext
Namespace Microsoft.VisualStudio.Shell.Interop

Retornar ao topo

Partilhar via