Share via

Como exibir links em estilo da Web com o controle RichTextBox dos Windows Forms

  • Artigo

O controle Windows Forms RichTextBox pode exibir links da Web como coloridos e sublinhados. Você pode gravar o código que abre uma janela do navegador mostrando o site da Web especificado no texto do link quando o link é clicado.

Para vincular a uma página da Web com o controle RichTextBox

  1. Defina a Text propriedade como uma cadeia de caracteres que inclua uma URL válida (por exemplo, https://www.microsoft.com/).

  2. Verifique se a DetectUrls propriedade está definida como true (o padrão).

  3. Crie uma nova instância global do Process objeto.

  4. Escreva um manipulador de eventos para o evento que envia ao navegador o LinkClicked texto desejado.

    No exemplo abaixo, o LinkClicked evento abre uma instância do Internet Explorer para a URL especificada na Text propriedade do RichTextBox controle. Este exemplo pressupõe um formulário com um RichTextBox controle.

    Importante

    Ao chamar o método, você encontrará uma SecurityException exceção se estiver executando o Process.Start código em um contexto de confiança parcial devido a privilégios insuficientes. Para obter mais informações, consulte Noções Básicas da Segurança de Acesso do Código.

    Public p As New System.Diagnostics.Process
Private Sub RichTextBox1_LinkClicked _
   (ByVal sender As Object, ByVal e As _
   System.Windows.Forms.LinkClickedEventArgs) _
   Handles RichTextBox1.LinkClicked
      ' Call Process.Start method to open a browser
      ' with link text as URL.
      p = System.Diagnostics.Process.Start("IExplore.exe", e.LinkText)
End Sub

    public System.Diagnostics.Process p = new System.Diagnostics.Process();

private void richTextBox1_LinkClicked(object sender,
System.Windows.Forms.LinkClickedEventArgs e)
{
   // Call Process.Start method to open a browser
   // with link text as URL.
   p = System.Diagnostics.Process.Start("IExplore.exe", e.LinkText);
}

    public:
   System::Diagnostics::Process ^ p;

private:
   void richTextBox1_LinkClicked(System::Object ^  sender,
      System::Windows::Forms::LinkClickedEventArgs ^  e)
   {
      // Call Process.Start method to open a browser
      // with link text as URL.
      p = System::Diagnostics::Process::Start("IExplore.exe",
         e->LinkText);
   }

    (Visual C++) Você deve inicializar o processo p, o que você pode fazer incluindo a seguinte instrução no construtor do formulário:

    p = gcnew System::Diagnostics::Process();

    (Visual C#, Visual C++) Coloque o seguinte código no construtor do formulário para registrar o manipulador de eventos.

    this.richTextBox1.LinkClicked += new
   System.Windows.Forms.LinkClickedEventHandler
   (this.richTextBox1_LinkClicked);

    this->richTextBox1->LinkClicked += gcnew
   System::Windows::Forms::LinkClickedEventHandler
   (this, &Form1::richTextBox1_LinkClicked);

    É importante parar imediatamente o processo que você criou quando terminar de trabalhar com ele. No que se refere ao código apresentado acima, o código para interromper o processo pode se parecer com isso:

    Public Sub StopWebProcess()
   p.Kill()
End Sub

    public void StopWebProcess()
{
   p.Kill();
}

    public: void StopWebProcess()
{
   p->Kill();
}

Confira também