TextPointer.GetTextInRun Metoda

Definicja

Przestrzeń nazw:

System.Windows.Documents

Zestaw:

PresentationFramework.dll

Zwraca tekst przylegający do bieżącego TextPointerelementu .

Przeciążenia

GetTextInRun(LogicalDirection)	Zwraca ciąg zawierający dowolny tekst przylegający do bieżącego TextPointer w określonym kierunku logicznym.
GetTextInRun(LogicalDirection, Char[], Int32, Int32)	Kopiuje określoną maksymalną liczbę znaków z dowolnego sąsiedniego tekstu w określonym kierunku do tablicy znaków dostarczonej przez obiekt wywołujący.

GetTextInRun(LogicalDirection)

Zwraca ciąg zawierający dowolny tekst przylegający do bieżącego TextPointer w określonym kierunku logicznym.

public:
 System::String ^ GetTextInRun(System::Windows::Documents::LogicalDirection direction);

public string GetTextInRun (System.Windows.Documents.LogicalDirection direction);

member this.GetTextInRun : System.Windows.Documents.LogicalDirection -> string

Public Function GetTextInRun (direction As LogicalDirection) As String

Parametry

direction

LogicalDirection

LogicalDirection Jedna z wartości określających kierunek logiczny, w którym ma znajdować i zwracać dowolny sąsiedni tekst.

Zwraca

String

Ciąg zawierający dowolny sąsiedni tekst w określonym kierunku logicznym lub Empty jeśli nie można odnaleźć sąsiedniego tekstu.

Przykłady

W poniższym przykładzie pokazano użycie tej metody. W przykładzie użyto GetTextInRun metody w celu zaimplementowania prostego wyodrębniania tekstu. Metoda zwraca łączenie ciągu ze wszystkim tekstem między dwoma określonymi TextPointer wystąpieniami.

Chociaż przykład może służyć do wyodrębniania dowolnego tekstu między dwoma TextPointer wystąpieniami, jest przeznaczony tylko do celów ilustracyjnych i nie powinien być używany w kodzie produkcyjnym. TextRange.Text Zamiast tego użyj właściwości .

// Returns a string containing the text content between two specified TextPointers.
string GetTextBetweenTextPointers(TextPointer start, TextPointer end)
{
    StringBuilder buffer = new StringBuilder();
 
    while (start != null && start.CompareTo(end) < 0)
    {
        if (start.GetPointerContext(LogicalDirection.Forward) == TextPointerContext.Text)
            buffer.Append(start.GetTextInRun(LogicalDirection.Forward));
 
        // Note that when the TextPointer points into a text run, this skips over the entire
        // run, not just the current character in the run.
        start = start.GetNextContextPosition(LogicalDirection.Forward);
    }
    return buffer.ToString();
} // End GetTextBetweenPointers.

' Returns a string containing the text content between two specified TextPointers.
Private Function GetTextBetweenTextPointers(ByVal start As TextPointer, ByVal [end] As TextPointer) As String
    Dim buffer As New StringBuilder()

    Do While start IsNot Nothing AndAlso start.CompareTo([end]) < 0
        If start.GetPointerContext(LogicalDirection.Forward) = TextPointerContext.Text Then
            buffer.Append(start.GetTextInRun(LogicalDirection.Forward))
        End If

        ' Note that when the TextPointer points into a text run, this skips over the entire
        ' run, not just the current character in the run.
        start = start.GetNextContextPosition(LogicalDirection.Forward)
    Loop
    Return buffer.ToString()

End Function ' End GetTextBetweenPointers.

Uwagi

Ta metoda zwraca tylko nieprzerwane przebiegi tekstu. Nic nie jest zwracane, jeśli jakikolwiek typ symbolu inny niż Text sąsiaduje z prądem TextPointer w określonym kierunku. Podobnie tekst jest zwracany tylko do następnego symbolu innego niż tekst.

Zobacz też

• DeleteTextInRun(Int32)
• InsertTextInRun(String)

GetTextInRun(LogicalDirection, Char[], Int32, Int32)

Kopiuje określoną maksymalną liczbę znaków z dowolnego sąsiedniego tekstu w określonym kierunku do tablicy znaków dostarczonej przez obiekt wywołujący.

public:
 int GetTextInRun(System::Windows::Documents::LogicalDirection direction, cli::array <char> ^ textBuffer, int startIndex, int count);

public int GetTextInRun (System.Windows.Documents.LogicalDirection direction, char[] textBuffer, int startIndex, int count);

member this.GetTextInRun : System.Windows.Documents.LogicalDirection * char[] * int * int -> int

Public Function GetTextInRun (direction As LogicalDirection, textBuffer As Char(), startIndex As Integer, count As Integer) As Integer

Parametry

direction

LogicalDirection

LogicalDirection Jedna z wartości określających kierunek logiczny, w którym ma znajdować i kopiować dowolny sąsiedni tekst.

textBuffer

Char[]

Bufor, do którego jest kopiowany dowolny tekst.

startIndex

Int32

Indeks, do textBuffer którego ma rozpocząć pisanie skopiowanego tekstu.

count

Int32

Maksymalna liczba znaków do skopiowania.

Zwraca

Int32

Liczba znaków faktycznie skopiowanych do .textBuffer

Wyjątki

ArgumentException

startIndex wartość jest mniejsza niż 0 lub większa niż Length właściwość textBuffer.

-lub-

count wartość jest mniejsza niż 0 lub większa niż pozostałe miejsce w textBuffer obiekcie (textBuffer.Length minus startIndex).

Uwagi

Ta metoda zwraca tylko nieprzerwane przebiegi tekstu. Nic nie jest zwracane, jeśli jakikolwiek typ symbolu inny niż Text sąsiaduje z prądem TextPointer w określonym kierunku. Podobnie tekst jest zwracany tylko do następnego symbolu innego niż tekst.

Zobacz też

• DeleteTextInRun(Int32)
• InsertTextInRun(String)