推奨幅設定

導入

表は、Word 文書内の情報を整理して提示するための強力な手段です。Aspose.Words for .NET で表を操作する場合、表のセルの幅を設定して、文書のレイアウトにぴったり合うようにするためのオプションがいくつかあります。このガイドでは、絶対、相対、自動のサイズ変更オプションに焦点を当て、Aspose.Words for .NET を使用して、好みの幅設定で表を作成する手順を説明します。

前提条件

チュートリアルに進む前に、次のものを用意してください。

Aspose.Words for .NET: 開発環境にAspose.Words for .NETがインストールされていることを確認してください。ダウンロードできます。ここ.
.NET 開発環境: Visual Studio などの .NET 開発環境をセットアップします。
C# の基礎知識: C# プログラミングに精通していると、コードスニペットや例をよりよく理解できるようになります。
Aspose.Wordsドキュメント:Aspose.Words ドキュメント詳細な API 情報と参考資料については、こちらをご覧ください。

名前空間のインポート

コーディングを開始する前に、必要な名前空間を C# プロジェクトにインポートする必要があります。

using Aspose.Words;
using Aspose.Words.Tables;

これらの名前空間は、Aspose.Words と Table オブジェクトのコア機能へのアクセスを提供し、ドキュメントテーブルを操作できるようにします。

さまざまな推奨幅設定を持つテーブルを作成するプロセスを、明確で管理しやすい手順に分解してみましょう。

ステップ 1: ドキュメントと DocumentBuilder を初期化する

見出し: 新しいドキュメントと DocumentBuilder の作成

説明: まず、新しいWord文書を作成し、DocumentBuilderインスタンス。DocumentBuilderクラスは、ドキュメントにコンテンツを追加する簡単な方法を提供します。

//ドキュメントを保存するパスを定義します。
string dataDir = "YOUR DOCUMENT DIRECTORY";

//新しいドキュメントを作成します。
Document doc = new Document();

//このドキュメントの DocumentBuilder を作成します。
DocumentBuilder builder = new DocumentBuilder(doc);

ここでは、ドキュメントを保存するディレクトリを指定し、DocumentそしてDocumentBuilderオブジェクト。

ステップ2: 絶対幅を持つ最初の表セルを挿入する

最初のセルを 40 ポイントの固定幅で表に挿入します。これにより、表のサイズに関係なく、このセルの幅が常に 40 ポイントに維持されます。

//絶対サイズのセルを挿入します。
builder.InsertCell();
builder.CellFormat.PreferredWidth = PreferredWidth.FromPoints(40);
builder.CellFormat.Shading.BackgroundPatternColor = Color.LightYellow;
builder.Writeln("Cell at 40 points width");

このステップでは、表の作成を開始し、絶対幅のセルを挿入します。PreferredWidth.FromPoints(40)メソッドはセルの幅を40ポイントに設定し、Shading.BackgroundPatternColor明るい黄色の背景色を適用します。

ステップ3: 相対サイズのセルを挿入する

表全体の幅の 20% の幅を持つ別のセルを挿入します。この相対的なサイズ設定により、セルが表の幅に比例して調整されます。

//相対（パーセント）サイズのセルを挿入します。
builder.InsertCell();
builder.CellFormat.PreferredWidth = PreferredWidth.FromPercent(20);
builder.CellFormat.Shading.BackgroundPatternColor = Color.LightBlue;
builder.Writeln("Cell at 20% width");

このセルの幅はテーブル全体の幅の 20% になり、さまざまな画面サイズやドキュメントレイアウトに適応できるようになります。

ステップ4: 自動サイズ調整セルを挿入する

最後に、テーブル内の残りの使用可能なスペースに基づいて自動的にサイズが決定されるセルを挿入します。

//自動サイズ調整されたセルを挿入します。
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.");

のPreferredWidth.Autoこの設定により、他のセルを考慮した後に残ったスペースに基づいて、このセルを拡大または縮小できます。これにより、テーブルレイアウトがバランスが取れてプロフェッショナルに見えるようになります。

ステップ5: ドキュメントを完成させて保存する

すべてのセルを挿入したら、表を完成させ、指定したパスにドキュメントを保存します。

//ドキュメントを保存します。
doc.Save(dataDir + "WorkingWithTables.PreferredWidthSettings.docx");

この手順では、テーブルを最終決定し、指定したディレクトリに「WorkingWithTables.PreferredWidthSettings.docx」というファイル名でドキュメントを保存します。

結論

Aspose.Words for .NET で好みの幅設定を使用して表を作成するのは、利用可能なさまざまなサイズ設定オプションを理解すれば簡単です。固定、相対、自動のセル幅のいずれが必要であっても、Aspose.Words はさまざまな表レイアウトシナリオを効率的に処理する柔軟性を提供します。このガイドで説明されている手順に従うことで、Word 文書内の表が適切に構造化され、視覚的に魅力的になることを保証できます。

よくある質問

絶対セル幅と相対セル幅の違いは何ですか?

絶対セル幅は固定されており変化しませんが、相対幅はテーブルの合計幅に基づいて調整されます。

相対的な幅に負のパーセンテージを使用できますか?

いいえ、セル幅には負のパーセンテージは無効です。正のパーセンテージのみが許可されます。

自動サイズ調整機能はどのように機能しますか?

自動サイズ調整では、他のセルのサイズが変更された後、テーブル内の残りのスペースを埋めるためにセルの幅が調整されます。

幅設定が異なるセルに異なるスタイルを適用できますか?

はい、セルの幅の設定に関係なく、さまざまなスタイルと書式設定をセルに適用できます。

テーブルの合計幅がすべてのセルの幅の合計より小さい場合はどうなりますか?

テーブルは、使用可能なスペース内に収まるようにセルの幅を自動的に調整するため、一部のセルが縮小される可能性があります。