Classe RichTextBox

Com o RichTextBox controle, o usuário pode inserir e edição texto. O controle também fornece os mais avançados recursos de formatação que o padrão TextBox controle. Texto pode ser atribuído diretamente ao controle ou pode ser carregado de um formato de rich text (RTF) ou de um arquivo de texto sem formatação. O texto dentro do controle pode ser atribuído a caractere e formatação de parágrafo.

The RichTextBox controle fornece várias propriedades que podem ser usadas para aplicar a formatação de qualquer parte do texto dentro do controle. Para alterar a formatação de texto, ele deve primeiro ser selecionado. Somente o texto selecionado pode ser atribuído a formatação de caractere e parágrafos. Quando uma configuração é feita a uma seção selecionada do texto, todo o texto inserido após a seleção também é formatada com as mesmas configurações até que seja feita uma alterar de configuração ou outra seção do documento do controle está selecionada. The SelectionFont propriedade permite que você colocar o texto em negrito ou itálico. Você também pode usar essa propriedade para alterar o dimensionar e face de tipos do texto. The SelectionColor propriedade permite que você altere a cor do texto. Para criar listas com marcadores, você pode usar o SelectionBullet propriedade. Você também pode ajustar, definindo o de formatação de parágrafoSelectionIndent, SelectionRightIndent, e SelectionHangingIndent Propriedades.

The RichTextBox controle fornece métodos que fornecem funcionalidade de abrir e salvar arquivos. The LoadFile método permite que você carregar um arquivo de texto RTF ou ASCII existente no controle. Você também pode carregar dados de um fluxo de dados já aberto. The SaveFile permite que você salvar um arquivo de texto RTF ou ASCII. Semelhante a LoadFile método, você também pode usar o SaveFile método para salvar um fluxo de dados em aberto. The RichTextBox controle também fornece recursos para localizar seqüências de texto. The Find método é sobrecarregado para localizar sistema autônomo duas seqüências de caracteres de texto bem sistema autônomo caracteres específicos dentro do texto do controle.

Você também pode inicializar o RichTextBox controle a dados armazenados na memória. Por exemplo, você pode inicializar o Rtf propriedade para uma seqüência de caracteres que contém o texto a ser exibido, incluindo os códigos de RTF que determinam como o texto deve ser formatado.

Se o texto dentro do controle contiver links, sistema autônomo um link para um site, você pode usar o DetectUrls propriedade para exibir o link apropriado no texto do controle. Em seguida, você pode manipular o LinkClicked evento para executar as tarefas associadas ao link. The SelectionProtected propriedade permite que você a proteger o texto dentro do controle de manipulação pelo usuário. Com o texto protegido no seu controle, você pode manipular o Protected evento para determinar quando o usuário tentou modificar texto protegido e o alerta o usuário que o texto está protegido ou fornecer ao usuário uma maneira padrão de manipulação de texto protegido.

Aplicativos que já usam TextBox controles podem ser com com facilidade adaptados para fazer uso de RichTextBox controles. No entanto, a RichTextBox controle não tem o mesmo limite de capacidade de 64 K caractere da TextBox controle. The RichTextBox costuma ser usado para fornecer manipulação de texto e exibir recursos semelhantes a aplicativos de processamento de texto, sistema autônomo o Microsoft palavra.

Observação:
O TextBoxBase.Undo método não funciona com o KeyPress ou TextChanged eventos.

O exemplo de código a seguir cria um RichTextBoxcontrole carrega um arquivo RTF no controle e procura a primeira ocorrência da palavra "Texto". O código, em seguida, altera o estilo da fonte, dimensionar da fonte e cor da fonte do texto selecionado e salva as alterações no arquivo original. O exemplo de código for concluído, adicionando o controle ao seu Form. Este exemplo requer que o método criado no exemplo de código é adicionado a um Form classe e a chamada do construtor do formulário. O exemplo também requer que um arquivo RTF é criado na raiz da unidade C, contendo a palavra "Texto".

publicvoid CreateMyRichTextBox()
{
    RichTextBox richTextBox1 = new RichTextBox();
    richTextBox1.Dock = DockStyle.Fill;


    richTextBox1.LoadFile("C:\\MyDocument.rtf");
    richTextBox1.Find("Text", RichTextBoxFinds.MatchCase);

    richTextBox1.SelectionFont = new Font("Verdana", 12, FontStyle.Bold);
    richTextBox1.SelectionColor = Color.Red;

    richTextBox1.SaveFile("C:\\MyDocument.rtf", RichTextBoxStreamType.RichText);

    this.Controls.Add(richTextBox1);
}

	public void CreateMyRichTextBox()
	{
		RichTextBox richTextBox1 = new RichTextBox();

		richTextBox1.set_Dock(DockStyle.Fill);
		richTextBox1.LoadFile("C:\\MyDocument.rtf");
		richTextBox1.Find("Text", RichTextBoxFinds.MatchCase);
		richTextBox1.set_SelectionFont(new Font
			("Verdana", 12, FontStyle.Bold));
		richTextBox1.set_SelectionColor(Color.get_Red());
		richTextBox1.SaveFile("C:\\MyDocument.rtf",
			RichTextBoxStreamType.RichText);
		this.get_Controls().Add(richTextBox1);
	} //CreateMyRichTextBox

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework

Referência