Partilhar via

Como visualizar links Web-Style com o controlo RichTextBox do Windows Forms

  • Artigo

O controle RichTextBox Windows Forms pode exibir links da Web como coloridos e sublinhados. Você pode escrever 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 propriedade Text como uma cadeia de caracteres que inclua uma URL válida (por exemplo, https://www.microsoft.com/).

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

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

  4. Escreva um manipulador de eventos para o evento LinkClicked 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 assume um formulário com um controle RichTextBox.

    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 parcial devido a privilégios insuficientes. Para obter mais informações, consulte Princípios básicos da segurança de acesso a 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 parar imediatamente o processo que você criou assim que terminar de trabalhar com ele. Referindo-se ao código apresentado acima, seu código para parar o processo pode ter esta aparência:

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

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

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

Ver também