RichTextBox.CaretPosition Propriedade

Definição

Namespace:

System.Windows.Controls

Assembly:

PresentationFramework.dll

Obtém ou define a posição do cursor do sistema de entrada.

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

Valor da propriedade

TextPointer

Um objeto TextPointer que especifica a posição do cursor do sistema de entrada.

Por padrão, o cursor do sistema é a primeira posição de inserção no início do conteúdo hospedado pelo RichTextBox. Consulte TextPointer para obter mais informações sobre a terminologia de posição de texto como "posição de inserção".

Exceções

ArgumentNullException

É feita uma tentativa de definir essa propriedade como null.

ArgumentException

É feita uma tentativa de definir essa propriedade como um TextPointer que faz referência a uma posição fora do documento atual.

Exemplos

O exemplo a seguir ilustra o uso dessa propriedade.

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

Confira também

• TextPointer