TextPatternRange.CompareEndpoints Metoda

Definice

Obor názvů:

System.Windows.Automation.Text

Sestavení:

UIAutomationClient.dll

Int32 Vrátí indikující, jestli mají dvě rozsahy textu identické koncové body.

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

Parametry

endpoint

TextPatternRangeEndpoint

Volajícího Start nebo End koncový bod.

targetRange

TextPatternRange

Cílový rozsah pro porovnání.

targetEndpoint

TextPatternRangeEndpoint

Cíl Start nebo End koncový bod.

Návraty

Int32

Vrátí zápornou hodnotu, pokud koncový bod volajícího nastane dříve v textu než cílový koncový bod.

Vrátí nulu, pokud je koncový bod volajícího ve stejném umístění jako cílový koncový bod.

Vrátí kladnou hodnotu, pokud koncový bod volajícího nastane později v textu než cílový koncový bod.

Výjimky

ArgumentNullException

Pokud je oblast nulovým odkazem (Nothingv Visual Basic).

ArgumentException

Pokud je rozsah z jiného kontejneru.

Příklady

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

Poznámky

Porovnáním počátečních a koncových koncových bodů stejného rozsahu textu můžete zjistit, jestli je oblast textu degenerovaná nebo jestli jsou koncové body v pořadí logického toku textu.

Viz také

• TextPatternRangeEndpoint