PowerTools SPREAD for Windows Forms 10.0J
ハイパーリンク型セル

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

複数のリンク

リンク先には、「http://www.grapecity.com/tools/」や「www.grapecity.com」のような任意のURLを設定できます。

ハイパーリンク型セルとその各属性を設定するには、HyperLinkCellTypeクラスを使用します。

リンクのカスタマイズ

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

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

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

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

設定方法

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

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

セルに設定する場合はCellクラスの、行に設定する場合はRowクラスの、列に設定する場合はColumnクラスの、あるいはスタイルに設定する場合はStyleInfoクラスのCellTypeプロパティに、定義したHyperLinkCellTypeクラスのインスタンスを割り当てます。

サンプルコード

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

C#
コードのコピー
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 ="http://www.fpoint.com";
hlnkcell.LinkArea = new LinkArea(9,16);
hlnkcell.LinkColor = Color.DarkGreen;
hlnkcell.VisitedLinkColor = Color.Chartreuse;
fpSpread1.ActiveSheet.Cells[1, 1].CellType = hlnkcell;
Visual Basic
コードのコピー
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 ="http://www.fpoint.com"
hlnkcell.LinkArea = new LinkArea(9,16)
hlnkcell.LinkColor = Color.DarkGreen
hlnkcell.VisitedLinkColor = Color.Chartreuse
FpSpread1.ActiveSheet.Cells(1, 1).CellType = hlnkcell

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

C#
コードのコピー
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 = "FarPoint and Microsoft";
string[] s = new string[]{"www.fpoint.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;
Visual Basic
コードのコピー
FpSpread1.ActiveSheet.Columns(0).Width = 145
FpSpread1.ActiveSheet.Rows(0).Height = 45
Dim mhp As New FarPoint.Win.Spread.CellType.HyperLinkCellType
mhp.Text = "FarPoint and Microsoft"
Dim s() As String = New String() {"www.fpoint.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 プロパティが展開され、このセル型に固有のさまざまなプロパティが表示されます。 このリストから、必要に応じてプロパティを選択および設定します。
    または、セルまたはセル範囲を右クリックして[セル型]を選択します。 セル型の一覧からハイパーリンク型を選択します。 セル型エディタで、必要なプロパティを設定します。 〈適用〉ボタンをクリックします。 複数のハイパーリンクを作成する場合は、テキストも設定する必要があります。 2番目のサンプル コードをデザイナで作成する場合は、テキストを 23 文字に設定する必要があります。このサンプル コードでは、2番目のリンクが 13 文字目から始まり、9文字の長さとなるためです。 テキスト位置は0から開始されます。
  3. [ファイル]メニューから[適用して終了]を選択し、変更をコンポーネントに適用して SPREAD デザイナを終了します。
関連トピック

 

 


© 2004-2017, GrapeCity inc. All rights reserved.