LinkLabel

[C#] LinkLabelに複数のリンクを追加する方法

2025-01-18更新日: 2025-01-18

C#のLinkLabelコントロールに複数のリンクを追加するには、LinkLabel.LinkCollectionを使用します。

まず、LinkLabelのTextプロパティにリンクを含むテキストを設定します。

次に、Linksプロパティを使ってリンクの開始位置と長さを指定し、LinkLabel.Linkオブジェクトを追加します。

各リンクには、リンク先のURLや動作を指定するためのLinkDataプロパティを設定できます。

これにより、LinkClickedイベントで特定のリンクがクリックされたときに適切な処理を行うことが可能です。

目次から探す

複数リンクの追加方法
リンクの設定と管理
応用例
まとめ

複数リンクの追加方法

LinkLabelのTextプロパティの設定

C#のWindowsフォームアプリケーションで、LinkLabelを使用して複数のリンクを表示するには、まずTextプロパティを設定します。

Textプロパティには、表示したいテキストを設定しますが、リンク部分は後でLinkCollectionを使って指定します。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
        
        // LinkLabelのテキストを設定
        linkLabel1.Text = "こちらをクリックして、こちらもクリックしてください。";
    }
}

このコードでは、linkLabel1というLinkLabelコントロールに、リンクとして表示したいテキストを設定しています。

LinkLabel.LinkCollectionの利用

LinkLabelには、LinkCollectionというプロパティがあり、これを使ってリンクの情報を管理します。

LinkCollectionにリンクを追加することで、特定のテキスト部分をリンクとして機能させることができます。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
        
        // LinkLabelのテキストを設定
        linkLabel1.Text = "こちらをクリックして、こちらもクリックしてください。";
        
        // LinkCollectionを利用してリンクを追加
        linkLabel1.Links.Add(0, 7, "http://example.com"); // こちらをクリック
        linkLabel1.Links.Add(15, 7, "http://example.org"); // こちらもクリック
    }
}

このコードでは、Links.Addメソッドを使用して、テキストの開始位置と長さを指定し、リンク先のURLを設定しています。

LinkLabel.Linkオブジェクトの追加

LinkLabel.Linkオブジェクトを直接作成して、LinkCollectionに追加することもできます。

これにより、より柔軟にリンクの設定が可能です。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
        
        // LinkLabelのテキストを設定
        linkLabel1.Text = "こちらをクリックして、こちらもクリックしてください。";
        
        // Linkオブジェクトを作成
        LinkLabel.Link link1 = new LinkLabel.Link();
        link1.Start = 0; // こちらをクリックの開始位置
        link1.Length = 7; // こちらをクリックの長さ
        link1.LinkData = "http://example.com"; // リンク先
        
        LinkLabel.Link link2 = new LinkLabel.Link();
        link2.Start = 15; // こちらもクリックの開始位置
        link2.Length = 7; // こちらもクリックの長さ
        link2.LinkData = "http://example.org"; // リンク先
        
        // LinkCollectionにリンクを追加
        linkLabel1.Links.Add(link1);
        linkLabel1.Links.Add(link2);
    }
}

この方法では、LinkLabel.Linkオブジェクトを作成し、必要なプロパティを設定した後、Links.Addメソッドで追加しています。

これにより、リンクの設定をより詳細に制御できます。

リンクの設定と管理

リンクの開始位置と長さの指定

LinkLabelで複数のリンクを設定する際、各リンクの開始位置と長さを正確に指定することが重要です。

これにより、ユーザーがクリックできるリンク部分を明確に定義できます。

Links.Addメソッドを使用して、開始位置と長さを指定します。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
        
        // LinkLabelのテキストを設定
        linkLabel1.Text = "こちらをクリックして、こちらもクリックしてください。";
        
        // リンクの開始位置と長さを指定
        linkLabel1.Links.Add(0, 7, "http://example.com"); // こちらをクリック
        linkLabel1.Links.Add(15, 7, "http://example.org"); // こちらもクリック
    }
}

このコードでは、最初のリンク「こちらをクリック」の開始位置を0、長さを7に設定し、次のリンク「こちらもクリック」の開始位置を15、長さを7に設定しています。

これにより、正確にリンク部分が指定されます。

LinkDataプロパティの活用

LinkLabel.Linkオブジェクトには、LinkDataプロパティがあります。

このプロパティを使用することで、リンクに関連するデータを格納できます。

例えば、リンク先のURLや、特定の処理を行うための情報を保持することができます。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
        
        // LinkLabelのテキストを設定
        linkLabel1.Text = "こちらをクリックして、こちらもクリックしてください。";
        
        // Linkオブジェクトを作成
        LinkLabel.Link link1 = new LinkLabel.Link();
        link1.Start = 0; // こちらをクリックの開始位置
        link1.Length = 7; // こちらをクリックの長さ
        link1.LinkData = "http://example.com"; // リンク先
        
        LinkLabel.Link link2 = new LinkLabel.Link();
        link2.Start = 15; // こちらもクリックの開始位置
        link2.Length = 7; // こちらもクリックの長さ
        link2.LinkData = "http://example.org"; // リンク先
        
        // LinkCollectionにリンクを追加
        linkLabel1.Links.Add(link1);
        linkLabel1.Links.Add(link2);
    }
}

