ハイパーリンクの図形への追加

DioDocs for Excel では、基本図形、チャート、コネクタ、写真、グループ化された図形などのさまざまな図形にハイパーリンクを追加することができます。図形をクリックするだけで、Webページ、外部ファイル、同じワークブック内の特定の範囲、または電子メールアドレスにすばやく移動できます。

メモ：ハイパーリンクは、コメントおよびスライサーのシェイプタイプに追加できません。

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

IHyperlinkインタフェースのAddressプロパティとSubAddressプロパティを使用して、ハイパーリンクを構成できます。以下のテーブルに、それぞれのプロパティについて説明します。

リンク先	Address	SubAddress
外部ファイル	例： C:\Users\Desktop\test.xlsx	null
Webページ	例： https://developer.mescius.jp/	null
同じワークブック内の特定の範囲	例： null	Sheet1!$C$3:$E$4
電子メールアドレス	例： mailto: abc.xyz@mescius.com	null

EmailSubjectプロパティを使用して、指定されたハイパーリンクの電子メールの件名テキスト文字列を設定できます。
ScreenTipプロパティを使用して、指定されたハイパーリンクのスクリーンチップのテキストを設定できます。
TextToDisplayプロパティを使用して、指定されたハイパーリンクに表示するテキストを設定できます。

ハイパーリンクの追加

IHyperLinksインタフェースのAddメソッドを使用して、ワークシート内の図形にハイパーリンクを追加できます。

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

C#	コードのコピー
//外部ファイルにハイパーリンクを追加します //図形を追加します IShape shape = worksheet.Shapes.AddShape(AutoShapeType.Oval, 1, 1, 200, 100); shape.TextFrame.TextRange.Paragraphs.Add("Link to Test.xlsx file"); //ハイパーリンクを追加します worksheet.Hyperlinks.Add(shape, @"C:\Test.xlsx", null, "Link to Test.xlsx file", "Test.xlsx"); //Excelファイルに保存します workbook.Save("ExternalHyperlink.xlsx");

コードのコピー

//外部ファイルにハイパーリンクを追加します

//図形を追加します
IShape shape = worksheet.Shapes.AddShape(AutoShapeType.Oval, 1, 1, 200, 100);
shape.TextFrame.TextRange.Paragraphs.Add("Link to Test.xlsx file");
//ハイパーリンクを追加します
worksheet.Hyperlinks.Add(shape, @"C:\Test.xlsx", null, "Link to Test.xlsx file", "Test.xlsx");
//Excelファイルに保存します
workbook.Save("ExternalHyperlink.xlsx");

C#	コードのコピー
//Webページにハイパーリンクを追加します //図形を追加します IShape picture = worksheet.Shapes.AddPicture(@"Images\grapecity-logo.jpg", 1, 1, 100, 100); //ハイパーリンクを追加します worksheet.Hyperlinks.Add(picture, "https://www.grapecity.com/", null , "Click to Open", "GrapeCity"); //Excelファイルに保存します workbook.Save("ShapeHyperlink.xlsx");

コードのコピー

//Webページにハイパーリンクを追加します

//図形を追加します
IShape picture = worksheet.Shapes.AddPicture(@"Images\grapecity-logo.jpg", 1, 1, 100, 100);
//ハイパーリンクを追加します
worksheet.Hyperlinks.Add(picture, "https://www.grapecity.com/", null , "Click to Open", "GrapeCity");
//Excelファイルに保存します
workbook.Save("ShapeHyperlink.xlsx");

