プレビュー行は、レコードについての補足情報を表示するための行です。 詳細情報を示す対象となる行の下に表示されます。 プレビュー行に対し、色などの書式を指定することもできます。

ただし、プレビュー行は読み取り専用で、フォーカス移動やテキストの選択などはできません。

設定方法

プレビュー行を表示するには、SheetView クラスのPreviewRowVisible プロパティをTrueに設定します。背景色やフォントといったスタイルを設定するにはPreviewRowInfo クラスを使用します。このクラスはPreviewRowStyle プロパティから参照されます。

表示する内容については、以下の2通りの設定方法があります。

• 既存列のテキストを表示する

  PreviewRowColumnIndex プロパティに表示したいテキストの列を指定します。なお、この列のVisible プロパティをfalseに設定すると、表示内容が重複することを避けることができます。

• 固定テキストやコントロールを表示する

  PreviewRowTemplate プロパティが参照するテンプレートを作成します。テンプレートはデザイン画面から以下の手順で設定できます。

  1. デザイン画面でSPREADコントロールを選択します。
  2. スマートタグから［テンプレートの編集］を選択し、テンプレート編集モードにします。
  3. スマートタグの［表示名：］ドロップダウンから「プレビュー行テンプレート」下のシートを選択します。
  4. 表示するテキストを入力します。あるいは任意のコントロールを配置こともできます。
  5. スマートタグから［テンプレート編集の終了］をクリックします。

サンプルコード

次のサンプルコードは、4列目の内容をプレビュー行として表示し、4列目を非表示にします。

FarPoint.Web.Spread.SheetView sv;
sv = FpSpread1.Sheets[0];

sv.ColumnCount = 4;
sv.RowCount = 3;

sv.Cells[0, 0].Value = "1-A";
sv.Cells[0, 1].Value = "1-B";
sv.Cells[0, 2].Value = "1-C";
sv.Cells[0, 3].Value = "１行目のプレビュー行";

sv.Cells[1, 0].Value = "2-A";
sv.Cells[1, 1].Value = "2-B";
sv.Cells[1, 2].Value = "2-C";
sv.Cells[1, 3].Value = "２行目のプレビュー行";

sv.Cells[2, 0].Value = "3-A";
sv.Cells[2, 1].Value = "3-B";
sv.Cells[2, 2].Value = "3-C";
sv.Cells[2, 3].Value = "３行目のプレビュー行";

// プレビュー行を表示し、スタイルを設定します。
sv.PreviewRowVisible = true;
sv.PreviewRowColumnIndex = 3;
sv.PreviewRowStyle.BackColor = System.Drawing.Color.AliceBlue;
sv.PreviewRowStyle.ForeColor = System.Drawing.Color.Navy;

// 3列目を非表示にします。
sv.Columns[3].Visible = false;

Dim sv As FarPoint.Web.Spread.SheetView
sv = FpSpread1.Sheets(0)

sv.ColumnCount = 4
sv.RowCount = 3

sv.Cells(0, 0).Value = "1-A"
sv.Cells(0, 1).Value = "1-B"
sv.Cells(0, 2).Value = "1-C"
sv.Cells(0, 3).Value = "１行目のプレビュー行"

sv.Cells(1, 0).Value = "2-A"
sv.Cells(1, 1).Value = "2-B"
sv.Cells(1, 2).Value = "2-C"
sv.Cells(1, 3).Value = "２行目のプレビュー行"

sv.Cells(2, 0).Value = "3-A"
sv.Cells(2, 1).Value = "3-B"
sv.Cells(2, 2).Value = "3-C"
sv.Cells(2, 3).Value = "３行目のプレビュー行"

' プレビュー行を表示し、スタイルを設定します。
sv.PreviewRowVisible = True
sv.PreviewRowColumnIndex = 3
sv.PreviewRowStyle.BackColor = System.Drawing.Color.AliceBlue
sv.PreviewRowStyle.ForeColor = System.Drawing.Color.Navy

' 3列目を非表示にします。
sv.Columns(3).Visible = False

© MESCIUS inc. All rights reserved.