書式設定を適用する

テーブルの各要素は、異なる書式設定で適用できます。 たとえば、テーブルの書式設定はテーブル全体に適用され、行の書式設定は特定の行のみに適用され、セルの書式設定は特定のセルのみに適用されます。

Aspose.Wordsは、テーブルの書式設定を取得して適用するための豊富なAPIを提供します。 Table、RowFormat、およびCellFormatノードを使用して書式設定を設定できます。

この記事では、さまざまなテーブルノードに書式設定を適用する方法と、どのテーブル書式設定設定Aspose.Wordsがサポートするかについて説明します。

異なるノードに書式設定を適用する

このセクションでは、さまざまなテーブルノードに書式設定を適用する方法を見ていきます。

テーブルレベルの書式設定

テーブルに書式設定を適用するには、Table、PreferredWidth、およびTableCollectionクラスを使用して、対応するTableノードで使用可能なプロパティを使用できます。

以下の図は、Microsoft WordのTable書式設定機能とAspose.Wordsの対応するプロパティの表現を示しています。

formattin-features-table-level-aspose-words-cpp

formatting-table-options-aspose-words-cpp

次のコード例は、テーブルにアウトラインの境界線を適用する方法を示しています:

次のコード例は、すべての境界線を有効にしてテーブルを構築する方法を示しています(grid):

行レベルの書式設定

行レベル

以下の図は、Microsoft WordのRow書式設定機能とAspose.Wordsの対応するプロパティの表現を示しています。

formatting-row-level-aspose-words-cpp

次のコード例は、テーブルの行の書式を変更する方法を示しています:

セルレベルの書式設定

セルレベルの書式設定は、Cell、CellFormat、およびCellCollectionクラスによって制御されます。

以下の図は、Microsoft WordのCell書式設定機能とAspose.Wordsの対応するプロパティの表現を示しています。

formatting-cell-level-aspose-words-cpp

auto-formatting-cell-level-aspose-words-cpp

次のコード例は、テーブルセルの書式を変更する方法を示しています:

次のコード例は、セルの内容の左/上/右/下に追加するスペースの量（ポイント単位）を設定する方法を示しています:

行の高さの指定

行の高さを設定する最も簡単な方法は、DocumentBuilderを使用することです。 適切なRowFormatプロパティを使用して、デフォルトの高さ設定を設定するか、テーブル内の各行に異なる高さを適用できます。

Aspose.Wordsでは、テーブルの行の高さは次のように制御されます:

  • 行の高さプロパティ-Height
  • 指定された行の高さルールプロパティ–HeightRule

同時に、行ごとに異なる高さを設定することができます–これにより、テーブル設定を広く制御できます。

次のコード例は、単一のセルを含むテーブルを作成し、行の書式設定を適用する方法を示しています:

テーブル幅とセル幅の指定

Microsoft Word文書内のテーブルには、テーブルと個々のセルのサイズを変更するいくつかの異なる方法があります。 これらのプロパティを使用すると、テーブルの外観と動作を大幅に制御できるため、Aspose.WordsはMicrosoft Wordのようにテーブルの動作をサポートします。

テーブル要素には、テーブル全体の幅と個々のセルの計算方法に影響を与える可能性のあるいくつかの異なるプロパティが存在することを知っておく:

  • テーブルの好ましい幅
  • 個々のセルの優先幅
  • テーブル上でのオートフィットを許可する

この記事では、さまざまなテーブル幅計算プロパティがどのように機能するか、およびテーブル幅計算を完全に制御する方法について詳しく説明します。 これは テーブルレイアウトが期待どおりに表示されないような場合に知っておくと特に便利です。

好みの幅を使用する方法

テーブルまたは個々のセルの希望の幅は、要素が収まるように努力するサイズであるpreferred widthプロパティを介して定義されます。 すなわち、好ましい幅は、テーブル全体または個々のセルに対して指定することができる。 状況によっては、この幅を正確に合わせることができない場合がありますが、実際の幅はほとんどの場合、この値に近くなります。

適切な優先幅の型と値は、PreferredWidthクラスのメソッドを使用して設定されます:

  • autoまたは"優先幅なし"を指定するAutoメソッド
  • パーセンテージ幅を指定するFromPercentメソッド
  • ポイント単位で幅を指定するFromPointsメソッド

下の写真は、Microsoft Wordのpreferred width setting featuresとAspose.Wordsの対応するプロパティの表現を示しています。

formatting-table-properties-aspose-words-cpp

これらのオプションがドキュメント内の実際のテーブルにどのように適用されるかの例は、下の図で見ることができます。

todo:image_alt_text

優先するテーブルまたはセルの幅を指定します

Aspose.Wordsでは、テーブルとセルの幅はTable.PreferredWidthプロパティとCellFormat.PreferredWidthプロパティを使用して設定され、PreferredWidthType列挙で使用できるオプションがあります:

  • Autoは、優先幅セットがないことに相当します
  • Percentは、ウィンドウまたはコンテナのサイズ内の使用可能なスペースに相対的に要素を適合させ、使用可能な幅が変更されたときに値を再計算します
  • Pointsは、ポイント単位で指定された幅の要素に対応します

Table.PreferredWidthプロパティを使用すると、コンテナに対して優先される幅が調整されます。page、text column、またはネストされたテーブルの場合は外部テーブルcellです。

次のコード例は、テーブルをページ幅の50%に自動適合させるように設定する方法を示しています:

指定されたセルでCellFormat.PreferredWidthプロパティを使用すると、その優先幅が調整されます。

次のコード例は、さまざまな優先幅設定を設定する方法を示しています:

優先する幅のタイプと値を検索する

