RichTextBox.SelectionColor Propriedade

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtém ou define a cor do texto do ponto de inserção ou seleção de texto atual.

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

Valor da propriedade

Color

Um Color que representa a cor a ser aplicada à seleção de texto atual ou ao texto inserido após o ponto de inserção.

Atributos

BrowsableAttribute

Exemplos

O exemplo de código a seguir exibe um ColorDialog para o usuário especificar uma cor para a seleção de texto atual ou texto inserido após o ponto de inserção atual em um RichTextBox controle . Este exemplo requer que o método definido no exemplo seja adicionado a uma Form classe que contém um RichTextBox controle chamado richTextBox1.

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

Comentários

Se a seleção de texto atual tiver mais de uma cor especificada, essa propriedade retornará Color.Empty. Se nenhum texto estiver selecionado no momento, a cor do texto especificada nesta propriedade será aplicada ao ponto de inserção atual e a todo o texto digitado no controle após o ponto de inserção. A configuração de cor do texto se aplica até que a propriedade seja alterada para uma cor diferente ou até que o ponto de inserção seja movido para uma seção diferente dentro do controle.

Se o texto estiver selecionado dentro do controle, o texto selecionado e qualquer texto inserido após a seleção de texto terão o valor dessa propriedade aplicado a ele. Você pode usar essa propriedade para alterar a cor do texto no RichTextBox.

Para deixar o texto em negrito no controle, use a SelectionFont propriedade para atribuir uma nova fonte que tenha o estilo de fonte em negrito especificado.

Confira também

• SelectionFont
• Select(Int32, Int32)