Compartilhar via


Como: Link para um objeto ou página da Web com o controle do Windows Forms LinkLabel

O Windows Forms LinkLabel controle permite que você criar links de estilo da Web no seu formulário. Quando o link é clicado, você pode alterar sua cor para indicar que o link foi visitado. Para obter mais informações sobre a alteração da cor, consulte Como: Alterar a aparência do controle do Windows Forms LinkLabel.

Vinculando a outro formulário

Para vincular a outro formulário com um controle LinkLabel

  1. Definir o Text a propriedade caption apropriado.

  2. Definir o LinkArea propriedade para determinar qual parte da legenda será indicada como um link. Como está indicada depende das propriedades relacionadas a aparência do rótulo do link. O LinkArea valor é representado por um LinkArea objeto contendo dois números, a posição de caractere inicial e o número de caracteres. O LinkArea propriedade pode ser definida na janela Propriedades ou no código de maneira semelhante à seguinte:

    ' In this code example, the link area has been set to begin
    ' at the first character and extend for eight characters.
    ' You may need to modify this based on the text entered in Step 1.
    LinkLabel1.LinkArea = New LinkArea(0, 8)
    
    // In this code example, the link area has been set to begin
    // at the first character and extend for eight characters.
    // You may need to modify this based on the text entered in Step 1.
    linkLabel1.LinkArea = new LinkArea(0,8);
    
    // In this code example, the link area has been set to begin
    // at the first character and extend for eight characters.
    // You may need to modify this based on the text entered in Step 1.
    linkLabel1->LinkArea = LinkArea(0,8);
    
  3. No LinkClicked o manipulador de eventos, chamar o Show método para abrir outro formulário no projeto e definir o LinkVisited propriedade para true.

    ObservaçãoObservação

    Uma instância da LinkLabelLinkClickedEventArgs classe transmite uma referência para o LinkLabel controle que foi clicado, portanto, não é necessário converter o sender objeto.

    Protected Sub LinkLabel1_LinkClicked(ByVal Sender As System.Object, _
       ByVal e As System.Windows.Forms.LinkLabelLinkClickedEventArgs) _
       Handles LinkLabel1.LinkClicked
       ' Show another form.
       Dim f2 As New Form()
       f2.Show
       LinkLabel1.LinkVisited = True
    End Sub
    
    protected void linkLabel1_LinkClicked(object sender, System. Windows.Forms.LinkLabelLinkClickedEventArgs e)
    {
       // Show another form.
       Form f2 = new Form();
       f2.Show();
       linkLabel1.LinkVisited = true;
    }
    
    private:
       void linkLabel1_LinkClicked(System::Object ^  sender,
          System::Windows::Forms::LinkLabelLinkClickedEventArgs ^  e)
       {
          // Show another form.
          Form ^ f2 = new Form();
          f2->Show();
          linkLabel1->LinkVisited = true;
       }
    

Vinculando a uma página da Web

O LinkLabel controle também pode ser usado para exibir uma página da Web com o navegador padrão.

  1. Definir o Text a propriedade caption apropriado.

  2. Definir o LinkArea propriedade para determinar qual parte da legenda será indicada como um link.

  3. No LinkClicked o manipulador de eventos, no meio de um bloco de tratamento de exceção, chamar um segundo procedimento que define o LinkVisited propriedade para true e usa o Start método para iniciar o navegador padrão com uma URL. Para usar o Start método, você precisará adicionar uma referência para o System.Diagnostics namespace.

    Observação de segurançaObservação sobre segurança

    Se o código a seguir é executado em um ambiente de confiança parcial (como em uma unidade compartilhada), o compilador JIT falha quando o VisitLink método é chamado. O System.Diagnostics.Process.Start instrução faz uma demanda de link falhar. Ao detectar a exceção quando o VisitLink método é chamado, o código a seguir assegura que, se o compilador JIT falhar, o erro é tratado tranqüilamente.

    Private Sub LinkLabel1_LinkClicked(ByVal sender As System.Object, _
       ByVal e As System.Windows.Forms.LinkLabelLinkClickedEventArgs) _
       Handles LinkLabel1.LinkClicked
       Try
          VisitLink()
       Catch ex As Exception
          ' The error message
          MessageBox.Show("Unable to open link that was clicked.")
       End Try
    End Sub
    
    Sub VisitLink()
       ' Change the color of the link text by setting LinkVisited 
       ' to True.
       LinkLabel1.LinkVisited = True
       ' Call the Process.Start method to open the default browser 
       ' with a URL:
       System.Diagnostics.Process.Start("https://www.microsoft.com")
    End Sub
    
    private void linkLabel1_LinkClicked(object sender, System.Windows.Forms.LinkLabelLinkClickedEventArgs e)
    {
       try
       {
          VisitLink();
       }
       catch (Exception ex )
       {
          MessageBox.Show("Unable to open link that was clicked.");
       }
    }
    
    private void VisitLink()
    {
       // Change the color of the link text by setting LinkVisited 
       // to true.
       linkLabel1.LinkVisited = true;
       //Call the Process.Start method to open the default browser 
       //with a URL:
       System.Diagnostics.Process.Start("https://www.microsoft.com");
    }
    
    private:
       void linkLabel1_LinkClicked(System::Object ^  sender,
          System::Windows::Forms::LinkLabelLinkClickedEventArgs ^  e)
       {
          try
          {
             VisitLink();
          }
          catch (Exception ^ ex)
          {
             MessageBox::Show("Unable to open link that was clicked.");
          }
       }
    private:
       void VisitLink()
       {
          // Change the color of the link text by setting LinkVisited 
          // to true.
          linkLabel1->LinkVisited = true;
          // Call the Process.Start method to open the default browser 
          // with a URL:
          System::Diagnostics::Process::Start("https://www.microsoft.com");
       }
    

Consulte também

Tarefas

Como: Alterar a aparência do controle do Windows Forms LinkLabel

Referência

Process.Start

Visão geral do controle de LinkLabel (Windows Forms)

Outros recursos

LinkLabel controle (Windows Forms)