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

  • 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 spécifiée 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, _
    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>
)

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.

  • viewportWidthOverride
    Type : Nullable<Double>

    Si cela est spécifié, le texte est mis en forme comme si la fenêtre d'affichage avait la largeur spécifiée.

  • viewportHeightOverride
    Type : Nullable<Double>

    Si cela est spécifié, le texte est mis en forme comme si la fenêtre d'affichage avait la hauteur spécifiée.

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 dans 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. La substitution de largeur de fenêtre d'affichage n'aura aucun effet sauf si le retour automatique à la ligne soit activé dans la vue. La seule modification de priorités de hauteur et de largeur de fenêtre d'affichage comment le texte est mis en forme pour cet appel. Les appels suivants utiliseront la largeur et la hauteur de la fenêtre d'affichage (à moins qu'explicitement substitué une deuxième fois).

Sécurité .NET Framework

Voir aussi

Référence

ITextView Interface

DisplayTextLineContainingBufferPosition, surcharge

Microsoft.VisualStudio.Text.Editor, espace de noms