TextPatternRange.CompareEndpoints Metode

Definisi

Ruang nama:
System.Windows.Automation.Text
Rakitan:
UIAutomationClient.dll

Mengembalikan yang Int32 menunjukkan apakah dua rentang teks memiliki titik akhir yang identik.

public:
 int CompareEndpoints(System::Windows::Automation::Text::TextPatternRangeEndpoint endpoint, System::Windows::Automation::Text::TextPatternRange ^ targetRange, System::Windows::Automation::Text::TextPatternRangeEndpoint targetEndpoint);
public int CompareEndpoints(System.Windows.Automation.Text.TextPatternRangeEndpoint endpoint, System.Windows.Automation.Text.TextPatternRange targetRange, System.Windows.Automation.Text.TextPatternRangeEndpoint targetEndpoint);
member this.CompareEndpoints : System.Windows.Automation.Text.TextPatternRangeEndpoint * System.Windows.Automation.Text.TextPatternRange * System.Windows.Automation.Text.TextPatternRangeEndpoint -> int
Public Function CompareEndpoints (endpoint As TextPatternRangeEndpoint, targetRange As TextPatternRange, targetEndpoint As TextPatternRangeEndpoint) As Integer

Parameter

endpoint
TextPatternRangeEndpoint

Atau StartEnd titik akhir pemanggil.

targetRange
TextPatternRange

Rentang target untuk perbandingan.

targetEndpoint
TextPatternRangeEndpoint

Titik Start akhir atau End target.

Mengembalikan

Int32

Mengembalikan nilai negatif jika titik akhir penelepon terjadi sebelumnya dalam teks daripada titik akhir target.

Mengembalikan nol jika titik akhir penelepon berada di lokasi yang sama dengan titik akhir target.

Mengembalikan nilai positif jika titik akhir penelepon terjadi nanti dalam teks daripada titik akhir target.

Pengecualian

ArgumentNullException

Jika rentang adalah referensi null (Nothing dalam Visual Basic).

ArgumentException

Jika rentang berasal dari kontainer lain.

Contoh

private Int32 CompareRangeEndpoints(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 0;
    }
    TextPatternRange[] currentSelections = textpatternPattern.GetSelection();
    TextPatternRange[] currentVisibleRanges = textpatternPattern.GetVisibleRanges();
    return currentSelections[0].CompareEndpoints(
        TextPatternRangeEndpoint.Start, 
        currentVisibleRanges[0], 
        TextPatternRangeEndpoint.Start);
}

Private Function CompareRangeEndpoints(ByVal target As AutomationElement) As Integer
    ' 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
    Dim currentSelection As TextPatternRange() = textpatternPattern.GetSelection()
    Dim currentVisibleRanges As TextPatternRange() = textpatternPattern.GetVisibleRanges()
    Return currentSelection(0).CompareEndpoints(TextPatternRangeEndpoint.Start, _
                                         currentVisibleRanges(0), _
                                         TextPatternRangeEndpoint.Start)
End Function

Keterangan

Dengan membandingkan titik akhir awal dan akhir dari rentang teks yang sama, Anda dapat mengidentifikasi apakah rentang teks mengalami degenerasi atau jika titik akhir berada dalam urutan aliran teks logis.

Berlaku untuk

Lihat juga