RichTextBox.SelectionColor Eigenschaft

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft die Textfarbe der aktuellen Textauswahl oder der aktuellen Einfügemarke ab oder legt diese fest.

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

Eine Color, die die Farbe darstellt, die auf die aktuelle Textauswahl oder auf den nach der Einfügemarke eingegebenen Text angewendet werden soll.

Attribute: BrowsableAttribute

Beispiele

Im folgenden Codebeispiel wird dem Benutzer ein ColorDialog angezeigt, um eine Farbe für die aktuelle Textauswahl oder den Text anzugeben, der nach der aktuellen Einfügemarke in einem RichTextBox Steuerelement eingegeben wird. In diesem Beispiel muss die im Beispiel definierte Methode einer Form Klasse hinzugefügt werden, die ein RichTextBox Steuerelement mit dem 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 für die aktuelle Textauswahl mehr als eine Farbe angegeben ist, 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 ausgewählt ist, wird der Wert dieser Eigenschaft auf den ausgewählten Text und den nach der Textauswahl eingegebenen Text angewendet. Sie können diese Eigenschaft verwenden, um die Farbe des Texts in zu RichTextBoxändern.

Um Text fett im Steuerelement zu gestalten, verwenden Sie die SelectionFont -Eigenschaft, um eine neue Schriftart zuzuweisen, für die die fett formatierte Schriftart angegeben ist.

Gilt für:

Freigeben über