TextPatternRange.GetText(Int32) Yöntem

Tanım

Ad Alanı:

System.Windows.Automation.Text

Bütünleştirilmiş Kod:

UIAutomationClient.dll

Metin aralığının düz metnini döndürür.

public:
 System::String ^ GetText(int maxLength);

public string GetText(int maxLength);

member this.GetText : int -> string

Public Function GetText (maxLength As Integer) As String

Parametreler

maxLength

Int32

Döndürülecek dizenin uzunluk üst sınırı. Sınır gerekmiyorsa kullanın -1 .

Döndürülenler

String

Metin aralığının düz metni, büyük olasılıkla belirtilen maxLengthkonumunda kesilmiştir.

Özel durumlar

ArgumentOutOfRangeException

-1'den küçükse maxLength .

Örnekler

 private String TextFromSelection(AutomationElement target, Int32 length)
{
    // 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;
    }
    TextPatternRange[] currentSelection = textpatternPattern.GetSelection();

    // GetText(-1) retrieves all characters but can be inefficient
    return currentSelection[0].GetText(length);
}

Private Function TextFromSelection(ByVal target As AutomationElement, ByVal length As Int32) As String
    ' 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()
    ' GetText(-1) retrieves all characters but can be inefficient
    Return currentSelection(0).GetText(length)
End Function

Açıklamalar

GetText hem gizli hem de görünür metne saygı gösterir. UI Otomasyonu istemcisi metin görünürlüğü için IsHiddenAttribute denetleyebilir.

Çağıranın metin aralığının uzunluğundan büyükse maxLength , döndürülen dize metin aralığının düz metni olur.

GetText metin akışındaki uç noktaların sıralamasından etkilenmez; her zaman metin aralığının Başlangıç ve Bitiş uç noktaları arasındaki metni mantıksal metin akış sırasına döndürür.

Ayrıca bkz.

• TextPatternRangeEndpoint