RichTextBox.CaretPosition Propriété

Définition

Espace de noms:

System.Windows.Controls

Assembly:

PresentationFramework.dll

Obtient ou définit la position du signe insertion d'entrée.

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

Valeur de propriété

TextPointer

Objet TextPointer spécifiant la position du signe insertion d'entrée.

Par défaut, le signe insertion se trouve dans la première position d'insertion au début du contenu hébergé par la RichTextBox. Consultez TextPointer pour plus d'informations sur la terminologie employée pour la position de texte, telle que « position d'insertion ».

Exceptions

ArgumentNullException

Une tentative d'affecter null à cette propriété est effectuée.

ArgumentException

Une tentative est effectuée pour affecter à cette propriété un TextPointer qui indique une position à l'extérieur du document en cours.

Exemples

L’exemple suivant illustre l’utilisation de cette propriété.

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

Voir aussi

• TextPointer