LinkLabel.LinkCollection.Add Methode

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Fügt der Auflistung einen Link hinzu.

Überlädt

Add(LinkLabel+Link)	Fügt der Auflistung einen Link mit dem angegebenen Wert hinzu.
Add(Int32, Int32)	Fügt der Auflistung einen Link hinzu.
Add(Int32, Int32, Object)	Fügt der Auflistung einen Link sowie die ihm zuzuordnenden Informationen hinzu.

Add(LinkLabel+Link)

Fügt der Auflistung einen Link mit dem angegebenen Wert hinzu.

public:
 int Add(System::Windows::Forms::LinkLabel::Link ^ value);

public int Add (System.Windows.Forms.LinkLabel.Link value);

member this.Add : System.Windows.Forms.LinkLabel.Link -> int

Public Function Add (value As LinkLabel.Link) As Integer

Parameter

value: LinkLabel.Link

Ein LinkLabel.Link, der den hinzuzufügenden Link darstellt.

Gibt zurück

Int32

Der nullbasierte Index, an dem sich der durch den value-Parameter angegebene Link in der Auflistung befindet.

Gilt für:

Add(Int32, Int32)

Fügt der Auflistung einen Link hinzu.

public:
 System::Windows::Forms::LinkLabel::Link ^ Add(int start, int length);

public System.Windows.Forms.LinkLabel.Link Add (int start, int length);

member this.Add : int * int -> System.Windows.Forms.LinkLabel.Link

Public Function Add (start As Integer, length As Integer) As LinkLabel.Link

Parameter

start: Int32

Das erste Zeichen im Text der Bezeichnung, ab dem der Link erstellt wird.

length: Int32

Die Anzahl der Zeichen nach dem Anfangszeichen, die in den Linktext aufgenommen werden soll.

Gibt zurück

LinkLabel.Link

Ein LinkLabel.Link, der den Link darstellt, der erstellt und der Auflistung hinzugefügt wurde.

Beispiele

Im folgenden Beispiel wird das Festlegen der LinkBehavior -Eigenschaft mithilfe der LinkBehavior -Enumeration veranschaulicht. Außerdem wird das Festlegen der ActiveLinkColorEigenschaften , LinkColorund Text sowie LinkVisited das Hinzufügen von Elementen zu einem LinkLabel.LinkCollectionveranschaulicht. Um dieses Beispiel auszuführen, fügen Sie es in ein leeres Formular ein, und rufen Sie InitializeLinkLabel den Konstruktor oder Load die Methode des Formulars auf.

   // Declare the LinkLabel object.
internal:
   System::Windows::Forms::LinkLabel^ LinkLabel1;

   // Declare keywords array to identify links
   array<String^>^keywords;

private:
   void InitializeLinkLabel()
   {
      this->LinkLabel1 = gcnew System::Windows::Forms::LinkLabel;
      this->LinkLabel1->Links->Clear();
      // Set the location, name and size.
      this->LinkLabel1->Location = System::Drawing::Point( 10, 20 );
      this->LinkLabel1->Name = "CompanyLinks";
      this->LinkLabel1->Size = System::Drawing::Size( 104, 150 );
      
      // Set the LinkBehavior property to show underline when mouse
      // hovers over the links.
      this->LinkLabel1->LinkBehavior = System::Windows::Forms::LinkBehavior::HoverUnderline;
      String^ textString = "For more information see our"
      " company website or the research page at Contoso Ltd. ";
      
      // Set the text property.
      this->LinkLabel1->Text = textString;
      
      // Set the color of the links to black, unless the mouse
      // is hovering over a link.
      this->LinkLabel1->LinkColor = System::Drawing::Color::Black;
      this->LinkLabel1->ActiveLinkColor = System::Drawing::Color::Blue;
      
      // Associate the event-handling method with the LinkClicked
      // event.
      this->LinkLabel1->LinkClicked += gcnew LinkLabelLinkClickedEventHandler( this, &Form1::LinkLabel1_LinkClicked );
      
      // Add links to the LinkCollection using starting index and
      // length of keywords.
      array<String^>^temp0 = {"company","research"};
      keywords = temp0;
      System::Collections::IEnumerator^ myEnum = keywords->GetEnumerator();
      while ( myEnum->MoveNext() )
      {
         String^ keyword = safe_cast<String^>(myEnum->Current);
         this->LinkLabel1->Links->Add( textString->IndexOf( keyword ), keyword->Length );
      }

      
      // Add the label to the form.
      this->Controls->Add( this->LinkLabel1 );
   }

   void LinkLabel1_LinkClicked( Object^ /*sender*/, LinkLabelLinkClickedEventArgs^ e )
   {
      String^ url = "";
      
      // Determine which link was clicked and set the appropriate url.
      switch ( LinkLabel1->Links->IndexOf( e->Link ) )
      {
         case 0:
            url = "www.microsoft.com";
            break;

         case 1:
            url = "www.contoso.com/research";
            break;
      }
      
      // Set the visited property to True. This will change
      // the color of the link.
      e->Link->Visited = true;
      
      // Open Internet Explorer to the correct url.
      System::Diagnostics::Process::Start( "IExplore.exe", url );
   }


