TextPatternRange.CompareEndpoints Methode

Definitie

Naamruimte:
System.Windows.Automation.Text
Assembly:
UIAutomationClient.dll

Retourneert een Int32 aanduiding die aangeeft of twee tekstbereiken identieke eindpunten hebben.

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

Parameters

endpoint
TextPatternRangeEndpoint

Het Start of End eindpunt van de beller.

targetRange
TextPatternRange

Het doelbereik voor vergelijking.

targetEndpoint
TextPatternRangeEndpoint

Het Start of End eindpunt van het doel.

Retouren

Int32

Retourneert een negatieve waarde als het eindpunt van de aanroeper eerder in de tekst voorkomt dan het doeleindpunt.

Retourneert nul als het eindpunt van de beller zich op dezelfde locatie bevindt als het doeleindpunt.

Retourneert een positieve waarde als het eindpunt van de beller zich later in de tekst voordoet dan het doeleindpunt.

Uitzonderingen

ArgumentNullException

Als het bereik een null-verwijzing is (Nothing in Visual Basic).

ArgumentException

Als het bereik afkomstig is van een andere container.

Voorbeelden

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

Opmerkingen

Door de begin- en eindeindpunten van hetzelfde tekstbereik te vergelijken, kunt u bepalen of een tekstbereik is ontaard of als de eindpunten zich in de volgorde van logische tekststroom bevinden.

Van toepassing op

Zie ook