C#	コードのコピー
//新規ワークブックを作成します var workbook = new GrapeCity.Documents.Excel.Workbook(); //ワークシートを取得します IWorksheet worksheet = workbook.Worksheets[0]; //ほかのワークシートを追加します IWorksheet worksheet1 = workbook.Worksheets.Add(); #region HyperlinkRange //Sheet2の範囲にハイパーリンクを追加します //Sheet1に図形を追加します IShape shape = worksheet.Shapes.AddShape(AutoShapeType.Oval, 1, 1, 200, 100); shape.TextFrame.TextRange.Paragraphs.Add("Go To sheet2 J3:K4"); //Sheet2のセル範囲J3：K4に移動できるようにハイパーリンクをSheet1に追加します worksheet.Hyperlinks.Add(shape, null, "Sheet2!$J$3:$K$4", "Go To sheet2 J3:K4"); //Excelファイルに保存します workbook.Save("RangeHyperlink.xlsx");

コードのコピー

//新規ワークブックを作成します
var workbook = new GrapeCity.Documents.Excel.Workbook();
//ワークシートを取得します
IWorksheet worksheet = workbook.Worksheets[0];
//ほかのワークシートを追加します
IWorksheet worksheet1 = workbook.Worksheets.Add();
#region HyperlinkRange
//Sheet2の範囲にハイパーリンクを追加します
//Sheet1に図形を追加します
IShape shape = worksheet.Shapes.AddShape(AutoShapeType.Oval, 1, 1, 200, 100);
shape.TextFrame.TextRange.Paragraphs.Add("Go To sheet2 J3:K4");
//Sheet2のセル範囲J3：K4に移動できるようにハイパーリンクをSheet1に追加します
worksheet.Hyperlinks.Add(shape, null, "Sheet2!$J$3:$K$4", "Go To sheet2 J3:K4");
//Excelファイルに保存します
workbook.Save("RangeHyperlink.xlsx");

C#	コードのコピー
//電子メールアドレスにハイパーリンクを追加します //図形を追加します IShape shape = worksheet.Shapes.AddShape(AutoShapeType.Oval, 1, 1, 200, 100); shape.TextFrame.TextRange.Paragraphs.Add("Send Feedback"); //ハイパーリンクを追加します worksheet.Hyperlinks.Add(shape, "mailto:web_feedback@grapecity.com", null, "Send your valuable feedback.", "Feedback"); //Excelファイルに保存します workbook.Save("MailTo.xlsx");

コードのコピー

//電子メールアドレスにハイパーリンクを追加します

//図形を追加します
IShape shape = worksheet.Shapes.AddShape(AutoShapeType.Oval, 1, 1, 200, 100);
shape.TextFrame.TextRange.Paragraphs.Add("Send Feedback");
//ハイパーリンクを追加します
worksheet.Hyperlinks.Add(shape, "mailto:web_feedback@grapecity.com", null, "Send your valuable feedback.", "Feedback");
//Excelファイルに保存します
workbook.Save("MailTo.xlsx");

ハイパーリンクの削除

IHyperlink インタフェースのDeleteメソッドを使用して、図形に設定したハイパーリンクを削除できます。

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

C#	コードのコピー
//ハイパーリンクを削除します //図形を追加します IShape shapeOval = worksheet.Shapes.AddShape(AutoShapeType.Oval, 1, 1, 200, 100); //ハイパーリンクを追加します IHyperlink hyperlink1 = worksheet.Hyperlinks.Add(shapeOval, "https://www.grapecity.com/", null, "Click to Open", "GrapeCity"); //ハイパーリンクを削除します hyperlink1.Delete(); //Excelファイルに保存します workbook.Save("DeleteHyperlink.xlsx");

コードのコピー

//ハイパーリンクを削除します

//図形を追加します
IShape shapeOval = worksheet.Shapes.AddShape(AutoShapeType.Oval, 1, 1, 200, 100);

//ハイパーリンクを追加します
IHyperlink hyperlink1 = worksheet.Hyperlinks.Add(shapeOval, "https://www.grapecity.com/", null, "Click to Open", "GrapeCity");

//ハイパーリンクを削除します
hyperlink1.Delete();

//Excelファイルに保存します
workbook.Save("DeleteHyperlink.xlsx");