// Declare the LinkLabel object.
internal System.Windows.Forms.LinkLabel LinkLabel1;

// Declare keywords array to identify links
string[] keywords;

private void InitializeLinkLabel()
{
    this.LinkLabel1 = new System.Windows.Forms.LinkLabel();
            this.LinkLabel1.Links.Clear();

    // Set the location, name and size.
    this.LinkLabel1.Location = new System.Drawing.Point(10, 20);
    this.LinkLabel1.Name = "CompanyLinks";
    this.LinkLabel1.Size = new System.Drawing.Size(104, 150);

    // Set the LinkBehavior property to show underline when mouse
    // hovers over the links.
    this.LinkLabel1.LinkBehavior = System.Windows.Forms.LinkBehavior.HoverUnderline;
    string textString = "For more information see our" +
        " company website or the research page at Contoso Ltd. ";

    // Set the text property.
    this.LinkLabel1.Text = textString;

    // Set the color of the links to black, unless the mouse
    // is hovering over a link.
    this.LinkLabel1.LinkColor = System.Drawing.Color.Black;
    this.LinkLabel1.ActiveLinkColor = System.Drawing.Color.Blue;

    // Associate the event-handling method with the LinkClicked
    // event.
    this.LinkLabel1.LinkClicked += 
        new LinkLabelLinkClickedEventHandler(LinkLabel1_LinkClicked);

    // Add links to the LinkCollection using starting index and
    // length of keywords.
    keywords = new string[]{"company", "research"};
    foreach ( string keyword in keywords )
    {
        this.LinkLabel1.Links.Add(textString.IndexOf(keyword), keyword.Length);
    }

    // Add the label to the form.
    this.Controls.Add(this.LinkLabel1);
}

private void LinkLabel1_LinkClicked(object sender, LinkLabelLinkClickedEventArgs e)
{

    string url = "";

    // Determine which link was clicked and set the appropriate url.
    switch(LinkLabel1.Links.IndexOf(e.Link))
    {
        case 0:
            url = "www.microsoft.com";

            break;
        case 1:
            url = "www.contoso.com/research";
            break;
    }

    // Set the visited property to True. This will change
    // the color of the link.
    e.Link.Visited = true;

    // Open Internet Explorer to the correct url.
    System.Diagnostics.Process.Start("IExplore.exe", url);
}


' Declare the LinkLabel object.
Friend WithEvents LinkLabel1 As System.Windows.Forms.LinkLabel

' Declare keywords array to identify links
Dim keywords() As String

Private Sub InitializeLinkLabel()
    Me.LinkLabel1 = New System.Windows.Forms.LinkLabel
    Me.LinkLabel1.Links.Clear()
    ' Set the location, name and size.
    Me.LinkLabel1.Location = New System.Drawing.Point(10, 20)
    Me.LinkLabel1.Name = "CompanyLinks"
    Me.LinkLabel1.Size = New System.Drawing.Size(104, 150)

    ' Set the LinkBehavior property to show underline when mouse
    ' hovers over the links.
    Me.LinkLabel1.LinkBehavior = _
        System.Windows.Forms.LinkBehavior.HoverUnderline
    Dim textString As String = "For more information see our" & _
       " company website or the research page at Contoso Ltd. "

    ' Set the text property.
    Me.LinkLabel1.Text = textString

    ' Set the color of the links to black, unless the mouse
    ' is hovering over a link.
    Me.LinkLabel1.LinkColor = System.Drawing.Color.Black
    Me.LinkLabel1.ActiveLinkColor = System.Drawing.Color.Blue

    ' Add links to the LinkCollection using starting index and
    ' length of keywords.
    keywords = New String() {"company", "research"}
    Dim keyword As String
    For Each keyword In keywords
        Me.LinkLabel1.Links.Add(textString.IndexOf(keyword), keyword.Length)
    Next

    ' Add the label to the form.
    Me.Controls.Add(Me.LinkLabel1)
End Sub

Private Sub LinkLabel1_LinkClicked(ByVal sender As Object, _
    ByVal e As LinkLabelLinkClickedEventArgs) _
    Handles LinkLabel1.LinkClicked

    Dim url As String

    ' Determine which link was clicked and set the appropriate url.
    Select Case LinkLabel1.Links.IndexOf(e.Link)
        Case 0
            url = "www.microsoft.com"

        Case 1
            url = "www.contoso.com/research"
    End Select

    ' Set the visited property to True. This will change
    ' the color of the link.
    e.Link.Visited = True

    ' Open Internet Explorer to the correct url.
    System.Diagnostics.Process.Start("IExplore.exe", url)
