RichTextBox.CaretPosition 属性

定义

命名空间:

System.Windows.Controls

程序集:

PresentationFramework.dll

获取或设置输入插入符号的位置。

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, set

Public Property CaretPosition As TextPointer

属性值

TextPointer

一个指定输入插入符号的位置的 TextPointer 对象。

默认情况下，插入符号位于 RichTextBox 承载的内容开头的第一个插入位置。 有关文本位置术语（如“插入位置”）的更多信息，请参见 TextPointer。

例外

ArgumentNullException

尝试将该属性设置为 null。

ArgumentException

尝试将此属性设置为引用当前文档外部位置的 TextPointer。

示例

以下示例演示了此属性的用法。

// 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

另请参阅

• TextPointer