RichTextBox.SelectionColor Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Quelle:

RichTextBox.cs

Dient zum Abrufen oder Festlegen der Textfarbe der aktuellen Textauswahl oder Einfügemarke.

public:
 property System::Drawing::Color SelectionColor { System::Drawing::Color get(); void set(System::Drawing::Color value); };

[System.ComponentModel.Browsable(false)]
public System.Drawing.Color SelectionColor { get; set; }

[<System.ComponentModel.Browsable(false)>]
member this.SelectionColor : System.Drawing.Color with get, set

Public Property SelectionColor As Color

Eigenschaftswert

Color

A Color that represents the color to apply to the current text selection or to text entered after the insertion point.

Attribute

BrowsableAttribute

Beispiele

Im folgenden Codebeispiel wird dem Benutzer eine ColorDialog Farbe für die aktuelle Textauswahl oder den Text angezeigt, der nach der aktuellen Einfügemarke in einem RichTextBox Steuerelement eingegeben wurde. Dieses Beispiel erfordert, dass die im Beispiel definierte Methode einer Form Klasse hinzugefügt wird, die ein Steuerelement mit dem RichTextBox Namen richTextBox1enthält.

public:
   void ChangeMySelectionColor()
   {
      ColorDialog^ colorDialog1 = gcnew ColorDialog;
      
      // Set the initial color of the dialog to the current text color.
      colorDialog1->Color = richTextBox1->SelectionColor;
      
      // Determine if the user clicked OK in the dialog and that the color has changed.
      if ( colorDialog1->ShowDialog() == System::Windows::Forms::DialogResult::OK &&
         colorDialog1->Color != richTextBox1->SelectionColor )
      {
         // Change the selection color to the user specified color.
         richTextBox1->SelectionColor = colorDialog1->Color;
      }
   }

public void ChangeMySelectionColor()
{
   ColorDialog colorDialog1 = new ColorDialog();

   // Set the initial color of the dialog to the current text color.
   colorDialog1.Color = richTextBox1.SelectionColor;

   // Determine if the user clicked OK in the dialog and that the color has changed.
   if(colorDialog1.ShowDialog() == System.Windows.Forms.DialogResult.OK && 
      colorDialog1.Color != richTextBox1.SelectionColor)
   {
      // Change the selection color to the user specified color.
      richTextBox1.SelectionColor = colorDialog1.Color;
   }
}

Public Sub ChangeMySelectionColor()
    Dim colorDialog1 As New ColorDialog()
    
    ' Set the initial color of the dialog to the current text color.
    colorDialog1.Color = richTextBox1.SelectionColor
    
    ' Determine if the user clicked OK in the dialog and that the color has
    ' changed.
    If (colorDialog1.ShowDialog() = System.Windows.Forms.DialogResult.OK) _
        And Not(colorDialog1.Color.Equals(richTextBox1.SelectionColor)) Then
        
        ' Change the selection color to the user specified color.
        richTextBox1.SelectionColor = colorDialog1.Color
    End If
End Sub

Hinweise

Wenn die aktuelle Textauswahl mehr als eine Farbe angegeben hat, gibt diese Eigenschaft zurück Color.Empty. Wenn derzeit kein Text ausgewählt ist, wird die in dieser Eigenschaft angegebene Textfarbe auf die aktuelle Einfügemarke und auf den gesamten Text angewendet, der nach der Einfügemarke in das Steuerelement eingegeben wird. Die Textfarbeinstellung gilt, bis die Eigenschaft in eine andere Farbe geändert wird oder bis die Einfügemarke in einen anderen Abschnitt innerhalb des Steuerelements verschoben wird.

Wenn Text innerhalb des Steuerelements markiert ist, wird der markierte Text und jeder Text, der nach der Textauswahl eingegeben wurde, den Wert dieser Eigenschaft zugewiesen. Sie können diese Eigenschaft verwenden, um die Farbe von Text in der RichTextBox.

Um Text fett im Steuerelement zu formatieren, verwenden Sie die SelectionFont Eigenschaft, um eine neue Schriftart zuzuweisen, die den fett formatierten Schriftschnitt angegeben hat.

Weitere Informationen

• SelectionFont
• Select(Int32, Int32)