End Sub

Hinweise

Ein LinkLabel Steuerelement kann mehrere Links im Text des Steuerelements anzeigen. Mit Add der -Methode können Sie Text innerhalb des LinkLabel Steuerelements in einen Link konvertieren, auf den der Benutzer klickt, um Aufgaben auszuführen, die einem Button Steuerelement ähneln. Diese Methode fügt den Link hinzu, der LinkLabel.LinkCollection für LinkLabelerstellt wird. Wenn Sie beispielsweise das Wort "schnell" im Beschriftungstext "Der schnelle braune Fuchs" festlegen möchten, rufen Sie diese Methode auf, wobei der start Parameter auf den Wert vier (4) und den length Parameter auf fünf (5) festgelegt ist. Das Wort "schnell" wird dann in einen Link geändert, und der Link wird der Auflistung hinzugefügt. Wenn Sie dem Link Informationen zuordnen möchten, z. B. die anzuzeigende URL oder eine Datei, die geöffnet werden soll, wenn der Benutzer auf den Link klickt, verwenden Sie die andere Version der Add Methode.

Hinweis

Zwei Links können nicht denselben Text gemeinsam verwenden. Wenn Sie einen Link erstellen, der Text verwendet, der bereits von einem anderen Link verwendet wird, wird eine Ausnahme ausgelöst.

Gilt für:

Add(Int32, Int32, Object)

Fügt der Auflistung einen Link sowie die ihm zuzuordnenden Informationen hinzu.

public:
 System::Windows::Forms::LinkLabel::Link ^ Add(int start, int length, System::Object ^ linkData);

public System.Windows.Forms.LinkLabel.Link Add (int start, int length, object linkData);

public System.Windows.Forms.LinkLabel.Link Add (int start, int length, object? linkData);

member this.Add : int * int * obj -> System.Windows.Forms.LinkLabel.Link

Public Function Add (start As Integer, length As Integer, linkData As Object) As LinkLabel.Link

Parameter

start: Int32

Das erste Zeichen im Text der Bezeichnung, ab dem der Link erstellt wird.

length: Int32

Die Anzahl der Zeichen nach dem Anfangszeichen, die in den Linktext aufgenommen werden soll.

linkData: Object

Das Objekt, das die Informationen enthält, die dem Link zugeordnet werden sollen.

Gibt zurück

LinkLabel.Link

Ein LinkLabel.Link, der den Link darstellt, der erstellt und der Auflistung hinzugefügt wurde.

Beispiele

Im folgenden Codebeispiel wird ein LinkLabel Steuerelement erstellt, das einen Link anzeigt und die Microsoft-Website im Standardbrowser anzeigt, wenn auf den im Text des Steuerelements definierten Link geklickt wird. Das Beispiel definiert eine Methode, die das LinkLabel Steuerelement initialisiert, sowie eine Methode, die das LinkClicked -Ereignis des -Steuerelements behandelt. Der Ereignishandler des LinkClicked Ereignisses verwendet die LinkData -Eigenschaft der LinkLabel.Link -Klasse, um die URL zu bestimmen, die im Standardbrowser angezeigt werden soll. Dieses Beispiel erfordert, dass es sich innerhalb einer Form Klasse befindet.

   // Create a new LinkLabel control.
private:
   LinkLabel^ linkLabel1;

public:
   void InitializeMyLinkLabel()
   {
      // Set the control to autosize based on the text content.
      linkLabel1->AutoSize = true;

      // Position and size the control on the form.
      linkLabel1->Location = System::Drawing::Point( 8, 16 );
      linkLabel1->Size = System::Drawing::Size( 135, 13 );

      // Set the text to display in the label.
      linkLabel1->Text = "Click here to get more info.";

      // Create a new link using the Add method of the LinkCollection class.
      linkLabel1->Links->Add( 6, 4, "www.microsoft.com" );

      // Create an event handler for the LinkClicked event.
      linkLabel1->LinkClicked += gcnew System::Windows::Forms::LinkLabelLinkClickedEventHandler( this, &Form1::linkLabel1_LinkClicked );

      // Add the control to the form.
      this->Controls->Add( linkLabel1 );
   }

private:
   void linkLabel1_LinkClicked( Object^ /*sender*/, System::Windows::Forms::LinkLabelLinkClickedEventArgs^ e )
   {
      // Determine which link was clicked within the LinkLabel.
      linkLabel1->Links[ linkLabel1->Links->IndexOf( e->Link ) ]->Visited = true;

      // Display the appropriate link based on the value of the LinkData property of the Link object.
      System::Diagnostics::Process::Start( e->Link->LinkData->ToString() );
   }

