Compartilhar via

Como exibir links Web-Style com o controle RichTextBox dos Windows Forms

O controle dos Windows Forms RichTextBox pode exibir links da Web como coloridos e sublinhados. Você pode escrever um código que abre uma janela do navegador mostrando o site 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 inclui uma URL válida (por exemplo, https://www.microsoft.com/).

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

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

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

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

    Importante

    Ao chamar o método Process.Start, você encontrará uma exceção SecurityException se estiver executando o código em um contexto de confiança limitada devido a privilégios insuficientes. Para obter mais informações, consulte Noções básicas de segurança de acesso ao 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 pode ser feito incluindo a seguinte instrução no construtor do formulário:

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

    (Visual C#, Visual C++) Coloque o código a seguir 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 interromper imediatamente o processo que você criou depois de terminar de trabalhar com ele. Referindo-se ao código apresentado acima, seu código para interromper o processo pode ter esta aparência:

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

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

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

Consulte também