セクションの操作
場合によっては、すべてのページにわたって同じ書式設定を持たないドキュメントが必要になることがあります。たとえば、ページ番号の形式を変更したり、ページのサイズや方向を変更したり、文書の最初のページを番号を付けずに表紙として使用したりする必要がある場合があります。セクションを使用するとそれを実現できます。
セクションは、ヘッダーとフッター、方向、列、余白、ページ番号の書式設定などを制御するレベル ノードです。
Aspose.Words を使用すると、セクションを管理し、ドキュメントをセクションに分割し、特定のセクションにのみ適用される書式変更を行うことができます。 Aspose.Words は、ヘッダーとフッター、ページ設定、セクション区切りの列設定などのセクションの書式設定に関する情報を保存します。
この記事では、セクションとセクション区切りの操作方法について説明します。
セクションとセクション区切りとは
ドキュメント セクションは、Section クラスと SectionCollection クラスによって表されます。セクション オブジェクトは Document ノードの直接の子であり、Sections プロパティを介してアクセスできます。これらのノードは、Remove、Add、IndexOf などのメソッドを使用して管理できます。
セクション区切りは、カスタマイズ可能なレイアウトを使用して文書ページをセクションに分割するオプションです。
セクション区切りの種類
Aspose.Words を使用すると、BreakType 列挙のさまざまなセクション区切りを使用してドキュメントを分割し、フォーマットすることができます。
- セクション区切り連続
- セクション区切り新しい列
- セクション区切り新しいページ
- セクション区切り偶数ページ
- セクション区切り奇数ページ
SectionStart 列挙を使用して、NewColumn、NewPage、EvenPage、OddPage など、最初のセクションにのみ適用されるブレーク タイプを選択することもできます。
セクションの管理
セクションは通常の複合ノードであるため、ノード操作 API 全体を使用してセクションを操作し、セクションに対する追加、削除、その他の操作を行うことができます。ノードの詳細については、Aspose.Words Document Object Model (DOM) の記事を参照してください。
一方、DocumentBuilder API を使用してセクションを操作することもできます。この記事では、セクションを操作するこの特定の方法に焦点を当てます。
セクション区切りの挿入または削除
Aspose.Words では、InsertBreak メソッドを使用してテキストにセクション区切りを挿入できます。
次のコード例は、ドキュメントにセクション区切りを挿入する方法を示しています。
セクション区切りを削除するには、Remove メソッドを使用します。特定のセクション区切りを削除する必要がなく、代わりにそのセクションのコンテンツを削除する場合は、ClearContent メソッドを使用できます。
次のコード例は、セクション区切りを削除する方法を示しています。
セクションを移動する
ドキュメント内のある位置から別の位置にセクションを移動する場合は、そのセクションのインデックスを取得する必要があります。 Aspose.Words では、Item プロパティを使用して SectionCollection からセクションの位置を取得できます。 Sections プロパティを使用すると、ドキュメント内のすべてのセクションを取得できます。ただし、最初のセクションのみを取得したい場合は、FirstSection プロパティを使用できます。
次のコード例は、最初のセクションにアクセスし、複合ノードの子を反復処理する方法を示しています。
セクションレイアウトの指定
ドキュメントのさまざまなセクションにクリエイティブなレイアウトを作成して、ドキュメントの見栄えを良くしたい場合があります。現在のセクション グリッドのタイプを指定する場合は、SectionLayoutMode 列挙を使用してセクション レイアウト モードを選択できます。
- デフォルト
- グリッド
- ライングリッド
- SnapToChars
次のコード例は、各ページの行数を制限する方法を示しています。
セクションを編集する
ドキュメントに新しいセクションを追加する場合、編集できる本文や段落はありません。 Aspose.Words では、EnsureMinimum メソッドを使用してセクションに少なくとも 1 つの段落を含む本文が含まれていることを保証できます。これにより、自動的に本文 (またはヘッダーフッター) ノードがドキュメントに追加され、次に段落が追加されます。
次のコード例は、EnsureMinimum を使用して新しいセクション ノードを準備する方法を示しています。
コンテンツを追加または先頭に追加
セクションの先頭/末尾に何らかの図形を描画したり、テキストや画像を追加したりする場合は、Section クラスの AppendContent メソッドと PrependContent メソッドを使用できます。
次のコード例は、既存のセクションのコンテンツを追加する方法を示しています。
セクションのクローンを作成する
Aspose.Words では、Clone メソッドを使用してセクションの完全なコピーを作成し、セクションを複製できます。
次のコード例は、ドキュメントの最初のセクションのクローンを作成する方法を示しています。
ドキュメント間でセクションをコピーする
場合によっては、多数のセクションを含む大きなドキュメントがあり、セクションの内容をあるドキュメントから別のドキュメントにコピーしたいことがあります。
Aspose.Words では、ImportNode メソッドを使用してドキュメント間でセクションをコピーできます。
次のコード例は、ドキュメント間でセクションをコピーする方法を示しています。
セクションヘッダーとフッターの操作
各セクションのヘッダーまたはフッターを表示するための基本的なルールは非常に簡単です。
- セクションに特定のタイプの独自のヘッダー/フッターがない場合は、前のセクションから取得されます。
- ページに表示されるヘッダー/フッターのタイプは、「異なる最初のページ」および「異なる奇数ページと偶数ページ」セクションの設定によって制御されます。これらが無効になっている場合、セクション自体のタイトルは無視されます。
次のコード例は、異なるヘッダーを持つ 2 つのセクションを作成する方法を示しています。
ドキュメント内の HeaderFooter オブジェクトを削除せずにヘッダーとフッターのテキストを削除する場合は、ClearHeadersFooters メソッドを使用できます。さらに、DeleteHeaderFooterShapes メソッドを使用して、ドキュメント内のヘッダーとフッターからすべての図形を削除できます。
次のコード例は、セクション内のすべてのヘッダーとフッターのコンテンツをクリアする方法を示しています。
次のコード例は、セクション内のすべてのヘッダー フッターからすべての図形を削除する方法を示しています。
セクションのページプロパティをカスタマイズする
ページまたはドキュメントを印刷する前に、単一ページまたはドキュメント全体のサイズとレイアウトをカスタマイズおよび変更することができます。ページ設定を使用すると、異なる最初のページまたは奇数ページを印刷するための余白、方向、サイズなどのドキュメント ページの設定を変更できます。
Aspose.Words では、PageSetup クラスを使用してページとセクションのプロパティをカスタマイズできます。
次のコード例は、現在のセクションのページ サイズや方向などのプロパティを設定する方法を示しています。
次のコード例は、すべてのセクションのページ プロパティを変更する方法を示しています。