Método ITextView.DisplayTextLineContainingBufferPosition (SnapshotPoint, Double, ViewRelativePosition, Nullable<Double>, Nullable<Double>)

Formata e exibe o conteúdo do buffer de texto para que o ITextViewLine que contém a posição do buffer especificado é exibido na posição desejada.

Namespace:  Microsoft.VisualStudio.Text.Editor
Assembly:  Microsoft.VisualStudio.Text.UI (em Microsoft.VisualStudio.Text.UI.dll)

Sintaxe

'Declaração
Sub DisplayTextLineContainingBufferPosition ( _
    bufferPosition As SnapshotPoint, _
    verticalDistance As Double, _
    relativeTo As ViewRelativePosition, _
    viewportWidthOverride As Nullable(Of Double), _
    viewportHeightOverride As Nullable(Of Double) _
)

void DisplayTextLineContainingBufferPosition(
    SnapshotPoint bufferPosition,
    double verticalDistance,
    ViewRelativePosition relativeTo,
    Nullable<double> viewportWidthOverride,
    Nullable<double> viewportHeightOverride
)

void DisplayTextLineContainingBufferPosition(
    SnapshotPoint bufferPosition, 
    double verticalDistance, 
    ViewRelativePosition relativeTo, 
    Nullable<double> viewportWidthOverride, 
    Nullable<double> viewportHeightOverride
)

abstract DisplayTextLineContainingBufferPosition : 
        bufferPosition:SnapshotPoint * 
        verticalDistance:float * 
        relativeTo:ViewRelativePosition * 
        viewportWidthOverride:Nullable<float> * 
        viewportHeightOverride:Nullable<float> -> unit

function DisplayTextLineContainingBufferPosition(
    bufferPosition : SnapshotPoint, 
    verticalDistance : double, 
    relativeTo : ViewRelativePosition, 
    viewportWidthOverride : Nullable<double>, 
    viewportHeightOverride : Nullable<double>
)

Parâmetros

• bufferPosition
  Tipo: Microsoft.VisualStudio.Text.SnapshotPoint

  A posição do caractere que deve estar contido na ITextViewLine exibida na posição vertical especificada.

• verticalDistance
  Tipo: Double

  A distância (em pixels) entre a ITextViewLine e a borda do modo de exibição. Se relativeTo é igual a ViewRelativePosition.Top, e em seguida, a distância é da parte superior do modo de exibição para o topo da ITextViewLine. Caso contrário, ele é a distância da parte inferior da ITextViewLine para a parte inferior no modo de exibição.

  Valores negativos são permitidos, que pode causar a linha a ser exibido fora da porta de visualização.

  Esse método pode ficar bastante caro se verticalDistance é grande. Você deve evitar a tomada de verticalDistance maior que a altura do modo de exibição.

• relativeTo
  Tipo: Microsoft.VisualStudio.Text.Editor.ViewRelativePosition

  O ViewRelativePosition.

• viewportWidthOverride
  Tipo: Nullable<Double>

  Se especificado, o texto é formatado como se o visor tinha a largura especificada.

• viewportHeightOverride
  Tipo: Nullable<Double>

  Se especificado, o texto é formatado como se o visor tinha a altura especificada.

Exceções

Exceção	Condição
ArgumentException	bufferPositioné de errado ITextSnapshot ou ITextBuffer.
ArgumentOutOfRangeException	relativeTonão é válido ViewRelativePosition.

Comentários

Se a quebra automática está desativada no modo de exibição, em seguida, a ITextViewLine corresponde a toda a ITextSnapshotLine que contém bufferPosition. Se a quebra automática está habilitada no modo de exibição, em seguida, a ITextViewLine corresponde à parte do ITextSnapshotLine que contenha bufferPosition e o modo de exibição se encaixa. bufferPositionTalvez não seja o primeiro caractere da ITextViewLine. O valor retornado é geralmente igual a verticalDistance, exceto onde o modo de exibição foi reposicionado para impedir que uma lacuna que aparecem na parte superior ou inferior do modo de exibição. Chamar esse método faz com que o modo de exibição para dispor de seus TextViewLines. A substituição de largura de visor só terá efeito a menos que a quebra automática está habilitada no modo de exibição. A largura e altura de visor substitui apenas alterar como o texto é formatado para esta chamada. As chamadas subseqüentes usarão a largura e altura de seu (a menos que explicitamente substituída pela segunda vez).

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

ITextView Interface

Sobrecargas DisplayTextLineContainingBufferPosition

Namespace Microsoft.VisualStudio.Text.Editor