TextPattern.GetVisibleRanges Metoda

Definicja

Przestrzeń nazw:

System.Windows.Automation

Zestaw:

UIAutomationClient.dll

Pobiera tablicę rozłącznych zakresów tekstu z kontenera tekstu, w którym każdy zakres tekstu zaczyna się od pierwszego częściowo widocznego wiersza na końcu ostatniego częściowo widocznego wiersza.

public:
 cli::array <System::Windows::Automation::Text::TextPatternRange ^> ^ GetVisibleRanges();

public System.Windows.Automation.Text.TextPatternRange[] GetVisibleRanges ();

member this.GetVisibleRanges : unit -> System.Windows.Automation.Text.TextPatternRange[]

Public Function GetVisibleRanges () As TextPatternRange()

Zwraca

TextPatternRange[]

Kolekcja widocznych zakresów tekstu w kontenerze lub pustej tablicy. Null nigdy nie jest zwracany.

Przykłady

private TextPatternRange[] CurrentVisibleRanges(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 null;
    }
    return textpatternPattern.GetVisibleRanges();
}

Private Function CurrentVisibleRanges(ByVal target As AutomationElement) As TextPatternRange()
    ' 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 Nothing
    End If

    Return textpatternPattern.GetVisibleRanges()
End Function

Uwagi

Rozłączne zakresy tekstu mogą wystąpić, gdy dowolna zawartość kontenera tekstu jest zaciemniana przez nakładające się okno lub inny obiekt albo gdy kontener tekstu z układem wielokolumna ma co najmniej jedną kolumnę częściowo przewijaną z widoku.

Jeśli żaden tekst nie jest widoczny, zwracany jest degenerowany (pusty) zakres tekstu. Ten pusty zakres można zwrócić, jeśli kontener tekstu jest pusty lub gdy cały tekst zostanie przewinięty z widoku.

Zobacz też

• TextPatternRange