テーブルの書式設定を適用する

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

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

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

別のノードにフォーマットを適用する

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

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

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

テーブルのプロパティを適用するには、テーブルに少なくとも 1 行が必要であることに注意してください。つまり、DocumentBuilder を使用してテーブルを構築する場合、この書式設定は、InsertCell への最初の呼び出し後、最初の行がテーブルに追加された後、またはノードが DOM に直接挿入されたときに実行する必要があります。

以下の図は、Microsoft Word での Table フォーマット機能と、Aspose.Words での対応するプロパティの表現を示しています。

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

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
Document doc = new Document(MyDir + "Tables.docx");

Table table = (Table) doc.GetChild(NodeType.Table, 0, true);
// Align the table to the center of the page.
table.Alignment = TableAlignment.Center;
// Clear any existing borders from the table.
table.ClearBorders();

// Set a green border around the table but not inside.
table.SetBorder(BorderType.Left, LineStyle.Single, 1.5, Color.Green, true);
table.SetBorder(BorderType.Right, LineStyle.Single, 1.5, Color.Green, true);
table.SetBorder(BorderType.Top, LineStyle.Single, 1.5, Color.Green, true);
table.SetBorder(BorderType.Bottom, LineStyle.Single, 1.5, Color.Green, true);

// Fill the cells with a light green solid color.
table.SetShading(TextureIndex.TextureSolid, Color.LightGreen, Color.Empty);

doc.Save(ArtifactsDir + "WorkingWithTableStylesAndFormatting.ApplyOutlineBorder.docx");

この例のサンプル ファイルは Aspose.Words GitHub からダウンロードできます。

次のコード例は、すべての枠線を有効にしたテーブル (グリッド) を作成する方法を示しています。

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
Document doc = new Document(MyDir + "Tables.docx");

Table table = (Table) doc.GetChild(NodeType.Table, 0, true);
            
// Clear any existing borders from the table.
table.ClearBorders();
            
// Set a green border around and inside the table.
table.SetBorders(LineStyle.Single, 1.5, Color.Green);

doc.Save(ArtifactsDir + "WorkingWithTableStylesAndFormatting.BuildTableWithBorders.docx");

この例のサンプル ファイルは Aspose.Words GitHub からダウンロードできます。

行レベルの書式設定

行レベル フォーマットは、Row、RowFormat、および RowCollection クラスを使用して制御できます。

Row は Table の子ノードのみになれることに注意してください。同時に、書式設定を適用できるように、Row 内に少なくとも 1 つの Cell が存在する必要があります。

以下の図は、Microsoft Word での Row フォーマット機能と、Aspose.Words での対応するプロパティの表現を示しています。

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

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
Document doc = new Document(MyDir + "Tables.docx");

Table table = (Table) doc.GetChild(NodeType.Table, 0, true);
            
// Retrieve the first row in the table.
Row firstRow = table.FirstRow;
firstRow.RowFormat.Borders.LineStyle = LineStyle.None;
firstRow.RowFormat.HeightRule = HeightRule.Auto;
firstRow.RowFormat.AllowBreakAcrossPages = true;

この例のサンプル ファイルは Aspose.Words GitHub からダウンロードできます。

セルレベルの書式設定

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

Cell は Row の子ノードのみになれることに注意してください。同時に、書式設定を適用できるように、Cell 内に少なくとも 1 つの Paragraph が存在する必要があります。

Paragraph に加えて、Table を Cell に挿入することもできます。

以下の図は、Microsoft Word での Cell フォーマット機能と、Aspose.Words での対応するプロパティの表現を示しています。

次のコード例は、表のセルの書式設定を変更する方法を示しています。

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
Document doc = new Document(MyDir + "Tables.docx");
Table table = (Table) doc.GetChild(NodeType.Table, 0, true);

Cell firstCell = table.FirstRow.FirstCell;
firstCell.CellFormat.Width = 30;
firstCell.CellFormat.Orientation = TextOrientation.Downward;
firstCell.CellFormat.Shading.ForegroundPatternColor = Color.LightGreen;

この例のサンプル ファイルは Aspose.Words GitHub からダウンロードできます。

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

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

builder.StartTable();
builder.InsertCell();

// Sets the amount of space (in points) to add to the left/top/right/bottom of the cell's contents.
builder.CellFormat.SetPaddings(30, 50, 30, 50);
builder.Writeln("I'm a wonderful formatted cell.");

builder.EndRow();
builder.EndTable();

