Langue

TextPatternRange.ScrollIntoView(Boolean) Méthode

Définition

Espace de noms:
System.Windows.Automation.Text
Assembly:
UIAutomationClient.dll

Provoque le défilement vertical du contrôle de texte jusqu’à ce que la plage de texte soit visible dans la fenêtre d’affichage.

public:
 void ScrollIntoView(bool alignToTop);
public void ScrollIntoView(bool alignToTop);
member this.ScrollIntoView : bool -> unit
Public Sub ScrollIntoView (alignToTop As Boolean)

Paramètres

alignToTop
Boolean

true si le contrôle de texte doit faire défiler la plage de texte afin que la plage de texte soit vidée en haut de la fenêtre d’affichage ; false s’il doit être vidé avec le bas de la fenêtre d’affichage.

Exceptions

InvalidOperationException

Si le défilement n’est pas pris en charge par le contrôle.

Exemples

private void ScrollToSelection(AutomationElement target)
{
    // Specify the control type we're looking for, in this case 'Document'
    PropertyCondition cond = new PropertyCondition(AutomationElement.ControlTypeProperty, ControlType.Document);

    // target --> The root AutomationElement.
    AutomationElement textProvider = target.FindFirst(TreeScope.Descendants, cond);

    TextPattern textpatternPattern = textProvider.GetCurrentPattern(TextPattern.Pattern) as TextPattern;

    if (textpatternPattern == null)
    {
        Console.WriteLine("Root element does not contain a descendant that supports TextPattern.");
        return;
    }
    TextPatternRange[] currentSelection = textpatternPattern.GetSelection();

    currentSelection[0].ScrollIntoView(true);
}

Private Sub ScrollToSelection(ByVal target As AutomationElement)
    ' Specify the control type we're looking for, in this case 'Document'
    Dim cond As PropertyCondition = New PropertyCondition(AutomationElement.ControlTypeProperty, ControlType.Document)

    ' target --> The root AutomationElement.
    Dim textProvider As AutomationElement = target.FindFirst(TreeScope.Descendants, cond)

    Dim textpatternPattern As TextPattern = CType(textProvider.GetCurrentPattern(TextPattern.Pattern), TextPattern)

    If (textpatternPattern Is Nothing) Then
        Console.WriteLine("Root element does not contain a descendant that supports TextPattern.")
        Return
    End If
    Dim currentSelection As TextPatternRange() = textpatternPattern.GetSelection()
    currentSelection(0).ScrollIntoView(True)
End Sub

Remarques

ScrollIntoView respecte le texte masqué et visible. Le client UI Automation peut vérifier la visibilité du texte IsHiddenAttribute. Si la plage de texte est masquée, le contrôle de texte défile uniquement si le texte masqué a une ancre dans la fenêtre d’affichage.

S’applique à