印刷オプションの設定
印刷オプションの設定
これらの印刷オプションにより、ユーザーは次のような操作を行うことができます:
- ワークシート上の特定の印刷範囲を選択する。
- タイトルを印刷する。
- グリッド線を印刷する。
- 行/列見出しを印刷します。
- 下書き品質を実現する。
- コメントを印刷する。
- セルエラーを印刷する。
- ページ順序を定義する。
Aspose.Cells は Microsoft Excel が提供するすべての印刷オプションをサポートしており、開発者は PageSetup クラスが提供するプロパティを使用してワークシートのこれらのオプションを簡単に構成することが可能です。これらのプロパティの使用方法については、以下で詳しく説明します。
印刷範囲の設定
デフォルトでは、印刷エリアにはデータを含むワークシートのすべての領域が組み込まれます。開発者はワークシートの特定の印刷エリアを設定することができます。
特定の印刷エリアを選択するには、PageSetup クラスの PrintArea プロパティを使用します。このプロパティに、印刷エリアを定義するセル範囲を割り当てます。
// 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(); | |
// Obtaining the reference of the PageSetup of the worksheet | |
PageSetup pageSetup = workbook.Worksheets[0].PageSetup; | |
// Specifying the cells range (from A1 cell to T35 cell) of the print area | |
pageSetup.PrintArea = "A1:T35"; | |
// Save the workbook. | |
workbook.Save(dataDir + "SetPrintArea_out.xls"); |
印刷タイトルを設定する
Aspose.Cells を使用すると、印刷されるワークシートのすべてのページで行および列見出しを繰り返し指定することが可能です。これを行うには、PageSetup クラスの PrintTitleColumns および PrintTitleRows プロパティを使用します。
繰り返す行または列は、その行番号または列番号を渡すことで定義されます。たとえば、行は$1:$2と定義され、列は$A:$Bと定義されます。
// 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(); | |
// Obtaining the reference of the PageSetup of the worksheet | |
Aspose.Cells.PageSetup pageSetup = workbook.Worksheets[0].PageSetup; | |
// Defining column numbers A & B as title columns | |
pageSetup.PrintTitleColumns = "$A:$B"; | |
// Defining row numbers 1 & 2 as title rows | |
pageSetup.PrintTitleRows = "$1:$2"; | |
// Save the workbook. | |
workbook.Save(dataDir + "SetPrintTitle_out.xls"); |
その他の印刷オプションの設定
PageSetup クラスには、以下の一般的な印刷オプションを設定するためのいくつかの他のプロパティも提供されています:
- PrintGridlines: グリッド線を印刷するかどうかを定義するブール型のプロパティ。
- PrintHeadings: 行および列見出しを印刷するかどうかを定義するブール型のプロパティ。
- BlackAndWhite: ブラックアンドホワイトモードでワークシートを印刷するかどうかを定義するブールプロパティ。
- PrintComments: ワークシート上に印刷コメントを表示するか、ワークシートの最後に表示するかを定義する。
- PrintDraft: グラフィックを排除してシートを印刷するかどうかを定義するブールプロパティ。
- PrintErrors: 表示されるままのセルエラー、空白、ダッシュ、またはN/A として印刷するかを定義する。
Aspose.Cellsは、PrintComments と PrintErrors プロパティを設定するために、PrintCommentsType と PrintErrorsType という2つの列挙型を提供しています。これらの列挙型には、それぞれ PrintComments と PrintErrors プロパティに割り当てるための事前に定義された値が含まれています。
PrintCommentsType 列挙型の事前に定義された値は、以下にその説明とともにリストされています。
コメント印刷タイプ | 説明 |
---|---|
PrintInPlace | : ワークシート上に表示されているコメントを印刷することを指定。 |
PrintNoComments | : コメントを印刷しないことを指定。 |
PrintSheetEnd | : ワークシートの最後にコメントを印刷することを指定。 |
PrintErrorsType 列挙型の事前に定義された値は、以下にその説明とともにリストされています。
エラー印刷タイプ | 説明 |
---|---|
PrintErrorsBlank | : エラーを印刷しないことを指定。 |
PrintErrorsDash | : エラーを “–” として印刷することを指定。 |
PrintErrorsDisplayed | : 表示されているエラーを印刷することを指定。 |
PrintErrorsNA | : エラーを “#N/A” として印刷することを指定。 |
// 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(); | |
// Obtaining the reference of the PageSetup of the worksheet | |
PageSetup pageSetup = workbook.Worksheets[0].PageSetup; | |
// Allowing to print gridlines | |
pageSetup.PrintGridlines = true; | |
// Allowing to print row/column headings | |
pageSetup.PrintHeadings = true; | |
// Allowing to print worksheet in black & white mode | |
pageSetup.BlackAndWhite = true; | |
// Allowing to print comments as displayed on worksheet | |
pageSetup.PrintComments = PrintCommentsType.PrintInPlace; | |
// Allowing to print worksheet with draft quality | |
pageSetup.PrintDraft = true; | |
// Allowing to print cell errors as N/A | |
pageSetup.PrintErrors = PrintErrorsType.PrintErrorsNA; | |
// Save the workbook. | |
workbook.Save(dataDir + "OtherPrintOptions_out.xls"); |
ページ順の設定
PageSetup クラスは、ワークシートを印刷するための複数のページの順序を設定するために使用される Order プロパティを提供します。ページを順に印刷するためには、次の2つの可能性があります。
- Down then over: 右側のページを印刷する前に、すべてのページを下に印刷します。
- Over then down: 下側のページを印刷する前に、左から右のページを印刷します。
Aspose.Cellsは、PrintOrderType という列挙型を提供し、すべての事前に定義された順序タイプが含まれています。
列挙型 PrintOrderType の事前に定義された値は、以下にその説明とともにリストされています。
印刷順序タイプ | 説明 |
---|---|
DownThenOver | : 下に印刷してから右に印刷するよう指定。 |
OverThenDown | : 左から右に印刷してから下に印刷するよう指定。 |
// 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(); | |
// Obtaining the reference of the PageSetup of the worksheet | |
PageSetup pageSetup = workbook.Worksheets[0].PageSetup; | |
// Setting the printing order of the pages to over then down | |
pageSetup.Order = PrintOrderType.OverThenDown; | |
// Save the workbook. | |
workbook.Save(dataDir + "SetPageOrder_out.xls"); |