doc.Save(ArtifactsDir + "WorkingWithTableStylesAndFormatting.CellPadding.docx");

行の高さを指定する

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

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

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

同時に、各行に異なる高さを設定できるため、テーブル設定を幅広く制御できます。

オブジェクトの高さを指定するルール オプションは、HeightRule 列挙を使用して設定できます。

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

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

Table table = builder.StartTable();
builder.InsertCell();

RowFormat rowFormat = builder.RowFormat;
rowFormat.Height = 100;
rowFormat.HeightRule = HeightRule.Exactly;
            
// These formatting properties are set on the table and are applied to all rows in the table.
table.LeftPadding = 30;
table.RightPadding = 30;
table.TopPadding = 30;
table.BottomPadding = 30;

builder.Writeln("I'm a wonderful formatted row.");

builder.EndRow();
builder.EndTable();

doc.Save(ArtifactsDir + "WorkingWithTableStylesAndFormatting.ApplyRowFormatting.docx");

テーブルとセルの幅を指定する

Microsoft Word ドキュメントのテーブルには、テーブルと個々のセルのサイズを変更するためのいくつかの異なる方法が用意されています。これらのプロパティを使用すると、テーブルの外観と動作を大幅に制御できるため、Aspose.Words は Microsoft Word と同様にテーブルの動作をサポートします。

テーブル要素には、個々のセルだけでなくテーブル全体の幅の計算方法に影響を与える可能性があるいくつかの異なるプロパティがあることを理解しておくことが重要です。

• テーブル上の好みの幅
• 個々のセルの推奨幅
• テーブル上での自動調整を許可する

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

ほとんどの場合、テーブル幅よりも優先セルの方が推奨されます。推奨されるセル幅は、Aspose.Words モデルだけでなく DOCX フォーマット仕様にもより準拠しています。

セル幅は実際には DOCX 形式の計算値です。実際のセル幅はさまざまな要因によって決まります。たとえば、ページの余白や優先される表の幅を変更すると、実際のセルの幅に影響を与える可能性があります。

推奨されるセル幅は、ドキュメントに保存されているセルのプロパティです。これは何にも依存せず、テーブルやセルの他のプロパティを変更しても変わりません。

この記事で説明するすべてのプロパティとメソッドは、Microsoft Word でのテーブルの動作に関連しています。したがって、ほとんどの場合、テーブルをプログラムで構築しているものの、目的のテーブルを作成するのが難しい場合は、まず Microsoft Word で視覚的にテーブルを作成してから、書式設定の値をアプリケーションにコピーするだけです。

優先幅の使用方法

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

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

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

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

これらのオプションがドキュメント内の実際のテーブルにどのように適用されるかの例を以下の図に示します。

テーブルで優先幅を使用する前に、テーブルに少なくとも 1 行が含まれていることを確認する必要があります。これは、Microsoft Word ドキュメントまたは Aspose.Words で作成されたドキュメント内のこのようなテーブルの書式設定がテーブルの行に保存されるためです。

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

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

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

デフォルトでは、テーブルはページ上の利用可能なスペースの 100% に収まるように説明できます。この場合、これは表が左右のページ余白の間のスペースを占有しようとすることを意味します。

Table.PreferredWidth プロパティを使用すると、そのコンテナー (ネストされたテーブルの場合はページ、テキスト列、または外部テーブルのセル) に応じて優先幅が調整されます。

次のコード例は、表をページ幅の 50% に自動調整するように設定する方法を示しています。

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Insert a table with a width that takes up half the page width.
Table table = builder.StartTable();

builder.InsertCell();
table.PreferredWidth = PreferredWidth.FromPercent(50);
builder.Writeln("Cell #1");

builder.InsertCell();
builder.Writeln("Cell #2");

builder.InsertCell();
builder.Writeln("Cell #3");

doc.Save(ArtifactsDir + "WorkingWithTables.AutoFitPageWidth.docx");

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

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

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Insert a table row made up of three cells which have different preferred widths.
// Insert an absolute sized cell.
builder.InsertCell();
builder.CellFormat.PreferredWidth = PreferredWidth.FromPoints(40);
builder.CellFormat.Shading.BackgroundPatternColor = Color.LightYellow;
builder.Writeln("Cell at 40 points width");

// Insert a relative (percent) sized cell.
builder.InsertCell();
builder.CellFormat.PreferredWidth = PreferredWidth.FromPercent(20);
builder.CellFormat.Shading.BackgroundPatternColor = Color.LightBlue;
builder.Writeln("Cell at 20% width");