このコードでは、各リンクに対してLinkDataプロパティを使用して、リンク先のURLを設定しています。

これにより、後でリンクがクリックされた際に、どのURLに遷移するかを簡単に取得できます。

LinkClickedイベントの実装

リンクがクリックされた際の処理を実装するためには、LinkClickedイベントを使用します。

このイベントをハンドルすることで、ユーザーがリンクをクリックしたときに特定のアクションを実行できます。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
        
        // LinkLabelのテキストを設定
        linkLabel1.Text = "こちらをクリックして、こちらもクリックしてください。";
        
        // リンクの設定
        linkLabel1.Links.Add(0, 7, "http://example.com"); // こちらをクリック
        linkLabel1.Links.Add(15, 7, "http://example.org"); // こちらもクリック
        
        // LinkClickedイベントのハンドラを追加
        linkLabel1.LinkClicked += LinkLabel1_LinkClicked;
    }
    private void LinkLabel1_LinkClicked(object sender, LinkLabelLinkClickedEventArgs e)
    {
        // クリックされたリンクのデータを取得
        string url = e.Link.LinkData.ToString();
        
        // デフォルトのブラウザでURLを開く
        System.Diagnostics.Process.Start(url);
    }
}

このコードでは、LinkClickedイベントが発生した際に、クリックされたリンクのLinkDataを取得し、デフォルトのブラウザでそのURLを開く処理を実装しています。

これにより、ユーザーがリンクをクリックしたときに、指定したURLに遷移することができます。

応用例

複数リンクの動的生成

LinkLabelに複数のリンクを動的に生成することができます。

例えば、配列やリストからリンク情報を取得し、ループを使ってリンクを追加する方法です。

これにより、リンクの数や内容を柔軟に変更できます。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
        
        // リンク情報の配列
        string[] linkTexts = { "Google", "Yahoo", "Bing" };
        string[] linkUrls = { "http://www.google.com", "http://www.yahoo.com", "http://www.bing.com" };
        
        // LinkLabelのテキストを設定
        linkLabel1.Text = "以下のリンクをクリックしてください：";
        
        // リンクを動的に生成
        for (int i = 0; i < linkTexts.Length; i++)
        {
            int start = linkLabel1.Text.Length; // 現在のテキストの長さを取得
            linkLabel1.Text += " " + linkTexts[i]; // リンクテキストを追加
            linkLabel1.Links.Add(start, linkTexts[i].Length, linkUrls[i]); // リンクを追加
        }
    }
}

このコードでは、linkTextsとlinkUrlsの配列を使用して、リンクを動的に生成しています。

ループを使って、各リンクのテキストとURLを設定しています。

リンクのスタイル変更

LinkLabelのリンク部分のスタイルを変更することも可能です。

例えば、リンクの色やフォントスタイルを変更することで、ユーザーに対して視覚的なフィードバックを提供できます。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
        
        // LinkLabelのテキストを設定
        linkLabel1.Text = "こちらをクリックして、こちらもクリックしてください。";
        
        // リンクの設定
        linkLabel1.Links.Add(0, 7, "http://example.com"); // こちらをクリック
        linkLabel1.Links.Add(15, 7, "http://example.org"); // こちらもクリック
        
        // リンクのスタイルを変更
        linkLabel1.Links[0].LinkColor = Color.Blue; // リンクの色を青に設定
        linkLabel1.Links[1].LinkColor = Color.Red; // リンクの色を赤に設定
        linkLabel1.Links[0].VisitedColor = Color.Green; // 訪問済みリンクの色を緑に設定
    }
}

このコードでは、各リンクの色を変更し、訪問済みのリンクの色も設定しています。

これにより、ユーザーがどのリンクをクリックしたかを視覚的に示すことができます。

リンク先の動的変更

リンク先のURLを動的に変更することも可能です。

例えば、ユーザーのアクションに応じてリンク先を変更する場合に役立ちます。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
        
        // LinkLabelのテキストを設定
        linkLabel1.Text = "こちらをクリックして、こちらもクリックしてください。";
        
        // リンクの設定
        linkLabel1.Links.Add(0, 7, "http://example.com"); // こちらをクリック
        linkLabel1.Links.Add(15, 7, "http://example.org"); // こちらもクリック
        
        // リンク先を動的に変更
        ChangeLinkUrl(0, "http://new-example.com"); // こちらをクリックのリンク先を変更
    }
    private void ChangeLinkUrl(int linkIndex, string newUrl)
    {
        // 指定したリンクのURLを変更
        linkLabel1.Links[linkIndex].LinkData = newUrl;
    }
}