Condividi tramite


Metodo ITextView.DisplayTextLineContainingBufferPosition (SnapshotPoint, Double, ViewRelativePosition, Nullable<Double>, Nullable<Double>)

Formatta e visualizza il contenuto del buffer di testo in modo che ITextViewLine oggetto contenente la posizione del buffer specificata visualizzato nella posizione desiderata.

Spazio dei nomi:  Microsoft.VisualStudio.Text.Editor
Assembly:  Microsoft.VisualStudio.Text.UI (in Microsoft.VisualStudio.Text.UI.dll)

Sintassi

'Dichiarazione
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>
)

Parametri

  • verticalDistance
    Tipo: Double

    La distanza in pixel tra ITextViewLine e il bordo della visualizzazione. se relativeTo è uguale a ViewRelativePosition.Top, la distanza corrisponde alla parte superiore della visualizzazione all'inizio del ITextViewLine. In caso contrario, rappresenta la distanza dal bordo inferiore del ITextViewLine alla parte inferiore della visualizzazione.

    I valori negativi sono consentiti, che possono impedire la riga venga visualizzata all'esterno del riquadro di visualizzazione.

    Questo metodo può diventare piuttosto dispendioso se verticalDistance è maggiore. È consigliabile evitare di eseguire verticalDistance maggiore dell'altezza della visualizzazione.

  • viewportWidthOverride
    Tipo: Nullable<Double>

    Se specificato, il testo viene formattato come se il riquadro di visualizzazione disponesse della larghezza specificata.

  • viewportHeightOverride
    Tipo: Nullable<Double>

    Se specificato, il testo viene formattato come se il riquadro di visualizzazione disponesse di altezza specificata.

Eccezioni

Eccezione Condizione
ArgumentException

bufferPosition proviene da presentano ITextSnapshot o ITextBuffer.

ArgumentOutOfRangeException

relativeTo non è un valido ViewRelativePosition.

Note

Se il ritorno a capo automatico disabilitato nella visualizzazione, quindi ITextViewLine corrisponde all'intero ITextSnapshotLine contenente bufferPosition. Se il ritorno a capo automatico è abilitato nella visualizzazione, quindi ITextViewLine corrisponde alla parte di ITextSnapshotLine che contengono entrambe bufferPosition e rientri nella visualizzazione. bufferPosition non può essere il primo carattere in ITextViewLine. Il valore restituito è in genere uguale a verticalDistance, fatta eccezione per la visualizzazione è stata riposizionato per impedire un gap trovarsi all'inizio o dalla parte inferiore della visualizzazione. Chiamare questo metodo fa nella visualizzazione a avere la propria corrente TextViewLines. Override della larghezza del riquadro di visualizzazione non avranno effetto a meno che il ritorno a capo automatico è abilitato nella visualizzazione. Override di larghezza e altezza del riquadro di modifica solo quando il testo viene formattato per questa chiamata. Le chiamate successive utilizzeranno la larghezza e l'altezza del riquadro di visualizzazione (a meno che in modo esplicito eseguito l'override di una seconda volta).

Sicurezza di .NET Framework

Vedere anche

Riferimenti

ITextView Interfaccia

Overload DisplayTextLineContainingBufferPosition

Spazio dei nomi Microsoft.VisualStudio.Text.Editor