PowerTools SPREAD for ASP.NET 8.0J > 開発者の手引き > データ操作 > ページング > ページナビゲーション |
ページングが有効の場合、ページ移動用のボタンが搭載されたページャーが、デフォルトではコマンドバー上に表示されます。
ページナビゲーション機能には、次に進むボタン(右矢印)と1つ前に戻るボタン(左矢印)、およびページ番号表示があります。表示するナビゲーションボタンの種類、およびコンポーネント上の表示位置を設定できます。
ページナビゲーション機能をカスタマイズするには、PagerInfo クラスを使用します。PagerInfo クラスはFpSpread クラスのPager プロパティが参照し、以下のような機能を設定できます。
Mode プロパティを使用して、次に進む矢印(>>)と前に戻る矢印(<<)、ページ番号、またはそのすべてを表示するかどうかを設定します。次に進む矢印と前に戻る矢印をクリックすると、対応するページ番号をクリックした場合と同様に、指定した数のページだけ進み(戻り)、そのページの行セットが表示されます。
ButtonType プロパティを使用して、ボタンのタイプ(イメージ、リンク、またはプッシュボタン)を設定します。
Position プロパティを使用して、ページナビゲーションの表示位置をシートの上部または下部、コマンドバー上、またはこれらの組み合わせのどれにするかを設定できます。コマンドバーに表示する場合の設定事項や注意点は「コマンドバーのナビゲーションボタン」を参照してください。
Mode プロパティをPagerMode.Both またはPagerMode.Number に設定しているとき、PageCount プロパティを使用して表示するページ番号の数を設定できます。ページ数がPageCount プロパティの値を超えると、省略記号(...)が表示されます。
メモ: 表示ページ(行のセット)が変更されるのは、別のページ番号をクリックしたときと、前後のページに移動する矢印をクリックしたときのみです。 省略記号をクリックしても、ページは変更されません。 |
ページナビゲーションを上部または下部のバー(またはその両方)に表示する場合は、Align プロパティを使用してその配置を設定できます。この設定は、コマンドバー上の表示には影響しません。
BackColor プロパティ、ForeColor プロパティ、Font プロパティを使用してナビゲーションボタンの背景色、文字色およびフォントを設定できます。また、CssClass プロパティにはナビゲーションボタンに適用するCSSを指定することができます。
次の図は、ページナビゲーションのさまざまな設定を適用した例です。
次のサンプルコードは、ページナビゲーションボタンをコントロール上部、シート上の個別のツールバーに表示します。 ページ番号、ページ移動矢印をすべて表示し、フォントと色を指定します。これらの機能は、上部のバーに右揃えで配置します(下図を参照)。
// シート数を設定します。 FpSpread1.Sheets.Count = 5; // 最初のシート内の行数を設定します。 FpSpread1.Sheets[0].RowCount = 136; // このシートのページあたりの行数を設定します。 FpSpread1.Sheets[0].PageSize = 13; // ページ ナビゲーション機能はコントロール上部に表示します。 FpSpread1.Pager.Position = FarPoint.Web.Spread.PagerPosition.Top; // モードを設定し、ページ番号とページ移動矢印を表示します。 // モードの設定は、配置の設定後に行わないとエラーとなります。 FpSpread1.Pager.Mode = FarPoint.Web.Spread.PagerMode.Both; // 上部のナビゲーション機能のテキストを書式設定します。 FpSpread1.Pager.Align = HorizontalAlign.Right; FpSpread1.Pager.Font.Bold = true; FpSpread1.Pager.Font.Name = "Trebuchet MS"; FpSpread1.Pager.ForeColor = Color.Brown; FpSpread1.Pager.BackColor = Color.Orange; // 一度に最大4つのページ番号を表示します。 FpSpread1.Pager.PageCount = 4;
' シート数を設定します。 FpSpread1.Sheets.Count = 5 ' 先頭シート内の行数を設定します。 FpSpread1.Sheets(0).RowCount = 136 ' このシートのページあたりの行数を設定します。 FpSpread1.Sheets(0).PageSize = 13 ' ページ ナビゲーション機能はコントロール上部に表示します。 FpSpread1.Pager.Position = FarPoint.Web.Spread.PagerPosition.Top ' モードを設定し、ページ番号とページ移動矢印を表示します。 ' モードの設定は、配置の設定後に行わないとエラーとなります。 FpSpread1.Pager.Mode = FarPoint.Web.Spread.PagerMode.Both ' 上部のナビゲーション機能のテキストを書式設定します。 FpSpread1.Pager.Align = HorizontalAlign.Right FpSpread1.Pager.Font.Bold = True FpSpread1.Pager.Font.Name = "Trebuchet MS" FpSpread1.Pager.ForeColor = Color.Brown FpSpread1.Pager.BackColor = Color.Orange ' 一度に最大4つのページ番号を表示します。 FpSpread1.Pager.PageCount = 4