ハイパーリンク型セルを使用すると、単一または複数のハイパーリンクを表示できます。

ハイパーリンクには、以下のようなURLを設定できます。

• https://developer.mescius.jp/
• https://docs.mescius.jp/help/spread-winforms-15
• mailto: sales@mescius.com?Subject=Spread

テキストのどの部分をハイパーリンクとして機能させるかを指定し、残りの部分を通常のテキストとして表示できます。 ハイパーリンクの外観や、クリックされた後のリンクの色をカスタマイズできます。

プロパティ	カスタマイズ
BackgroundImage	背景に使用するグラフィックイメージを設定します。
Link	リンク先のURLを設定します。
LinkArea	ハイパーリンク機能を持つテキスト領域を設定します。
LinkAreas	ハイパーリンク機能を持つテキスト領域を設定します。
LinkColor	クリックされる前のリンクの色を設定します。
Links	ハイパーリンクを設定します。
Text	ハイパーリンクのラベルとしてセルに表示されるテキストを設定します。
VisitedLinkColor	クリックされた後のリンクの色を設定します。
UseModelValueAsText	データモデルのハイパーリンクテキストを使用するかどうかを示す値を取得します。

LinkColor、およびVisitedLinkColorプロパティを使用すると、クリックする前後のリンクの色をそれぞれ設定できます。

リンクをクリックする前のハイパーリンク テキスト	リンクをクリックした後のハイパーリンク テキスト

テキストに基づくハイパーリンクの並べ替えおよびフィルタリング

作成したハイパーリンクに対し、そのテキスト値に基づいて並べ替え、およびフィルタリングを設定できます。

これには、UseModelValueAsTextプロパティを使用します。デフォルトでは、このプロパティの値（ブール型）はfalseです。このプロパティをtrueに設定すると、データモデルからテキスト値がフェッチされ、HyperlinkCellType型セルに設定されます。データモデルからフェッチされ、セルに入力されたテキスト値は、他のセル型と同様、後から必要に応じて並べ替えまたはフィルタリングできます。

設定方法

HyperLinkCellTypeクラスのインスタンスを作成して、クラスの各プロパティを設定します。Textプロパティを使用して、セル内に表示するテキストを設定し、LinkAreaプロパティを使用して、テキストのどの部分をハイパーリンクとして表示するかを設定します。

セルのサイズを、ハイパーリンクを含むテキスト全体が表示されるよう設定してください。

セルに設定する場合はCellクラスの、行に設定する場合はRowクラスの、列に設定する場合はColumnクラスの、あるいはスタイルに設定する場合はStyleInfoクラスのCellTypeプロパティに、定義したHyperLinkCellTypeクラスのインスタンスを割り当てます。ハイパーリンク型セルに対して並べ替えまたはフィルタリング処理を実行するには、UseModelValueAsTextプロパティをtrueに設定します。これにより、データモデルからハイパーリンクテキストを取得することが指定されます。

サンプルコード

次のサンプルコードは、セルをハイパーリンク型セルに設定します。

また、UseModelValueAsTextプロパティを使用して、データモデルからハイパーリンクのテキスト値をフェッチするように指示する方法も示します。

fpSpread1.ActiveSheet.Columns[1].Width = 145;
fpSpread1.ActiveSheet.Rows[1].Height = 45;

FarPoint.Win.Spread.CellType.HyperLinkCellType hlnkcell = new FarPoint.Win.Spread.CellType.HyperLinkCellType();
hlnkcell.Text ="Click to See Our Web Site";
hlnkcell.Link ="https://developer.mescius.jp/";
hlnkcell.LinkArea = new LinkArea(9,16);
hlnkcell.LinkColor = Color.DarkGreen;
hlnkcell.VisitedLinkColor = Color.Chartreuse;
fpSpread1.ActiveSheet.Cells[1, 1].CellType = hlnkcell;

// データモデルの値を設定します
fpSpread1.ActiveSheet.SetValue(1,1,"Click to see our website");
// データモデルのテキストを使用します
hlnkcell.UseModelValueAsText = true;

FpSpread1.ActiveSheet.Columns(1).Width = 145
FpSpread1.ActiveSheet.Rows(1).Height = 45

Dim hlnkcell As New FarPoint.Win.Spread.CellType.HyperLinkCellType()
hlnkcell.Text = "Click to See Our Web Site"
hlnkcell.Link ="https://developer.mescius.jp/"
hlnkcell.LinkArea = new LinkArea(9,16)
hlnkcell.LinkColor = Color.DarkGreen
hlnkcell.VisitedLinkColor = Color.Chartreuse
FpSpread1.ActiveSheet.Cells(1, 1).CellType = hlnkcell

' データモデルの値を設定します
fpSpread1.ActiveSheet.SetValue(1, 1, "Click to see our website")
' データモデルのテキストを使用します
hlnkcell.UseModelValueAsText = True

次のサンプルコードは、HyperLinkCellTypeクラスのLinkAreasプロパティを設定し、複数のリンクから成るハイパーリンクを作成します。

fpSpread1.ActiveSheet.Columns[0].Width = 145;
fpSpread1.ActiveSheet.Rows[0].Height = 45;

FarPoint.Win.Spread.CellType.HyperLinkCellType mhp = new FarPoint.Win.Spread.CellType.HyperLinkCellType();
mhp.Text = "Google and Microsoft";
string[] s = new string[]{"www.google.com", "www.microsoft.com"};
mhp.Links = s;
mhp.VisitedLinkColor = Color.Maroon;
LinkArea[] la = new LinkArea[]{new LinkArea(0, 8), new LinkArea(13, 9)};
mhp.LinkAreas = la;
fpSpread1.ActiveSheet.Cells[0, 0].CellType = mhp;

FpSpread1.ActiveSheet.Columns(0).Width = 145
FpSpread1.ActiveSheet.Rows(0).Height = 45

Dim mhp As New FarPoint.Win.Spread.CellType.HyperLinkCellType
mhp.Text = "Google and Microsoft"
Dim s() As String = New String() {"www.google.com", "www.microsoft.com"}
mhp.Links = s
mhp.VisitedLinkColor = Color.Maroon
Dim la() As LinkArea = New LinkArea() {New LinkArea(0, 8), New LinkArea(13, 9)}
mhp.LinkAreas = la
FpSpread1.ActiveSheet.Cells(0, 0).CellType = mhp

SPREAD デザイナの使用

1. 作業領域内のセルまたはセル範囲を選択します。
2. プロパティ リストの「その他」カテゴリから、CellType プロパティを選択します。 ドロップダウン リストからハイパーリンク型を選択します。 これによって CellType プロパティが展開され、このセル型に固有のさまざまなプロパティが表示されます。 このリストから、必要に応じてプロパティを選択および設定します。
   または、セルまたはセル範囲を右クリックして［セル型］を選択します。 セル型の一覧からハイパーリンク型を選択します。 セル型エディタで、必要なプロパティを設定します。 〈適用〉ボタンをクリックします。 複数のハイパーリンクを作成する場合は、テキストも設定する必要があります。 ２番目のサンプル コードをデザイナで作成する場合は、テキストを 23 文字に設定する必要があります。このサンプル コードでは、２番目のリンクが 13 文字目から始まり、９文字の長さとなるためです。 テキスト位置は０から開始されます。
3. ［ファイル］メニューから［適用して終了］を選択し、変更をコンポーネントに適用して SPREAD デザイナを終了します。

© MESCIUS inc. All rights reserved.