ページブレークの管理

定義によると、ページブレークはテキストフローの中で１つのページが終わり、次のページが始まる場所です。Microsoft Excelでは、ユーザーは任意の選択したワークシートのセルにページブレークを追加できます。

ページブレークが追加されるセルの位置によっては、ページが終了し、ページブレークの後のデータの残りが次のページで印刷されます。単純に言えば、ページブレークは、指定に応じてワークシートを複数のページに分割します。Aspose.Cellsを使用して、実行時にワークシートにページブレークを追加することもできます。Aspose.Cellsでは、以下の2種類のページブレークを追加できます。

• 水平ページブレーク
• 垂直ページブレーク

後続の議論では、Aspose.Cellsを使用して、どのようにしてワークシートに水平または垂直のページブレークを追加できるかについて説明します。

ページブレーク

Aspose.CellsはExcelファイルを表すWorkbookクラスを提供します。Workbookクラスには、Excelファイル内の各ワークシートにアクセスするためのWorksheetsコレクションが含まれています。

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

ページブレークを追加するには、WorksheetクラスのHorizontalPageBreaksおよびVerticalPageBreaksプロパティを使用します。

HorizontalPageBreaksおよびVerticalPageBreaksプロパティは、いくつかのページブレークを含む可能性があるコレクションであり、各コレクションには水平および垂直ページブレークを管理するためのいくつかのメソッドが含まれています。

ページブレークの追加

ワークシートにページブレークを追加するには、各Addメソッドに追加するページブレークが配置されるセルの名前を指定して呼び出します。

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// The path to the documents directory.
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);

// Instantiating a Workbook object
Workbook workbook = new Workbook();

// Add a page break at cell Y30
workbook.Worksheets[0].HorizontalPageBreaks.Add("Y30");
workbook.Worksheets[0].VerticalPageBreaks.Add("Y30");

// Save the Excel file.
workbook.Save(dataDir + "AddingPageBreaks_out.xls");

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

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

ワークシートのすべてのページブレークをクリアするには、各HorizontalPageBreakCollectionおよびVerticalPageBreakCollectionコレクションのClear()メソッドを呼び出します。

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// The path to the documents directory.
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);

// Instantiating a Workbook object
Workbook workbook = new Workbook();

// Clearing all page breaks
workbook.Worksheets[0].HorizontalPageBreaks.Clear();
workbook.Worksheets[0].VerticalPageBreaks.Clear();

// Save the Excel file.
workbook.Save(dataDir + "ClearAllPageBreaks_out.xls");

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

特定のページブレークを削除するには、各RemoveAtメソッドに削除されるページブレークのインデックスを指定して呼び出します。

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// The path to the documents directory.
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);

// Instantiating a Workbook object
Workbook workbook = new Workbook(dataDir + "PageBreaks.xls");

// Removing a specific page break
workbook.Worksheets[0].HorizontalPageBreaks.RemoveAt(0);
workbook.Worksheets[0].VerticalPageBreaks.RemoveAt(0);

// Save the Excel file.
workbook.Save(dataDir + "RemoveSpecificPageBreak_out.xls");

重要なこと

ページ設定の設定でFitToPagesプロパティ（すなわちFitToPagesTallおよびFitToPagesWide）を設定すると、ページブレークの設定が影響を受けます。そのため、ワークシートを印刷する場合、ページブレークの設定は考慮されませんが、それらはまだ設定されています。