TextPatternRange.ScrollIntoView(Boolean) Metoda

Reference

Definice

Obor názvů:: System.Windows.Automation.Text

Sestavení:: UIAutomationClient.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Způsobí, že se ovládací prvek textu posune svisle, dokud se v oblasti zobrazení nezobrazí rozsah textu.

public:
 void ScrollIntoView(bool alignToTop);

public void ScrollIntoView (bool alignToTop);

member this.ScrollIntoView : bool -> unit

Public Sub ScrollIntoView (alignToTop As Boolean)

Parametry

alignToTop: Boolean

true Pokud textový ovládací prvek by měl být posunut tak, že rozsah textu je zarovnaný s horní části oblasti zobrazení; false pokud by měl být zarovnaný se spodní částí výřezu.

Výjimky

InvalidOperationException

Pokud ovládací prvek posouvání nepodporuje.

Příklady

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

Poznámky

ScrollIntoView respektuje skrytý i viditelný text. Klient automatizace uživatelského rozhraní může zkontrolovat IsHiddenAttribute viditelnost textu. Pokud je rozsah textu skrytý, textový ovládací prvek se posune jenom v případě, že má skrytý text v oblasti zobrazení ukotvení.

Platí pro

Sdílet prostřednictvím