RichTextBox.CaretPosition Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft die Position der Einfügemarke ab oder legt diese fest.
public:
property System::Windows::Documents::TextPointer ^ CaretPosition { System::Windows::Documents::TextPointer ^ get(); void set(System::Windows::Documents::TextPointer ^ value); };public System.Windows.Documents.TextPointer CaretPosition { get; set; }member this.CaretPosition : System.Windows.Documents.TextPointer with get, setPublic Property CaretPosition As TextPointerEigenschaftswert
Ein TextPointer-Objekt, das die Position der Einfügemarke angibt.
Standardmäßig ist die Einfügemarke die erste Einfügeposition im Inhalt, der von der RichTextBox gehostet wird. Weitere Informationen zu Textpositionierungsbegriffen wie "Einfügeposition" finden Sie unter TextPointer.
Ausnahmen
Es wird versucht, diese Eigenschaft auf null festzulegen.
Es wurde versucht, diese Eigenschaft auf einen TextPointer festzulegen, der auf eine Position außerhalb des aktuellen Dokuments verweist.
Beispiele
Im folgenden Beispiel wird die Verwendung dieser Eigenschaft veranschaulicht.
// Create a new FlowDocument, and add 3 paragraphs.
FlowDocument flowDoc = new FlowDocument();
flowDoc.Blocks.Add(new Paragraph(new Run("Paragraph 1")));
flowDoc.Blocks.Add(new Paragraph(new Run("Paragraph 2")));
flowDoc.Blocks.Add(new Paragraph(new Run("Paragraph 3")));
// Set the FlowDocument to be the content for a new RichTextBox.
RichTextBox rtb = new RichTextBox(flowDoc);
// Get the current caret position.
TextPointer caretPos = rtb.CaretPosition;
// Set the TextPointer to the end of the current document.
caretPos = caretPos.DocumentEnd;
// Specify the new caret position at the end of the current document.
rtb.CaretPosition = caretPos;
' Create a new FlowDocument, and add 3 paragraphs.
Dim flowDoc As New FlowDocument()
flowDoc.Blocks.Add(New Paragraph(New Run("Paragraph 1")))
flowDoc.Blocks.Add(New Paragraph(New Run("Paragraph 2")))
flowDoc.Blocks.Add(New Paragraph(New Run("Paragraph 3")))
' Set the FlowDocument to be the content for a new RichTextBox.
Dim rtb As New RichTextBox(flowDoc)
' Get the current caret position.
Dim caretPos As TextPointer = rtb.CaretPosition
' Set the TextPointer to the end of the current document.
caretPos = caretPos.DocumentEnd
' Specify the new caret position at the end of the current document.
rtb.CaretPosition = caretPos