LinkLabel.LinkCollection.Add LinkLabel.LinkCollection.Add LinkLabel.LinkCollection.Add LinkLabel.LinkCollection.Add Method

定義

リンクをコレクションに追加します。Adds a link to the collection.

オーバーロード

Add(LinkLabel+Link) Add(LinkLabel+Link) Add(LinkLabel+Link) Add(LinkLabel+Link)

指定した値のリンクをコレクションに追加します。Adds a link with the specified value to the collection.

Add(Int32, Int32) Add(Int32, Int32) Add(Int32, Int32) Add(Int32, Int32)

リンクをコレクションに追加します。Adds a link to the collection.

Add(Int32, Int32, Object) Add(Int32, Int32, Object) Add(Int32, Int32, Object) Add(Int32, Int32, Object)

リンクに関連付ける情報と共にそのリンクをコレクションに追加します。Adds a link to the collection with information to associate with the link.

指定した値のリンクをコレクションに追加します。Adds a link with the specified value to the collection.

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

パラメーター

value
LinkLabel.Link LinkLabel.Link LinkLabel.Link LinkLabel.Link

追加するリンクを表す LinkLabel.LinkA LinkLabel.Link representing the link to add.

戻り値

value パラメーターで指定したリンクがコレクション内に配置された位置を表す 0 から始まるインデックス。The zero-based index where the link specified by the value parameter is located in the collection.

Add(Int32, Int32) Add(Int32, Int32) Add(Int32, Int32) Add(Int32, Int32)

リンクをコレクションに追加します。Adds a link to the collection.

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

パラメーター

start
Int32 Int32 Int32 Int32

ラベル テキスト内で作成されるリンク内の先頭文字。The starting character within the text of the label where the link is created.

length
Int32 Int32 Int32 Int32

リンク テキストに含める、先頭文字以降の文字数。The number of characters after the starting character to include in the link text.

戻り値

作成され、コレクションに追加されたリンクを表す LinkLabel.LinkA LinkLabel.Link representing the link that was created and added to the collection.

次の例は、 LinkBehavior LinkBehavior列挙体を使用してプロパティを設定する方法を示しています。The following example demonstrates setting the LinkBehavior property using the LinkBehavior enumeration. ActiveLinkColorまた、、 LinkColorText LinkLabel.LinkCollectionおよびの各プロパティを設定し、に項目を追加する方法も示します。LinkVisitedIt also demonstrates setting the ActiveLinkColor, LinkColor, Text and LinkVisited properties and adding items to a LinkLabel.LinkCollection. この例を実行するには、空のフォームに貼りInitializeLinkLabel付け、フォームのコンストラクターまたLoadはメソッドからを呼び出します。To run this example, paste it in a blank form and call InitializeLinkLabel from the form's constructor or Load method.

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

注釈

コントロールLinkLabelでは、コントロールのテキスト内に複数のリンクを表示できます。A LinkLabel control can display multiple links within the text of the control. メソッドを使用すると、コントロールLinkLabel内のテキストを、 Buttonコントロールのようなタスクを実行するためにユーザーがクリックできるリンクに変換できます。 AddThe Add method enables you to convert text within the LinkLabel control to a link that can be clicked on by the user to perform tasks similar to a Button control. このメソッドは、のに作成LinkLabel.LinkCollection LinkLabelされたリンクをに追加します。This method adds the link that is created to the LinkLabel.LinkCollection for the LinkLabel. たとえば、"quick brown fox" というラベルテキストに "quick" という単語を設定する場合は、 startパラメーターを 4 (4) に設定lengthし、パラメーターを5に設定して、このメソッドを呼び出します。For example, if you want to set the word "quick" in the label text, "The quick brown fox", you call this method with the start parameter set to the value of four (4), and the length parameter to five (5). "Quick" という単語がリンクを変更し、リンクがコレクションに追加されます。The word "quick" then changes to a link and the link is added to the collection. 表示する URL や、ユーザーがリンクをクリックしたときに開くファイルなど、情報をリンクに関連付ける場合は、もう一方のバージョンAddのメソッドを使用します。If you want to associate information with the link, such as the URL to display or a file to open when the user clicks on the link, use the other version of the Add method.

