Freigeben über


Gewusst wie: Verknüpfen eines Objekts oder einer Webseite mit dem LinkLabel-Steuerelement in Windows Forms

Mit dem LinkLabel-Steuerelement in Windows Forms können Sie in einem Formular Webhyperlinks erstellen. Die Farbe des Links kann, nachdem darauf geklickt wurde, geändert werden, um zu signalisieren, dass er bereits besucht wurde. Weitere Informationen über das Ändern der Farbe finden Sie unter Gewusst wie: Ändern der Darstellung des LinkLabel-Steuerelements in Windows Forms.

Verknüpfen mit einem anderen Formular

  1. Legen Sie für die Text-Eigenschaft eine geeignete Beschriftung fest.

  2. Definieren Sie die LinkArea-Eigenschaft, um festzulegen, welcher Teil der Beschriftung als Link gekennzeichnet wird. Wie der Link gekennzeichnet wird, hängt von den Darstellungseigenschaften der Linkbezeichnung ab. Der LinkArea-Wert wird durch ein LinkArea-Objekt mit zwei Zahlen dargestellt. Diese stehen für die Position des ersten Zeichens und die Anzahl der Zeichen. Die LinkArea-Eigenschaft kann im Eigenschaftenfenster oder in Code ähnlich wie folgt festgelegt werden:

    ' 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. Rufen Sie im LinkClicked-Ereignishandler die Show-Methode auf, um ein weiteres Formular im Projekt zu öffnen, und legen Sie die LinkVisited-Eigenschaft auf true fest.

    Tipp

    Eine Instanz der LinkLabelLinkClickedEventArgs-Klasse enthält einen Verweis auf das LinkLabel-Steuerelement, auf das geklickt wurde, sodass eine Umwandlung des sender -Objekts nicht erforderlich ist.

    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;
       }
    

Verknüpfen zu einer Webseite

Darüber hinaus kann mithilfe des LinkLabel-Steuerelements eine Webseite in einem Standardbrowser angezeigt werden.

  1. Legen Sie für die Text-Eigenschaft eine geeignete Beschriftung fest.

  2. Definieren Sie die LinkArea-Eigenschaft, um festzulegen, welcher Teil der Beschriftung als Link gekennzeichnet wird.

  3. Rufen Sie im LinkClicked-Ereignishandler in einem Ausnahmebehandlungsblock eine zweite Prozedur auf, die für die LinkVisited-Eigenschaft true festlegt und die Start-Methode verwendet, um den Standardbrowser mit einer URL zu starten. Um die Start-Methode zu verwenden, müssen Sie einen Verweis auf den System.Diagnostics-Namespace hinzufügen.

    SicherheitshinweisSicherheitshinweis

    Wenn der unten stehende Code in einer teilweise vertrauenswürdigen Umgebung ausgeführt wird (z. B. auf einem freigegebenen Laufwerk), schlägt die Umwandlung durch den JIT-Compiler fehl, wenn die VisitLink-Methode aufgerufen wird. Die Anweisung System.Diagnostics.Process.Start verursacht einen Linkaufruf, der fehlschlägt. Bei einem Fehlschlag des JIT-Compilers stellt der unten stehende Code die erfolgreiche Behandlung des Fehlers sicher, indem die Ausnahme abgefangen wird, wenn die VisitLink-Methode aufgerufen wird.

    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");
       }
    

Siehe auch

Aufgaben

Gewusst wie: Ändern der Darstellung des LinkLabel-Steuerelements in Windows Forms

Referenz

Process.Start

Übersicht über das LinkLabel-Steuerelement (Windows Forms)

Weitere Ressourcen

LinkLabel-Steuerelement (Windows Forms)