ページブレークの管理

改ページとは、テキストのページが終わり、次のページが始まる場所です。 Microsoft Excelはワークシートの選択したセルにいつでも改ページを追加できます。 改ページが追加されたセルでページが終わり、改ページ後のすべてのデータが次のページに印刷されます。 要するに、ページの区切りはワークシートを複数のページに分割します。 Aspose.Cellsを使用してワークシートにページを追加することも可能です。 Aspose.Cellsは、次の2種類の改ページをサポートしています。

• 横方向
• 縦方向

この記事では、Aspose.Cellsを使用してワークシートに横方向または縦方向の改ページを追加する方法について説明します。

Aspose.Cells＆改ページ

Aspose.Cellsは、Excelファイルを表すWorkbookクラスを提供します。 Workbookクラスには、Excelファイル内の各ワークシートにアクセスできるWorksheetCollectionが含まれています。

ワークシートは、ワークシートを管理するための幅広い範囲のプロパティとメソッドを提供するWorksheetクラスによって表されます。 改ページを追加するには、WorksheetクラスのHorizontalPageBreaksおよびVerticalPageBreaksプロパティを使用します。

HorizontalPageBreaksおよびVerticalPageBreaksプロパティは、実際には複数の改ページを含む可能性のあるコレクションです。 各コレクションには、横方向および縦方向の改ページを管理するためのいくつかのメソッドが含まれています。 これらのメソッドの使用方法については、以下で説明します。

ページブレークの追加

ワークシートに改ページを追加するには、Addメソッドを呼び出して指定したセルに縦方向および横方向の改ページを挿入します。

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
String dataDir = Utils.getSharedDataDir(AddingPageBreaks.class) + "worksheets/";
// Instantiating a Workbook object
Workbook workbook = new Workbook();

// Add a page break at cell Y30
WorksheetCollection worksheets = workbook.getWorksheets();
Worksheet worksheet = worksheets.get(0);
HorizontalPageBreakCollection hPageBreaks = worksheet.getHorizontalPageBreaks();
hPageBreaks.add("Y30");
VerticalPageBreakCollection vPageBreaks = worksheet.getVerticalPageBreaks();
vPageBreaks.add("Y30");

ページビューモードまたは印刷プレビューモードで、これらの改ページがどのように動作するかを確認できます。

すべてのページの改ページをクリアする

ワークシートのすべての改ページをクリアするには、Clearメソッドを呼び出します。

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
String dataDir = Utils.getSharedDataDir(AddingPageBreaks.class) + "worksheets/";
// Instantiating a Workbook object
Workbook workbook = new Workbook();
workbook.getWorksheets().get(0).getHorizontalPageBreaks().clear();
workbook.getWorksheets().get(0).getVerticalPageBreaks().clear();

特定の改ページを削除する

ワークシートから特定の改ページを削除するには、removeAtメソッドを呼び出して削除する改ページのインデックスを渡します。

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
String dataDir = Utils.getSharedDataDir(RemoveSpecificPageBreak.class) + "worksheets/";
// Instantiating a Workbook object
Workbook workbook = new Workbook(dataDir + "SampleXLSFile_38kb.xls");

// Removing a specific page break
WorksheetCollection worksheets = workbook.getWorksheets();
Worksheet worksheet = worksheets.get(0);
HorizontalPageBreakCollection hPageBreaks = worksheet.getHorizontalPageBreaks();
hPageBreaks.removeAt(0);
VerticalPageBreakCollection vPageBreaks = worksheet.getVerticalPageBreaks();
vPageBreaks.removeAt(0);

重要なこと: ページ設定のfit to pageプロパティ（すなわちFitToPagesTallとFitToPagesWide）を設定すると、ページの改ページ設定に影響が出ます。 そのため、ワークシートを印刷するときは、改ページ設定は考慮されませんが、ファイルにはまだ存在します。