注意

2つのリンクが同じテキストを共有することはできません。Two links cannot share the same text. 別のリンクで既に使用されているテキストを使用するリンクを作成すると、例外がスローされます。If you create a link that uses text that is already used by another link, an exception is thrown.

Add(Int32, Int32, Object) Add(Int32, Int32, Object) Add(Int32, Int32, Object) Add(Int32, Int32, Object)

リンクに関連付ける情報と共にそのリンクをコレクションに追加します。Adds a link to the collection with information to associate with the link.

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

パラメーター

start
Int32 Int32 Int32 Int32

ラベル テキスト内で作成されるリンク内の先頭文字。The starting character within the text of the label where the link is created.

length
Int32 Int32 Int32 Int32

リンク テキストに含める、先頭文字以降の文字数。The number of characters after the starting character to include in the link text.

linkData
Object Object Object Object

リンクに関連付ける情報を含むオブジェクト。The object containing the information to associate with the link.

戻り値

作成され、コレクションに追加されたリンクを表す LinkLabel.LinkA LinkLabel.Link representing the link that was created and added to the collection.

次のコード例ではLinkLabel 、リンクを表示するコントロールを作成し、コントロールのテキストに定義されているリンクがクリックされたときに、Microsoft Web サイトを既定のブラウザーに表示します。The following code example creates a LinkLabel control that displays a link, and displays the Microsoft Web site in the default browser when the link defined in the control's text is clicked. この例では、コントロールを初期化LinkLabelするメソッドと、コントロールのイベントをLinkClicked処理するメソッドを定義します。The example defines a method that initializes the LinkLabel control as well as a method that will handle the LinkClicked event of the control. LinkClickedイベントのイベントハンドラーは、 LinkLabel.LinkクラスのLinkDataプロパティを使用して、既定のブラウザーに表示する URL を決定します。The event handler of the LinkClicked event uses the LinkData property of the LinkLabel.Link class to determine the URL to display in the default browser. この例では、 Formクラス内に配置する必要があります。This example requires that it is located within a Form class.

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

注釈

コントロールLinkLabelでは、コントロールのテキスト内に複数のリンクを表示できます。A LinkLabel control can display multiple links within the text of the control. メソッドを使用すると、コントロールLinkLabel内のテキストを、 Buttonコントロールのようなタスクを実行するためにユーザーがクリックできるリンクに変換できます。 AddThe Add method enables you to convert text within the LinkLabel control to a link that can be clicked on by the user to perform tasks similar to a Button control. このメソッドは、のに作成LinkLabel.LinkCollection LinkLabelされたリンクをに追加します。This method adds the link that is created to the LinkLabel.LinkCollection for the LinkLabel. たとえば、"quick brown fox" というラベルテキストに "quick" という単語を設定する場合は、 startパラメーターを 4 (4) に設定lengthし、パラメーターを5に設定して、このメソッドを呼び出します。For example, if you want to set the word "quick" in the label text, "The quick brown fox", you call this method with the start parameter set to the value of four (4), and the length parameter to five (5). "Quick" という単語がリンクを変更し、リンクがコレクションに追加されます。The word "quick" then changes to a link and the link is added to the collection. このバージョンの Add メソッドを使用すると、 linkDataパラメーターを通じてリンクに関連付けることができる追加情報を指定できます。This version of the Add method enables you to provide additional information that can be associated with the link through the linkData parameter. たとえば、リンクがクリックされStringたときlinkDataに表示される URL を含むパラメーターにを渡すことができます。For example, you can pass a String to the linkData parameter that contains a URL to display when the link is clicked. この情報を、 LinkClicked LinkLabelコントロールのイベントのハンドラーで使用して、Microsoft Internet Explorer に URL を表示することができます。You can then use this information in your handler for the LinkClicked event of the LinkLabel control to display the URL in Microsoft Internet Explorer.

注意

2つのリンクが同じテキストを共有することはできません。Two links cannot share the same text. 別のリンクで既に使用されているテキストを使用するリンクを作成すると、例外がスローされます。If you create a link that uses text that is already used by another link, an exception is thrown.

適用対象