TextPatternRange.ScrollIntoView(Boolean) Yöntem

Tanım

Ad Alanı:

System.Windows.Automation.Text

Bütünleştirilmiş Kod:

UIAutomationClient.dll

Metin aralığı görünüm penceresi içinde görünene kadar metin denetiminin dikey olarak kaydırmasına neden olur.

public:
 void ScrollIntoView(bool alignToTop);

public void ScrollIntoView(bool alignToTop);

member this.ScrollIntoView : bool -> unit

Public Sub ScrollIntoView (alignToTop As Boolean)

Parametreler

alignToTop

Boolean

true metin denetiminin kaydırılması gerekiyorsa, metin aralığı görünüm penceresinin üst kısmıyla temizlenecek şekilde kaydırılır; false görünüm penceresinin alt kısmıyla birlikte temizlenmelidir.

Özel durumlar

InvalidOperationException

Kaydırma denetimi tarafından desteklenmiyorsa.

Örnekler

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

Açıklamalar

ScrollIntoView hem gizli hem de görünür metne saygı gösterir. UI Otomasyonu istemcisi metin görünürlüğü için IsHiddenAttribute denetleyebilir. Metin aralığı gizliyse, metin denetimi yalnızca gizli metnin görünüm penceresi içinde bir tutturucu olması durumunda kaydırılır.