LinkAreas プロパティ (HyperLinkCellType)

テキストのハイパーリンク領域を取得または設定します。

構文

Visual Basic
C#

'宣言
 
Public Property LinkAreas As LinkArea()

public LinkArea[] LinkAreas {get; set;}

プロパティ値

リンクテキスト内のハイパーリンクの位置を定義する LinkArea オブジェクトを含む LinkArea の配列

例外

例外	解説
System.ArgumentException	指定された開始位置が無効です。正の値を指定する必要があります。
System.ArgumentException	指定された長さが無効です。正の値を指定する必要があります。
System.ArgumentException	指定された長さが無効です。テキスト全体の長さ以下の値を指定する必要があります。

解説

個々のハイパーリンクを指定する方法については、LinkAreaの例を参照してください。

1つのテキスト文字列に複数のハイパーリンクを設定する場合は、このプロパティをLinksプロパティと共に使用して、個々のハイパーリンクの配列を指定できます。開始文字の位置はゼロから始まります。つまり、最初の文字の位置は0です。

たとえば、"Visit our main site or our tech support site."は単語間のスペースと末尾のピリオドを含めて45文字あります。"main site"のみに下線を付けてハイパーリンクにするには、LinkArea(10.9)と指定します。これは文字列の10番目の文字から9文字に下線を付けてクリック可能にすることを意味します。さらに"tech support site"もリンクに加えるには、LinkArea(27.17)と指定します。こうすると、28番目の文字から17文字に下線が付きます。そして、LinkAreasプロパティの配列にこれら2つのLinkAreaオブジェクトを格納します。

テキスト文字列全体の長さを取得するには、Text.Lengthプロパティを使用します。

使用例

次のサンプルコードは、複数のハイパーリンクを持つセルを作成します。

C#
Visual Basic

FarPoint.Win.Spread.CellType.HyperLinkCellType mhp = new FarPoint.Win.Spread.CellType.HyperLinkCellType(); 
mhp.Text = "Visit our main site or our tech support site."; 
string[] s = new string[]{"www.fpoint.com", "www.clubfarpoint.com"};  
mhp.Links = s; 
LinkArea[] la = new LinkArea[]{new LinkArea(10, 9), new LinkArea(27, 17)}; 
mhp.LinkAreas = la; 
fpSpread1.ActiveSheet.Columns[1].Width = 220;
fpSpread1.ActiveSheet.Cells[0, 0].CellType = mhp;

Dim mhp As New FarPoint.Win.Spread.CellType.HyperLinkCellType
mhp.Text = "Visit our main site or our tech support site."
Dim s() As String = New String() {"www.fpoint.com", "www.clubfarpoint.com"} 
mhp.Links = s 
Dim la() As LinkArea = New LinkArea() {New LinkArea(10, 9), New LinkArea(27, 17)} 
mhp.LinkAreas = la 
FpSpread1.ActiveSheet.Columns(1).Width = 220
FpSpread1.ActiveSheet.Cells(0, 0).CellType = mhp

参照

HyperLinkCellType クラス
 HyperLinkCellType メンバ