RichTextBox.SelectionColor Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
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
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.