// Create a new LinkLabel control.
  private LinkLabel linkLabel1 = new LinkLabel();
  
  public void InitializeMyLinkLabel()
  {
      
      // Set the control to autosize based on the text content.
      linkLabel1.AutoSize = true;
      // Position and size the control on the form.
      linkLabel1.Location = new System.Drawing.Point(8,16);
      linkLabel1.Size = new System.Drawing.Size(135,13);
      // Set the text to display in the label.
      linkLabel1.Text = "Click here to get more info.";

      // Create a new link using the Add method of the LinkCollection class.
      linkLabel1.Links.Add(6,4,"www.microsoft.com");

      // Create an event handler for the LinkClicked event.
      linkLabel1.LinkClicked += new System.Windows.Forms.LinkLabelLinkClickedEventHandler(this.linkLabel1_LinkClicked);

      // Add the control to the form.
      this.Controls.Add(linkLabel1);
  }

  private void linkLabel1_LinkClicked(object sender, System.Windows.Forms.LinkLabelLinkClickedEventArgs e)
  {
      // Determine which link was clicked within the LinkLabel.
      linkLabel1.Links[linkLabel1.Links.IndexOf(e.Link)].Visited = true;
      // Display the appropriate link based on the value of the LinkData property of the Link object.
      System.Diagnostics.Process.Start(e.Link.LinkData.ToString());
  }

' Create a new LinkLabel control.
Private linkLabel1 As New LinkLabel()


Public Sub InitializeMyLinkLabel()
    
    ' Set the control to autosize based on the text content.
    linkLabel1.AutoSize = True
    ' Position and size the control on the form.
    linkLabel1.Location = New System.Drawing.Point(8, 16)
    linkLabel1.Size = New System.Drawing.Size(135, 13)
    ' Set the text to display in the label.
    linkLabel1.Text = "Click here to get more info."
    
    ' Create a new link using the Add method of the LinkCollection class.
    linkLabel1.Links.Add(6, 4, "www.microsoft.com")
    
    ' Create an event handler for the LinkClicked event.
    AddHandler linkLabel1.LinkClicked, AddressOf Me.linkLabel1_LinkClicked
    
    ' Add the control to the form.
    Me.Controls.Add(linkLabel1)
End Sub


Private Sub linkLabel1_LinkClicked(sender As Object, e As System.Windows.Forms.LinkLabelLinkClickedEventArgs)
    ' Determine which link was clicked within the LinkLabel.
    linkLabel1.Links(linkLabel1.Links.IndexOf(e.Link)).Visited = True
    ' Display the appropriate link based on the value of the LinkData property of the Link object.
    System.Diagnostics.Process.Start(e.Link.LinkData.ToString())
End Sub

Hinweise

Ein LinkLabel Steuerelement kann mehrere Links im Text des Steuerelements anzeigen. Mit Add der -Methode können Sie Text innerhalb des LinkLabel Steuerelements in einen Link konvertieren, auf den der Benutzer klickt, um Aufgaben auszuführen, die einem Button Steuerelement ähneln. Diese Methode fügt den Link hinzu, der LinkLabel.LinkCollection für LinkLabelerstellt wird. Wenn Sie beispielsweise das Wort "schnell" im Beschriftungstext "Der schnelle braune Fuchs" festlegen möchten, rufen Sie diese Methode auf, wobei der start Parameter auf den Wert vier (4) und den length Parameter auf fünf (5) festgelegt ist. Das Wort "schnell" wird dann in einen Link geändert, und der Link wird der Auflistung hinzugefügt. Mit dieser Version der Add-Methode können Sie zusätzliche Informationen bereitstellen, die dem Link über den linkData -Parameter zugeordnet werden können. Beispielsweise können Sie einen String an den Parameter übergeben, der linkData eine URL enthält, die angezeigt wird, wenn auf den Link geklickt wird. Sie können diese Informationen dann in Ihrem Handler für das LinkClicked Ereignis des LinkLabel Steuerelements verwenden, um die URL in einem Browser anzuzeigen.

Hinweis

Zwei Links können nicht denselben Text gemeinsam verwenden. Wenn Sie einen Link erstellen, der Text verwendet, der bereits von einem anderen Link verwendet wird, wird eine Ausnahme ausgelöst.

Gilt für:

Teilen über

LinkLabel.LinkCollection.Add Methode

Definition

Überlädt

Add(LinkLabel+Link)

Parameter

Gibt zurück

Gilt für:

Add(Int32, Int32)

Parameter

Gibt zurück

Beispiele

Hinweise

Gilt für:

Add(Int32, Int32, Object)

Parameter

Gibt zurück

Beispiele

Hinweise

Gilt für:

Zusätzliche Ressourcen