ITextView.DisplayTextLineContainingBufferPosition, méthode (SnapshotPoint, Double, ViewRelativePosition)

  • Article

Met en forme et affiche le contenu de la mémoire tampon de texte afin qu'ITextViewLine contenant la position dans la mémoire tampon soit affiché à l'emplacement souhaité.

Espace de noms :  Microsoft.VisualStudio.Text.Editor
Assembly :  Microsoft.VisualStudio.Text.UI (dans Microsoft.VisualStudio.Text.UI.dll)

Syntaxe

'Déclaration
Sub DisplayTextLineContainingBufferPosition ( _
    bufferPosition As SnapshotPoint, _
    verticalDistance As Double, _
    relativeTo As ViewRelativePosition _
)

void DisplayTextLineContainingBufferPosition(
    SnapshotPoint bufferPosition,
    double verticalDistance,
    ViewRelativePosition relativeTo
)

void DisplayTextLineContainingBufferPosition(
    SnapshotPoint bufferPosition, 
    double verticalDistance, 
    ViewRelativePosition relativeTo
)

abstract DisplayTextLineContainingBufferPosition : 
        bufferPosition:SnapshotPoint * 
        verticalDistance:float * 
        relativeTo:ViewRelativePosition -> unit

function DisplayTextLineContainingBufferPosition(
    bufferPosition : SnapshotPoint, 
    verticalDistance : double, 
    relativeTo : ViewRelativePosition
)

Paramètres

  • verticalDistance
    Type : Double

    Distance en pixels séparant l'élément ITextViewLine et le bord de la vue. Si l'élément relativeTo a la valeur ViewRelativePosition.Top, la distance calculée est celle séparant le haut de la vue et le haut de l'élément ITextViewLine. Sinon, il s'agit de la distance séparant le bas de l'élément ITextViewLine et le bas de la vue.

    Il permet des valeurs négatives, qui peuvent provoquer la ligne à afficher en dehors de la fenêtre d'affichage.

    Cette méthode peut devenir assez lourde si l'élément verticalDistance est important. Évitez que l'élément verticalDistance soit supérieur à la hauteur de la vue.

Exceptions

Exception Condition
ArgumentException

bufferPosition est d'ITextSnapshot incorrect ou d'ITextBuffer.
ArgumentOutOfRangeException

relativeTo n'est pas un ViewRelativePosition valide.

Notes

Si le retour automatique à la ligne est désactivé dans la vue, alors ITextViewLine correspond à ITextSnapshotLine entier qui contient bufferPosition. Si le retour automatique à la ligne est activé dans la vue, alors ITextViewLine correspond à la partie d'ITextSnapshotLine que contient bufferPosition et s'insère dans la vue. bufferPosition peut ne pas être le premier personnage dans ITextViewLine. La valeur retournée est en général égale à verticalDistance, sauf lorsque la vue a été repositionnée pour empêcher un intervalle d'apparaître en haut ou en bas de la vue. Appeler cette méthode fait de ne pas autoriser la vue son TextViewLines actuel.

Sécurité .NET Framework

Voir aussi

Référence

ITextView Interface

DisplayTextLineContainingBufferPosition, surcharge

Microsoft.VisualStudio.Text.Editor, espace de noms