テーブルのフォーマットを適用します
テーブルの各要素は異なるフォーマットで適用できます。 たとえば、テーブルの書式は、特定の行だけに整形する行、特定のセルだけに整形するセルです。
Aspose.Words 豊富な API フォーマットをテーブルに取得し、適用するために。 使うことができます。 Table, RowFormat, そして、 CellFormat フォーマットを設定するノード。
この記事では、異なるテーブルノードとどのようなテーブルのフォーマット設定を適用する方法について説明します。 Aspose.Words サポート
別のノードにフォーマットを適用
このセクションでは、様々なテーブルノードのフォーマットを適用します。
テーブルレベルのフォーマット
対応するテーブルに書式を適用するには、対応するプロパティを使用できる Table ノードを使用して Table, PreferredWidth, そして、 TableCollection クラス。
下の写真は、次の表現を示しています Table フォーマット機能 Microsoft Word およびその対応するプロパティ Aspose.Wordsお問い合わせ
以下のコードの例では、輪郭の境界をテーブルに適用する方法を示します。
次のコードの例では、すべての境界が有効になっているテーブルを作成する方法を示します(グリッド):
列レベルのフォーマット
Row-level** の書式設定はを使用して制御することができます Row, RowFormat, そして、 RowCollection クラス。
下の写真は、次の表現を示しています Row フォーマット機能 Microsoft Word およびその対応するプロパティ Aspose.Wordsお問い合わせ
次のコードの例では、テーブル行の書式を変更する方法を示します。
セルレベルフォーマット
セルレベルのフォーマットは、 Cell, CellFormat, そして、 CellCollection クラス。
注意: Cell 子ノードのみが Rowお問い合わせ 同時に、少なくとも1つである必要があります Paragraph お問い合わせ Cell フォーマットが適用できるようにします。
その他にも Paragraph, インサートもできます Table お問い合わせ Cellお問い合わせ
下の写真は、次の表現を示しています Cell フォーマット機能 Microsoft Word およびその対応するプロパティ Aspose.Wordsお問い合わせ
次のコードの例では、テーブルセルの書式を変更する方法を示します。
次のコードの例では、セルのコンテンツの左/上/右/下に追加するスペース(ポイント)の量を設定する方法を示します。
行の高さを指定する
行の高さを設定する最も簡単な方法は、 DocumentBuilderお問い合わせ 適切な使用 RowFormat プロパティは、デフォルト高さの設定を設定したり、テーブル内の各行の異なる高さを適用することができます。
インスタグラム Aspose.Words, テーブルの列の高さは制御されます:
- 行の高さプロパティ - Height
- 与えられた行の高さルールプロパティ - HeightRule
同時に、各行ごとに異なる高さを設定できます。これにより、テーブルの設定を広く制御できます。
次のコードの例では、単一セルを含むテーブルを作成し、行の書式を適用する方法を示します。
テーブルとセルの幅を指定する
テーブル Microsoft Word 文書は、テーブルと個々のセルのサイズを変更するいくつかの異なる方法を提供します。 これらのプロパティは、テーブルの外観と動作をかなり制御できるようにします。 Aspose.Words テーブルの動作をサポート Microsoft Wordお問い合わせ
テーブル要素は、テーブル全体テーブルの幅や個々のセルの幅に影響を与えることができるいくつかの異なる特性を提示していることを知ることが重要です。
- テーブルの優先幅
- 個々の細胞の優先幅
- テーブルのオートフィットを許可する
この記事では、さまざまなテーブル幅の計算特性が機能し、テーブル幅の計算を完全に制御する方法について説明します。 お問い合わせ 特にテーブルレイアウトが期待どおりに表示されないような場合に知っておくのに便利です。
ほとんどの場合、テーブル幅よりも優先セルが推奨されます。 好みのセル幅はDOCXのフォーマット指定およびまたラインで多くあります Aspose.Words モデル。
セル幅は、実際にはDOCX形式の計算値です。 実際のセル幅は、多くのものに依存することができます。 たとえば、ページマージンまたは優先テーブル幅の変更は、実際のセル幅に影響を及ぼす可能性があります。
推奨セル幅は、ドキュメントに保存されているセルプロパティです。 セルの表または他のプロパティを変更すると、何も依存しません。
推奨幅を使用する方法
テーブルまたは個々のセルの所望の幅は、要素が合うように努力するサイズである、優先する幅プロパティを通じて定義されます。 つまり、テーブル全体または個々のセルに対して優先する幅を指定できます。 一部の状況では、この幅を正確に収まることはできませんが、実際の幅はほとんどの場合、この値に閉じられます。
適切な幅タイプと値は、メソッドを使用して設定されます。 PreferredWidth クラス:
- ・ Auto フィールドは、自動または「好ましい幅を指定しない」
- ・ FromPercent パーセンテージ幅を指定する方法
- ・ FromPoints ポイントの幅を指定する方法
下の写真は、* 優先幅設定機能*の表現を示しています Microsoft Word およびその対応するプロパティ Aspose.Wordsお問い合わせ
ドキュメント内の実際のテーブルにこれらのオプションが適用される例は、下図で見ることができます。
優先テーブルまたはセル幅を指定する
インスタグラム Aspose.Words, テーブルとセルの幅は、 Table.PreferredWidth プロパティとプロパティ CellFormat.PreferredWidth プロパティ、オプションあり PreferredWidthType 列挙:
-
-
- Auto, 好まれる幅セット無しに等しい
-
-
-
- Percent, ウィンドウまたはコンテナサイズの利用可能なスペースに相対的に要素に適合し、利用可能な幅が変化したときに値を再計算します。
-
-
-
- Points, ポイントの指定した幅の要素に対応する
-
使い方 Table.PreferredWidth プロパティは、ネストされたテーブルの場合、そのコンテナ:ページ、テキスト列、またはテーブルセルの相対的な優先幅を調整します。
次のコードの例では、テーブルをページの幅の50%にオートフィットするように設定する方法を示します。
使い方 CellFormat.PreferredWidth 特定のセル上のプロパティは、その優先幅を調整します。
次のコードの例では、異なる幅設定を設定する方法を示します。
好まれる幅のタイプおよび価値を見つけて下さい
使うことができます。 Type そして、 Value 目的のテーブルか細胞の好まれた幅の細部を見つける特性。
以下のコード例では、テーブルセルの優先幅タイプを取得する方法を示します。
オートフィットを設定する方法
ザ・オブ・ザ・ AllowAutoFit プロパティは、選択した基準に従ってセルを成長し、縮小することができます。 例えば、 窓へのオートフィット ページの幅にテーブルを合わせるオプション コンテンツへのオートフィット 各セルがコンテンツに応じて成長または縮小できるようにするオプション。
デフォルトでは、 Aspose.Words 新規テーブルをインサートする 窓へのオートフィットお問い合わせ 表は、利用可能なページ幅に応じてサイズされます。 テーブルのサイズを変更するには、 AutoFit メソッド。 このメソッドは、 AutoFitBehavior どのようなオートフィットがテーブルに適用されるかを指定する列挙。
autofitメソッドは、実際にテーブルに異なるプロパティを同時に適用するショートカットであることを知っていることが重要です。 これらは、実際にテーブルに観察された行動を与える特性です。 各オートフィットオプションについては、これらのプロパティについて説明します。
次のコードの例では、各セルを縮小または成長させるためのテーブルをその内容に応じて設定する方法を示します。
デモとして各種オートフィット設定を適用するには、次の表を使用します。
窓へのオートフィットテーブル
ウィンドウへのオートフィットがテーブルに適用されると、実際にシーンの後ろに次の操作が行われます。
1。 ザ・オブ・ザ・ Table.AllowAutoFit プロパティは、利用可能なコンテンツに合ったカラムを自動的にサイズ変更できるようにします。 Table.PreferredWidth 100%の価値 2。 CellFormat.PreferredWidth すべてのテーブルセルから削除されます
次のコードの例では、テーブルをページ幅にオートフィットする方法を示します。
上記のテーブルにこれらのオプションが下図で表示される例です。
コンテンツへのオートフィットテーブル
テーブルがコンテンツを自動入力すると、次の手順は実際に舞台裏で行われます。
1。 ザ・オブ・ザ・ Table.AllowAutoFit プロパティは、そのコンテンツに応じて各セルを自動的にサイズ変更できるようにします。
2。 好まれたテーブルの幅はから取除かれます Table.PreferredWidth, CellFormat.PreferredWidth 各テーブルセルが削除されます
3。 列の幅は、現在のテーブルのコンテンツに再計算されます。最後には、列の幅とテーブル全体の幅が自動的に再サイズされ、ユーザーがテキストを編集するにつれて、コンテンツを最も適したようにします。
次のコードの例では、テーブルをコンテンツにオートフィットする方法を示します。
上記のテーブルにこれらのオプションが下図で表示される例です。
表のAutoFitを無効にし、固定列幅を使用する
代わりにテーブルにオートフィット禁止と固定カラムの幅が使用される場合、次の手順を実行します。
1。 Table.AllowAutoFit プロパティは無効になっていますので、列はコンテンツに成長または縮小しません 2。 テーブル全体に優先する幅はから削除されます Table.PreferredWidth, CellFormat.PreferredWidth すべてのテーブルセルから削除されます 3。 最終結果は、列幅が決定されるテーブルです。 CellFormat.Width プロパティ、ユーザーがテキストを入力するか、ページがリサイズされると、その列が自動的にリサイズされない
次のコードの例では、オートフィットを無効にし、指定されたテーブルの固定幅を有効にする方法を示します。
上記のテーブルにこれらのオプションが下図で表示される例です。
セル幅の計算時の優先順位
Aspose.Words ユーザーは、複数のオブジェクトを介してテーブルまたはセルの幅を定義することができます。 CellFormat – その Width プロパティは以前のバージョンからほとんど残っていますが、セル幅の設定を簡素化するためにはまだ便利です。
知っておくことが重要です。 CellFormat.Width プロパティは、テーブルに既に存在する他の幅のプロパティのどれかに応じて異なります。
Aspose.Words セルの幅を計算するために次の順序を使用します。
| 注文する | プロパティ | コンテンツ |
|---|---|---|
| 1 | AllowAutoFit 決定される | お問い合わせ AutoFit 有効: - 表は、好みの幅を過去に成長して、コンテンツを収容することができます - それは通常、好ましい幅の下を縮小しません - あらゆる変更への CellFormat.Width 値が無視され、セルは代わりにそのコンテンツに収まる |
| 2 | PreferredWidthType 値を持つ Points または Percent | CellFormat.Width 無視される |
| 3 | PreferredWidthType 値を持つ Auto | 値から CellFormat.Width コピーして、セルの優先幅(ポイント)になります。 |
セル間の間隔を許可する
「セル間隔」オプションに似たテーブルセル間で追加のスペースを取得または設定できます。 Microsoft Wordお問い合わせ これは、 AllowCellSpacing プロパティ.
ドキュメント内の実際のテーブルにこれらのオプションが適用される例は、下図で見ることができます。
次のコードの例では、セル間の間隔を設定する方法を示します。
ボーダーとシェーディングを適用
ボーダーとシェーディングは、テーブル全体にテーブル全体に適用できます。 Table.SetBorder, Table.SetBorders そして、 Table.SetShading, または特定の細胞だけを使用して CellFormat.Borders そして、 CellFormat.Shadingお問い合わせ また、行の境界を設定できます。 RowFormat.Borders, しかし、この方法でシェーディングは適用できません。
下の写真は、境界と影の設定を示しています Microsoft Word およびその対応するプロパティ Aspose.Wordsお問い合わせ
次のコードの例では、異なる境界線とシェーディングでテーブルとセルをフォーマットする方法を示します。