LinkLabel.LinkCollection.Add Yöntem

  • Başvuru

Tanım

Ad Alanı:
System.Windows.Forms
Bütünleştirilmiş Kod:
System.Windows.Forms.dll

Koleksiyona bir bağlantı ekler.

Aşırı Yüklemeler

Add(LinkLabel+Link)

Koleksiyona belirtilen değere sahip bir bağlantı ekler.
Add(Int32, Int32)

Koleksiyona bir bağlantı ekler.
Add(Int32, Int32, Object)

Bağlantıyla ilişkilendirilecek bilgilerle koleksiyona bir bağlantı ekler.

Add(LinkLabel+Link)

Koleksiyona belirtilen değere sahip bir bağlantı ekler.

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

Parametreler

value
LinkLabel.Link

LinkLabel.Link Eklenecek bağlantıyı temsil eden bir.

Döndürülenler

Int32

parametresi tarafından belirtilen bağlantının value koleksiyonda bulunduğu sıfır tabanlı dizin.

Şunlara uygulanır

Add(Int32, Int32)

Koleksiyona bir bağlantı ekler.

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

Parametreler

start
Int32

Bağlantının oluşturulduğu etiketin metnindeki başlangıç karakteri.

length
Int32

Bağlantı metnine eklenecek başlangıç karakterinden sonraki karakter sayısı.

Döndürülenler

LinkLabel.Link

LinkLabel.Link Oluşturulan ve koleksiyona eklenen bağlantıyı temsil eden.

Örnekler

Aşağıdaki örnekte, sabit listesi kullanılarak özelliğin LinkBehaviorLinkBehavior ayarlanması gösterilmektedir. Ayrıca , ve TextLinkColorözelliklerini ayarlamayı ActiveLinkColorve LinkVisited öğesine LinkLabel.LinkCollectionöğe eklemeyi gösterir. Bu örneği çalıştırmak için boş bir forma yapıştırın ve formun oluşturucusundan veya Load yönteminden çağrısı InitializeLinkLabel alın.

   // 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

Açıklamalar

Denetim LinkLabel , denetimin metni içinde birden çok bağlantı görüntüleyebilir. yöntemi, Add denetim içindeki LinkLabel metni, denetime benzer görevleri gerçekleştirmek için kullanıcı tarafından tıklanabilir bir Button bağlantıya dönüştürmenizi sağlar. Bu yöntem için LinkLabeloluşturulan LinkLabel.LinkCollection bağlantıyı ekler. Örneğin, etiket metninde "hızlı" sözcüğünü ayarlamak istiyorsanız, "Hızlı kahverengi tilki", parametre değeri dört (4) ve length parametresi beş (5) olarak ayarlanmış bu yöntemi start çağırırsınız. Ardından "hızlı" sözcüğü bir bağlantıya dönüşür ve bağlantı koleksiyona eklenir. Görüntülenecek URL veya kullanıcı bağlantıya tıkladığında açılacak bir dosya gibi bilgileri bağlantıyla ilişkilendirmek istiyorsanız, yöntemin diğer sürümünü Add kullanın.

Not

İki bağlantı aynı metni paylaşamaz. Başka bir bağlantı tarafından zaten kullanılan metni kullanan bir bağlantı oluşturursanız, bir özel durum oluşturulur.

Şunlara uygulanır

Add(Int32, Int32, Object)

Bağlantıyla ilişkilendirilecek bilgilerle koleksiyona bir bağlantı ekler.

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

Parametreler

start
Int32

Bağlantının oluşturulduğu etiketin metnindeki başlangıç karakteri.

length
Int32

Bağlantı metnine eklenecek başlangıç karakterinden sonraki karakter sayısı.

linkData
Object

Bağlantıyla ilişkilendirilecek bilgileri içeren nesne.

Döndürülenler

LinkLabel.Link

LinkLabel.Link Oluşturulan ve koleksiyona eklenen bağlantıyı temsil eden.

Örnekler

Aşağıdaki kod örneği, bağlantı görüntüleyen bir LinkLabel denetim oluşturur ve denetimin metninde tanımlanan bağlantıya tıklandığında Microsoft Web sitesini varsayılan tarayıcıda görüntüler. Örnek, denetimi başlatan bir yöntemin LinkLabel yanı sıra denetimin olayını işleyecek LinkClicked bir yöntemi tanımlar. olayının LinkClicked olay işleyicisi, varsayılan tarayıcıda görüntülenecek URL'yi belirlemek için sınıfının özelliğini LinkLabel.Link kullanırLinkData. Bu örnek, bir Form sınıfın içinde olmasını gerektirir.

   // 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

Açıklamalar

Denetim LinkLabel , denetimin metni içinde birden çok bağlantı görüntüleyebilir. yöntemi, Add denetim içindeki LinkLabel metni, denetime benzer görevleri gerçekleştirmek için kullanıcı tarafından tıklanabilir bir Button bağlantıya dönüştürmenizi sağlar. Bu yöntem için LinkLabeloluşturulan LinkLabel.LinkCollection bağlantıyı ekler. Örneğin, etiket metninde "hızlı" sözcüğünü ayarlamak istiyorsanız, "Hızlı kahverengi tilki", parametre değeri dört (4) ve length parametresi beş (5) olarak ayarlanmış bu yöntemi start çağırırsınız. Ardından "hızlı" sözcüğü bir bağlantıya dönüşür ve bağlantı koleksiyona eklenir. Add yönteminin bu sürümü, parametresi aracılığıyla bağlantıyla ilişkilendirilebilen ek bilgiler sağlamanıza linkData olanak tanır. Örneğin, bağlantıya tıklandığında görüntülenecek URL'yi içeren parametreye bir geçirebilirsiniz StringlinkData . Ardından, url'yi tarayıcıda görüntülemek üzere denetimin LinkClickedLinkLabel olayı için işleyicinizde bu bilgileri kullanabilirsiniz.

Not

İki bağlantı aynı metni paylaşamaz. Başka bir bağlantı tarafından zaten kullanılan metni kullanan bir bağlantı oluşturursanız, bir özel durum oluşturulur.

Şunlara uygulanır