TypeプロパティとValueプロパティを使用して、目的のテーブルまたはセルの優先幅の詳細を見つけることができます。

次のコード例は、テーブルセルの優先幅の種類を取得する方法を示しています:

オートフィットを設定する方法

AllowAutoFitプロパティを使用すると、選択した基準に従ってテーブル内のセルを拡大および縮小できます。 たとえば、AutoFit to Windowオプションを使用してテーブルをページの幅に合わせ、AutoFit to Contentオプションを使用して各セルをその内容に応じて拡大または縮小できます。

既定では、Aspose.WordsはAutoFit to Windowを使用して新しいテーブルを挿入します。 テーブルのサイズは、使用可能なページ幅に応じて変更されます。 テーブルのサイズを変更するには、AutoFitメソッドを呼び出すことができます。 このメソッドは、テーブルに適用される自動調整のタイプを指定するAutoFitBehavior列挙体を受け入れます。

Autofitメソッドは、実際にはテーブルに異なるプロパティを同時に適用するショートカットであることを知っておくことが重要です。 これらは、実際にテーブルに観察された動作を与えるプロパティです。 各オートフィットオプションについて、これらのプロパティについて説明します。

次のコード例は、内容に応じて各セルを縮小または拡大するようにテーブルを設定する方法を示しています:

AutoFitテーブルからウィンドウへ

ウィンドウへの自動フィットがテーブルに適用されると、実際には次の操作が舞台裏で実行されます:

  1. Table.AllowAutoFitプロパティは、Table.PreferredWidthの値100を使用して、利用可能なコンテンツに合わせて列のサイズを自動的に変更することができます%
  2. CellFormat.PreferredWidthはすべてのテーブルセルから削除されます
  3. 列の幅は現在のテーブルの内容に対して再計算されます-最終的な結果は、使用可能な幅全体を占めるテーブルになります
  4. ユーザーがテキストを編集すると、テーブル内の列の幅が自動的に変更されます

次のコード例は、テーブルをページ幅に自動フィットさせる方法を示しています:

AutoFitテーブルからコンテンツへ

テーブルがコンテンツを自動入力されると、次の手順が実際に舞台裏で実行されます:

  1. Table.AllowAutoFitプロパティは、内容に応じて各セルのサイズを自動的に変更できるようになっています

  2. 優先テーブル幅はTable.PreferredWidthから削除され、CellFormat.PreferredWidthはテーブルセルごとに削除されます

  3. 最終的な結果は、ユーザーがテキストを編集するときにコンテンツに最適なサイズになるように、列幅とテーブル全体の幅が自動的にサイズ変更されるテー

次のコード例は、テーブルをそのコンテンツに自動フィットさせる方法を示しています:

テーブルでAutoFitを無効にし、固定列幅を使用する

テーブルの自動調整が無効になっていて、代わりに固定列幅が使用されている場合は、次の手順が実行されます:

  1. Table.AllowAutoFitプロパティが無効になっているため、列はコンテンツに拡大または縮小されません
  2. テーブル全体の優先幅はTable.PreferredWidthから削除され、CellFormat.PreferredWidthはすべてのテーブルセルから削除されます
  3. 最終的な結果は、列幅がCellFormat.Widthプロパティによって決定され、ユーザーがテキストを入力したとき、またはページのサイズが変更されたときに列が自動的にリ

次のコード例は、autofitを無効にし、指定したテーブルの固定幅を有効にする方法を示しています:

セル幅を計算する際の優先順位

Aspose.Wordsは、ユーザーがCellFormatを含む複数のオブジェクトを介してテーブルまたはセルの幅を定義することができます–そのWidthプロパティは、主に以前のバージョンから残

CellFormat.Widthプロパティは、テーブル内に既に存在する他のwidthプロパティに応じて異なる動作をすることを知っておくことが重要です。

Aspose.Wordsは、セル幅の計算に次の順序を使用します:

ご注文 プロパティ 説明
AllowAutoFitが決定されます AutoFitが有効な場合:
-テーブルは、コンテンツに対応するために、優先幅を超えて成長することがあります–それは通常、優先幅以下に縮小しません
-CellFormat.Width値への変更は無視され、代わりにセルはその内容に適合します
PreferredWidthType の値は Points または Percent です CellFormat.Widthは無視されます
PreferredWidthTypeの値がAutoの場合 CellFormat.Widthの値がコピーされ、セルの優先幅（ポイント単位）になります。

セル間の間隔を許可する

Microsoft Wordの"セル間隔"オプションと同様に、テーブルセル間に追加のスペースを取得または設定できます。 これはAllowCellSpacingプロパティを使用して行うことができます。

これらのオプションがドキュメント内の実際のテーブルにどのように適用されるかの例は、下の図で見ることができます。

formatting-spacing-between-cells-aspose-words-cpp

次のコード例は、セル間の間隔を設定する方法を示しています:

枠線と陰影を適用する

境界線と陰影は、Table.SetBorder、Table.SetBorders、Table.SetShadingを使用してテーブル全体に適用するか、CellFormat.BordersとCellFormat.Shadingを使用して特定のセルにのみ適用できます。 さらに、行の境界線はRowFormat.Bordersを使用して設定できますが、この方法ではシェーディングを適用できません。

下の図は、Microsoft Wordの境界線と影の設定、およびAspose.Wordsの対応するプロパティを示しています。

formatting-border-line-aspose-words-cpp

formatting-cell-color-aspose-words-cpp

次のコード例は、異なる境界線と陰影を使用してテーブルとセルを書式設定する方法を示しています:

テーブル内のテキストを操作する Word文書のテーブルスタイルを変更する