RichTextBox.CaretPosition Proprietà

Definizione

Spazio dei nomi:

System.Windows.Controls

Assembly:

PresentationFramework.dll

Ottiene o imposta la posizione del cursore.

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

Valore della proprietà

TextPointer

Un oggetto TextPointer che specifica la posizione del cursore.

Per impostazione predefinita, il cursore è nella prima posizione di inserimento all'inizio del contenuto ospitato dal controllo RichTextBox. Per ulteriori informazioni sulla terminologia della posizione di testo come ad esempio "posizione di inserimento", vedere TextPointer.

Eccezioni

ArgumentNullException

È stato effettuato un tentativo di impostare la proprietà su null.

ArgumentException

Si è tentato di impostare questa proprietà su un TextPointer che fa riferimento a una posizione esterna del documento corrente.

Esempio

Nell'esempio seguente viene illustrato l'uso di questa proprietà.

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

Vedi anche

• TextPointer