Compartilhar via

Visão geral do controle RichTextBox (Windows Forms)

  • Artigo

O controle RichTextBox do Windows Forms é usado para exibir, inserir e manipular texto com formatação. O controle RichTextBox faz tudo o que o controle TextBox faz, mas também pode exibir fontes, cores e links; carregar texto e imagens inseridas de um arquivo; e localize os caracteres especificados. O controle RichTextBox normalmente é usado para fornecer recursos de manipulação de texto e exibição semelhantes aos aplicativos de processamento de palavras, como o Microsoft Word. Assim como o controle TextBox, o controle RichTextBox pode exibir barras de rolagem; mas, ao contrário do controle TextBox, sua configuração padrão é exibir barras de rolagem horizontais e verticais, conforme necessário, e tem configurações de barra de rolagem adicionais.

Trabalhando com o controle RichTextBox

Assim como acontece com o controle TextBox, o texto exibido é definido pela propriedade Text. O controle RichTextBox tem várias propriedades para formatar texto. Para obter detalhes sobre essas propriedades, consulte Como: Definir Atributos de Fonte para o Controle RichTextBox do Windows Forms e Como: Configurar Recuos, Recuos Suspensos e Parágrafos Com Marcadores com o Controle RichTextBox do Windows Forms. Para manipular arquivos, os métodos LoadFile e SaveFile podem exibir e gravar vários formatos de arquivo, incluindo texto sem formatação, texto sem formatação Unicode e RTF (Rich Text Format). Os possíveis formatos de arquivo são listados em RichTextBoxStreamType. Você pode usar o método Find para localizar cadeias de caracteres de texto ou caracteres específicos.

Você também pode usar um controle RichTextBox para links de estilo da Web definindo a propriedade DetectUrls para true e escrevendo código para lidar com o evento LinkClicked. Para obter mais informações, consulte Como: Exibir Web-Style Links com o controle RichTextBox do Windows Forms. Você pode impedir que o usuário manipipe parte ou todo o texto no controle definindo a propriedade SelectionProtected como true.

Você pode desfazer e refazer a maioria das operações de edição em um controle RichTextBox chamando os métodos Undo e Redo. O método CanRedo permite determinar se a última operação desfeita pelo usuário pode ser reaplicada ao controle.

Consulte também