// Insert a auto sized cell.
builder.InsertCell();
builder.CellFormat.PreferredWidth = PreferredWidth.Auto;
builder.CellFormat.Shading.BackgroundPatternColor = Color.LightGreen;
builder.Writeln(
    "Cell automatically sized. The size of this cell is calculated from the table preferred width.");
builder.Writeln("In this case the cell will fill up the rest of the available space.");

doc.Save(ArtifactsDir + "WorkingWithTables.PreferredWidthSettings.docx");

推奨される幅のタイプと値を見つける

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

次のコード例は、表のセルの推奨幅タイプを取得する方法を示しています。

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
Document doc = new Document(MyDir + "Tables.docx");

Table table = (Table) doc.GetChild(NodeType.Table, 0, true);
table.AllowAutoFit = true;

Cell firstCell = table.FirstRow.FirstCell;
PreferredWidthType type = firstCell.CellFormat.PreferredWidth.Type;
double value = firstCell.CellFormat.PreferredWidth.Value;

この例のサンプル ファイルは Aspose.Words GitHub からダウンロードできます。

自動調整の設定方法

AllowAutoFit プロパティを使用すると、選択した基準に従ってテーブル内のセルを拡大および縮小できます。たとえば、ウィンドウに自動フィット オプションを使用して表をページの幅に合わせたり、コンテンツに自動フィット オプションを使用して各セルを内容に応じて拡大または縮小したりできます。

さらに、AllowAutoFit プロパティを優先セル幅と組み合わせて使用すると、内容に自動的に適合するセルの書式設定を行うことができますが、初期幅も設定されています。必要に応じて、セル幅をこの幅を超えて拡大することができます。

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

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

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

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
table.AllowAutoFit = true;

テーブルをウィンドウに自動調整

ウィンドウへの自動調整がテーブルに適用されると、実際には次の操作がバックグラウンドで実行されます。

1. Table.AllowAutoFit プロパティが有効になり、Table.PreferredWidth 値 100% を使用して、利用可能なコンテンツに合わせて列のサイズを自動的に変更します。
2. 表のすべてのセルから CellFormat.PreferredWidth が削除されます
   これは、各セルの優先幅が現在のサイズと内容に基づいて適切な値に設定される Microsoft Word の動作とは若干異なることに注意してください。 Aspose.Words は優先幅を更新しないため、代わりにクリアされるだけです。
3. 現在のテーブルの内容に合わせて列幅が再計算されます。最終結果は、使用可能な幅全体を占めるテーブルになります。
4. ユーザーがテキストを編集すると、テーブルの列の幅が自動的に変わります。

次のコード例は、表をページ幅に自動調整する方法を示しています。

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
Document doc = new Document(MyDir + "Tables.docx");

Table table = (Table) doc.GetChild(NodeType.Table, 0, true);
// Autofit the first table to the page width.
table.AutoFit(AutoFitBehavior.AutoFitToWindow);

doc.Save(ArtifactsDir + "WorkingWithTables.AutoFitTableToWindow.docx");

この例のサンプル ファイルは Aspose.Words GitHub からダウンロードできます。

テーブルをコンテンツに自動調整

テーブルの内容が自動調整されると、実際には次の手順がバックグラウンドで実行されます。

1. Table.AllowAutoFit プロパティが有効になり、内容に応じて各セルのサイズが自動的に変更されます。

2. 優先テーブル幅が Table.PreferredWidth から削除され、CellFormat.PreferredWidth が各テーブル セルから削除されます。

   この自動調整オプションは、Microsoft Word と同様に、セルから推奨幅を削除することに注意してください。列のサイズを維持し、コンテンツに合わせて列を増減したい場合は、自動調整ショートカットを使用するのではなく、独自に Table.AllowAutoFit プロパティを True に設定する必要があります。

3. 現在のテーブルの内容に合わせて列の幅が再計算されます。最終的には、ユーザーがテキストを編集すると、列の幅とテーブル全体の幅がコンテンツに最適になるように自動的にサイズ変更されるテーブルが作成されます。

次のコード例は、テーブルをそのコンテンツに自動調整する方法を示しています。

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
Document doc = new Document(MyDir + "Tables.docx");

Table table = (Table) doc.GetChild(NodeType.Table, 0, true);
table.AutoFit(AutoFitBehavior.AutoFitToContents);

