Método IVsTextLines.GetLineData

Artigo
05/17/2015

Fornece acesso direto, orientado por linhas para o buffer de texto.

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

Sintaxe

'Declaração
Function GetLineData ( _
    iLine As Integer, _
    <OutAttribute> pLineData As LINEDATA(), _
    pMarkerData As MARKERDATA() _
) As Integer

int GetLineData(
    int iLine,
    LINEDATA[] pLineData,
    MARKERDATA[] pMarkerData
)

int GetLineData(
    [InAttribute] int iLine, 
    [OutAttribute] array<LINEDATA>^ pLineData, 
    [InAttribute] array<MARKERDATA>^ pMarkerData
)

abstract GetLineData : 
        iLine:int * 
        pLineData:LINEDATA[] byref * 
        pMarkerData:MARKERDATA[] -> int

function GetLineData(
    iLine : int, 
    pLineData : LINEDATA[], 
    pMarkerData : MARKERDATA[]
) : int

Parâmetros

iLine
Tipo: Int32

[in] Linha de buffer para acessar. Este é um valor baseado em zero.

pLineData
Tipo: array<Microsoft.VisualStudio.TextManager.Interop.LINEDATA[]

[in, out] Preenchido na LINEDATA estrutura. Isso é alocado pelo chamador e preenchido pelo GetLineData método.

pMarkerData
Tipo: array<Microsoft.VisualStudio.TextManager.Interop.MARKERDATA[]

[in, opcional] MARKERDATA estrutura. Use GetMarkerData para preencher o MARKERDATA estrutura para o intervalo de linha que você especificar. Se desejar que os atributos de marcador e coloração de sintaxe para retornar o LINEDATA estrutura (pLineData), você precisará passar neste parâmetro.

Valor de retorno

Tipo: 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 textmgr.idl:

HRESULT IVsTextLines::GetLineData(
   [in] long iLine,
   [out] LINEDATA *pLineData,
   [in] MARKERDATA *pMarkerData
);

Quando você chama IVsTextLines.GetLineData você é fornecidos com um ponteiro para os dados internos do buffer. Você só pode usar esse método para acessar uma linha no buffer de cada vez.

Esse método retorna dados para a linha em um LINEDATA estruturar e pode ser usado para teste de rapidamente o conteúdo de um buffer. Se você quiser ler o texto, linha por linha, ele é muito mais rápido para obter e ler LINEDATA não ser chamar os métodos CopyLineText ou GetLineText.

Dica

IVsTextLines.GetLineDatausa ponteiros para os dados internos do buffer.O buffer está congelado até que o ReleaseLineData método é chamado.Qualquer chamada bem sucedida a GetLineData deve chamar ReleaseLineData com o mesmo LINEDATA ponteiro.O parâmetro pMarkerData, se não-nulos, indica que os dados de atributo também são solicitados.O pMarkerData fornecido deve ser obtido por uma chamada anterior a GetMarkerData método.

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiável.

Consulte também

Referência

IVsTextLines Interface

Namespace Microsoft.VisualStudio.TextManager.Interop

Partilhar via