RichTextBox.SelectionBullet Propriété

Définition

Obtient ou définit une valeur qui indique si le style de liste à puces est appliqué à la sélection actuelle ou au point d'insertion.Gets or sets a value indicating whether the bullet style is applied to the current selection or insertion point.

public:
 property bool SelectionBullet { bool get(); void set(bool value); };
[System.ComponentModel.Browsable(false)]
public bool SelectionBullet { get; set; }
member this.SelectionBullet : bool with get, set
Public Property SelectionBullet As Boolean

Valeur de propriété

true si la sélection actuelle ou le point d'insertion reçoit le style de liste à puces ; sinon, false.true if the current selection or insertion point has the bullet style applied; otherwise, false.

Attributs

Exemples

L’exemple de code suivant montre comment utiliser la propriété SelectionBullet avec les propriétés SelectionFont, SelectedTextet SelectionColor pour créer une liste à puces dans un contrôle RichTextBox.The following code example demonstrates how to use the SelectionBullet property with the SelectionFont, SelectedText, and SelectionColor properties to create a bulleted list in a RichTextBox control. Cet exemple requiert qu’un contrôle RichTextBox nommé richTextBox1 soit créé sur un formulaire.This example requires that a RichTextBox control named richTextBox1 is created on a form.

private:
   void WriteTextToRichTextBox()
   {
      // Clear all text from the RichTextBox;
      richTextBox1->Clear();

      // Set the font for the opening text to a larger Arial font;
      richTextBox1->SelectionFont = gcnew System::Drawing::Font( "Arial",16 );

      // Assign the introduction text to the RichTextBox control.
      richTextBox1->SelectedText = "The following is a list of bulleted items: \n";

      // Set the Font for the first item to a smaller size Arial font.
      richTextBox1->SelectionFont = gcnew System::Drawing::Font( "Arial",12 );

      // Specify that the following items are to be added to a bulleted list.
      richTextBox1->SelectionBullet = true;

      // Set the color of the item text.
      richTextBox1->SelectionColor = Color::Red;

      // Assign the text to the bulleted item.
      richTextBox1->SelectedText = "Apples \n";

      // Apply same font since font settings do not carry to next line.
      richTextBox1->SelectionFont = gcnew System::Drawing::Font( "Arial",12 );
      richTextBox1->SelectionColor = Color::Orange;
      richTextBox1->SelectedText = "Oranges \n";
      richTextBox1->SelectionFont = gcnew System::Drawing::Font( "Arial",12 );
      richTextBox1->SelectionColor = Color::Purple;
      richTextBox1->SelectedText = "Grapes \n";

      // End the bulleted list.
      richTextBox1->SelectionBullet = false;

      // Specify the font size and string for text displayed below bulleted list.
      richTextBox1->SelectionFont = gcnew System::Drawing::Font( "Arial",16 );
      richTextBox1->SelectedText = "Bulleted Text Complete!";
   }
private void WriteTextToRichTextBox()
{
   // Clear all text from the RichTextBox;
   richTextBox1.Clear();
   // Set the font for the opening text to a larger Arial font;
   richTextBox1.SelectionFont = new Font("Arial", 16);
   // Assign the introduction text to the RichTextBox control.
   richTextBox1.SelectedText = "The following is a list of bulleted items:" + "\n";
   // Set the Font for the first item to a smaller size Arial font.
   richTextBox1.SelectionFont = new Font("Arial", 12);
   // Specify that the following items are to be added to a bulleted list.
   richTextBox1.SelectionBullet = true;
   // Set the color of the item text.
   richTextBox1.SelectionColor = Color.Red;
   // Assign the text to the bulleted item.
   richTextBox1.SelectedText = "Apples" + "\n";
   // Apply same font since font settings do not carry to next line.
   richTextBox1.SelectionFont = new Font("Arial", 12);
   richTextBox1.SelectionColor = Color.Orange;
   richTextBox1.SelectedText = "Oranges" + "\n";
   richTextBox1.SelectionFont = new Font("Arial", 12);
   richTextBox1.SelectionColor = Color.Purple;
   richTextBox1.SelectedText = "Grapes" + "\n";
   // End the bulleted list.
   richTextBox1.SelectionBullet = false;
   // Specify the font size and string for text displayed below bulleted list.
   richTextBox1.SelectionFont = new Font("Arial", 16);
   richTextBox1.SelectedText = "Bulleted Text Complete!";
}
Private Sub WriteTextToRichTextBox()
   ' Clear all text from the RichTextBox;
   richTextBox1.Clear()
   ' Set the font for the opening text to a larger Arial font;
   richTextBox1.SelectionFont = New Font("Arial", 16)
   ' Assign the introduction text to the RichTextBox control.
   RichTextBox1.SelectedText = "The following is a list of bulleted items:" + ControlChars.Cr
   ' Set the Font for the first item to a smaller size Arial font.
   richTextBox1.SelectionFont = New Font("Arial", 12)
   ' Specify that the following items are to be added to a bulleted list.
   richTextBox1.SelectionBullet = True
   ' Set the color of the item text.
   richTextBox1.SelectionColor = Color.Red
   ' Assign the text to the bulleted item.
   richTextBox1.SelectedText = "Apples" + ControlChars.Cr
   ' Apply same font since font settings do not carry to next line.
   richTextBox1.SelectionFont = New Font("Arial", 12)
   richTextBox1.SelectionColor = Color.Orange
   richTextBox1.SelectedText = "Oranges" + ControlChars.Cr
   richTextBox1.SelectionFont = New Font("Arial", 12)
   richTextBox1.SelectionColor = Color.Purple
   richTextBox1.SelectedText = "Grapes" + ControlChars.Cr
   ' End the bulleted list.
   richTextBox1.SelectionBullet = False
   ' Specify the font size and string for text displayed below bulleted list.
   richTextBox1.SelectionFont = New Font("Arial", 16)
   richTextBox1.SelectedText = "Bulleted Text Complete!"
End Sub

Remarques

Si aucun texte n’est sélectionné, le style de puce est appliqué au point d’insertion actuel et à tous les paragraphes que l’utilisateur entre après le point d’insertion.If no text is selected, the bullet style is applied to the current insertion point and to all paragraphs that the user enters after the insertion point. Le style de puce est appliqué au texte du contrôle jusqu’à ce que le point d’insertion soit déplacé ou lorsque l’utilisateur appuie sur la touche entrée d’un élément de puce vide.The bullet style is applied to the text of the control until the insertion point is moved or when the user presses the Enter key on an empty bullet item.

Si du texte est sélectionné dans le contrôle lorsque cette propriété est définie, tous les paragraphes du texte sélectionné sont convertis en éléments à puces dans la liste à puces.If text is selected within the control when this property is set, all paragraphs within the selected text are converted into bulleted items in the bulleted list. Vous pouvez utiliser cette propriété pour créer des listes à puces dans les documents que vous créez dans le contrôle RichTextBox.You can use this property to create bulleted lists within the documents you create in the RichTextBox control.

La propriété BulletIndent vous permet de spécifier la quantité de mise en retrait à appliquer entre la puce et le texte de l’élément à puces.The BulletIndent property enables you to specify the amount of indentation to apply between the bullet and the bulleted item's text.

S’applique à

Voir aussi