ハイパーリンク

DioDocs for Excel では、別のドキュメントまたは同じドキュメント内のセクションを指すハイパーテキストリンクの形式で、データの参照を作成することができます。1つのワークシートや範囲内に複数のハイパーリンクを設定できます。DioDocs for Excel では、ハイパーリンクを作成してセルに挿入することで、リンクをクリックして別のファイルや Web ページ内の関連情報にすばやくアクセスできます。

ハイパーリンクは、それぞれのワークシートまたは範囲に格納されます。ハイパーリンクを設定するには、IWorksheetインタフェースとIRangeインタフェースのHyperlinksコレクションにアクセスします。

DioDocs for Excel では、次のタスクを実行してハイパーリンクを管理できます。

ハイパーリンクの追加
ハイパーリンクの構成
ハイパーリンクの削除

ハイパーリンクの追加

ハイパーリンクは、外部ファイルへのリンク、Web ページへのリンク、電子メールアドレスへのリンク、およびワークシート内の範囲へのリンクとして作成および挿入できます。ワークシート内のセル範囲にハイパーリンクを追加するには、IHyperLinksインタフェースのAddメソッドを使用します。

外部ファイル、Web ページ、ワークシート内の範囲、および電子メールアドレスへのハイパーリンクを挿入する方法については、次のサンプルコードを参照してください。

C#	コードのコピー
// 外部ファイルへのハイパーリンクを追加します worksheet.Range["A1:B2"].Hyperlinks.Add(worksheet.Range["A1"], @"C:\Documents\GcExcel\GrapeCityDocumentsExcel\Project\Hyperlink\SampleFile.xlsx", null, "link to SampleFile.xlsx file.", "SampleFile.xlsx");

コードのコピー

// 外部ファイルへのハイパーリンクを追加します
worksheet.Range["A1:B2"].Hyperlinks.Add(worksheet.Range["A1"],
                                @"C:\Documents\GcExcel\GrapeCityDocumentsExcel\Project\Hyperlink\SampleFile.xlsx",
                                null,
                                "link to SampleFile.xlsx file.",
                                "SampleFile.xlsx");

C#	コードのコピー
//Webページへのハイパーリンクを追加します worksheet.Range["A1:B2"].Hyperlinks.Add(worksheet.Range["A1"], "http://www.grapecity.com/", null, "open Grapecity web site.", "Grapecity");

C#	コードのコピー
//このドキュメントの範囲にハイパーリンクを追加します worksheet.Range["A1:B2"].Hyperlinks.Add(worksheet.Range["A1"], null, "Sheet1!$C$3:$E$4", "Go To sheet1 C3:E4");

C#	コードのコピー
//電子メールへのハイパーリンクを追加します。 worksheet.Range["A1:B2"].Hyperlinks.Add(worksheet.Range["A1"], "mailto:abc.xyz@grapecity.com", null, "Send an email to ABC", "Send To ABC");

コードのコピー

//電子メールへのハイパーリンクを追加します。
worksheet.Range["A1:B2"].Hyperlinks.Add(worksheet.Range["A1"],
                                "mailto:abc.xyz@grapecity.com",
                                null,
                                "Send an email to ABC",
                                "Send To ABC");

ハイパーリンクの構成

IHyperlinkインタフェースの次のプロパティを使用してハイパーリンクを構成できます。

IHyperlinkインタフェースのAddressプロパティとSubAddressプロパティを使用して、ハイパーリンク参照を構成します。下の表に、この2つのプロパティの例を示します。

リンク先	Address	SubAddress
外部ファイル	例："C:\Users\sophiacao.MESCIUS\Desktop\test.xlsx"	null
Web ページ	例："http://www.baidu.com/"	null
このドキュメント内の範囲	例：null	"Sheet1!$C$3:$E$4"
電子メールアドレス	例："mailto:abc.cao@mescius.com"	null

EmailSubjectプロパティを使用すると、ハイパーリンクの電子メールの件名のテキストを設定できます。
ScreenTipプロパティを使用すると、ハイパーリンクのヒントテキストを設定できます。
TextToDisplayプロパティを使用すると、ハイパーリンクに表示するテキストを設定できます。

ハイパーリンクの削除

セルに挿入されたハイパーリンクは、特定のワークシートまたは範囲のハイパーリンクコレクションから Delete メソッドを使用して削除できます。

ハイパーリンクを削除する方法については、次のサンプルコードを参照してください。

C#	コードのコピー
//ハイパーリンクを削除します worksheet.Range["A1:B2"].Hyperlinks.Add(worksheet.Range["A1:A2"], null, "Sheet1!$C$3:$E$4", "Go To sheet1 C3:E4"); worksheet.Range["H5"].Hyperlinks.Add(worksheet.Range["A1"], "http://www.grapecity.com/"); worksheet.Range["J6"].Hyperlinks.Add(worksheet.Range["A1"], "http://www.grapecity.com/"); //範囲A1：A2のハイパーリンクを削除します worksheet.Range["A1:A2"].Hyperlinks.Delete(); //このワークシート内のすべてのハイパーリンクを削除します worksheet.Hyperlinks.Delete();

コードのコピー

//ハイパーリンクを削除します
worksheet.Range["A1:B2"].Hyperlinks.Add(worksheet.Range["A1:A2"],
                                null,
                                "Sheet1!$C$3:$E$4",
                                "Go To sheet1 C3:E4");

worksheet.Range["H5"].Hyperlinks.Add(worksheet.Range["A1"], "http://www.grapecity.com/");
worksheet.Range["J6"].Hyperlinks.Add(worksheet.Range["A1"], "http://www.grapecity.com/");

//範囲A1：A2のハイパーリンクを削除します
worksheet.Range["A1:A2"].Hyperlinks.Delete();

//このワークシート内のすべてのハイパーリンクを削除します
worksheet.Hyperlinks.Delete();