doc.Save(ArtifactsDir + "WorkingWithTables.AutoFitTableToContents.docx");

この例のサンプル ファイルは Aspose.Words GitHub からダウンロードできます。

表の自動調整を無効にし、固定列幅を使用する

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

1. Table.AllowAutoFit プロパティが無効になっているため、列は内容に合わせて拡大または縮小されません。

2. テーブル全体の推奨幅が Table.PreferredWidth から削除され、CellFormat.PreferredWidth がすべてのテーブル セルから削除されます。

3. 最終結果は、列幅が CellFormat.Width プロパティによって決定され、ユーザーがテキストを入力したときやページのサイズが変更されたときに列のサイズが自動的に変更されない表になります。

CellFormat.Width に幅が指定されていない場合は、デフォルト値の 1 インチ (72 ポイント) が使用されることに注意してください。

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

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
Document doc = new Document(MyDir + "Tables.docx");

Table table = (Table) doc.GetChild(NodeType.Table, 0, true);
// Disable autofitting on this table.
table.AutoFit(AutoFitBehavior.FixedColumnWidths);

doc.Save(ArtifactsDir + "WorkingWithTables.AutoFitTableToFixedColumnWidths.docx");

この例のサンプル ファイルは Aspose.Words GitHub からダウンロードできます。

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

Aspose.Words を使用すると、ユーザーは CellFormat を含む複数のオブジェクトを通じてテーブルまたはセルの幅を定義できます。その Width プロパティはほとんどが以前のバージョンから残されていますが、セル幅の設定を簡素化するのに依然として役立ちます。

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

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

注文	財産	説明
1	AllowAutoFitが決定	AutoFit が有効な場合: - テーブルは、コンテンツを収容するために優先幅を超えて拡大する場合があります。通常、優先幅よりも縮小することはありません - CellFormat.Width 値への変更は無視され、セルはその内容に合わせて表示されます。
2	Points または Percent の値を持つ PreferredWidthType	CellFormat.Widthは無視されます
3	値がAutoのPreferredWidthType	CellFormat.Width からの値がコピーされ、セルの優先幅 (ポイント単位) になります。

width プロパティへの変更は優先幅では更新されないため、代わりに優先幅に適用する必要があります。

固定テーブル レイアウトを作成するときに、セルの幅を指定します。幅のないセルは DOC 形式で保存できません。 DOCX などの DOC 以外のドキュメント形式では、原則として、固定テーブル レイアウトで幅のないセルを保存できます。

セル間の間隔を許可する

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

これらのオプションがドキュメント内の実際のテーブルにどのように適用されるかの例を以下の図に示します。

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

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
Document doc = new Document(MyDir + "Tables.docx");

Table table = (Table) doc.GetChild(NodeType.Table, 0, true);
table.AllowCellSpacing = true;
table.CellSpacing = 2;
            
doc.Save(ArtifactsDir + "WorkingWithTableStylesAndFormatting.AllowCellSpacing.docx");

境界線とシェーディングを適用する

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

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

次のコード例は、異なる枠線と網掛けを使用してテーブルとセルを書式設定する方法を示しています。

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

Table table = builder.StartTable();
builder.InsertCell();

// Set the borders for the entire table.
table.SetBorders(LineStyle.Single, 2.0, Color.Black);
            
// Set the cell shading for this cell.
builder.CellFormat.Shading.BackgroundPatternColor = Color.Red;
builder.Writeln("Cell #1");

builder.InsertCell();
            
// Specify a different cell shading for the second cell.
builder.CellFormat.Shading.BackgroundPatternColor = Color.Green;
builder.Writeln("Cell #2");

builder.EndRow();

// Clear the cell formatting from previous operations.
builder.CellFormat.ClearFormatting();

builder.InsertCell();

// Create larger borders for the first cell of this row. This will be different
// compared to the borders set for the table.
builder.CellFormat.Borders.Left.LineWidth = 4.0;
builder.CellFormat.Borders.Right.LineWidth = 4.0;
builder.CellFormat.Borders.Top.LineWidth = 4.0;
builder.CellFormat.Borders.Bottom.LineWidth = 4.0;
builder.Writeln("Cell #3");

builder.InsertCell();
builder.CellFormat.ClearFormatting();
builder.Writeln("Cell #4");
            
doc.Save(ArtifactsDir + "WorkingWithTableStylesAndFormatting.FormatTableAndCellWithDifferentBorders.docx");