[]
        
(Showing Draft Content)

セルの配置とインデント

SpreadJS は、セル内のテキストを配置およびインデントするための柔軟なオプションを提供します。

配置とインデントは、API(hAlign、vAlign、textIndent などのメソッドを使用)を介してプログラムから設定するか、SpreadJSデザイナで視覚的に設定できます。

これらの機能により、セル内容の配置位置と表示方法を制御できます。

hAlign メソッドを使用して、水平方向の配置を指定できます。

image

水平方向の配置の種類

説明

標準

セル内容の種類に基づいて、テキストを自動的に配置します。

左詰め

内容をセルの左端に配置します。

中央揃え

内容をセル内で水平方向に中央に配置します。

右詰め

内容をセルの右端に配置します。

選択範囲内で中央

セルを結合せずに、選択範囲全体で内容を中央に配置します。

均等割り付け

セル幅にわたり、文字を均等に割り付けます。

両端揃え

左端と右端の両方に揃うように、テキスト行の間隔を調整します。

vAlign メソッドを使用して、垂直方向の配置を指定できます。

image

垂直方向の配置の種類

説明

上詰め

内容をセルの上端に配置します。

中央揃え

内容をセル内で垂直方向に中央に配置します。

下詰め

内容をセルの下端に配置します。

両端揃え

テキストがセルの高さに均等に収まるように、行間隔を調整します。

選択範囲内で中央の配置

SpreadJSは、セルを結合せずに、選択したセルのコンテンツを列全体の中央に配置するのに役立つ「選択範囲内で中央」の水平方向の配置を提供します。このタイプの水平方向の配置は、 Horizo​​ntalAlign.centerContinuous 列挙オプションを使用して設定できます。


次の表は、「選択範囲内で中央」の水平方向の配置を使用した場合の、SpreadJSの動作を示しています。

SpreadJSの動作

例

基本的な動作として、値が設定された各セルの右側にある連続する空のセルを探し、その範囲内でそれぞれの値を中央に配置します。


配置が設定された範囲に後で値が入力されると、基本動作に基づき中央揃え位置が更新されます。


選択は常に値が設定されているセルから始まります。したがって、範囲がセルの左から選択された場合でも、基本動作に基づき、値のあるセルから右側にある空白セルの範囲で中央に配置されます。


列のサイズが変更されると、中央揃え位置が調整されます。


次のコード例は、ワークシートに「選択範囲内で中央」の水平方向の配置を実装します。

activeSheet.getCell(1,1).value("選択範囲内で中央");
activeSheet.getRange(1, 1, 1, 5, GC.Spread.Sheets.SheetArea.viewport).hAlign(GC.Spread.Sheets.HorizontalAlign.centerContinuous);

「選択範囲内で中央」の水平方向の配置は、SpreadJSの他の機能と次のように相互作用します。

  • オーバーフロー - 「選択範囲内で中央」アライメントのコンテンツが選択した範囲の幅を超えると、両側へのオーバーフローがトリガーされます。

  • テキストを折り返す - 行の高さプロパティは、セルに「選択範囲内で中央」領域の境界内でテキストを折り返すように強制します。

  • 縮小して合わせる - オプションが選択されている場合、widthプロパティを使用して実際のフォントサイズが計算され、選択した範囲にコンテンツが収まります。

  • 会計番号の形式 - 「選択範囲内で中央」は、テキストを直接中央揃えにするのではなく、記号と値を横に伸ばします。

  • テキストインデント - 「選択範囲内で中央」は、インデントを0にロックします。

  • 方向 - 「選択範囲内で中央」は方向を0にロックします。

  • 結合されたセル - 結合されたセルは、選択スタイル全体で中央を使用できません。セルが結合されると、「選択範囲内で中央」は「中央」に置き換えられます。

水平方向配置の均等割り付け

SpreadJS では、均等割り付け(インデント)機能を使用して、セルの幅全体に文字列を均等に配置できます。均等割り付け(インデント)オプションは、中央揃えとテキストの折り返しを組み合わせた拡張機能です。

均等割り付け機能を使用することで、テキストのすべての行の各単語はセルの幅に合わせて均等に配置され、インデント値が適用される場合はセルの左側と右側の両方がパディングされます。

したがって、均等割り付けオプションの適用時にインデント値を設定すると、各行の両端が余白に揃います。このように水平方向の配置を設定するには、horizontalAlign.distributed 列挙体を使用します。

distributed-halign

style.hAlign = GC.Spread.Sheets.HorizontalAlign.distributed; 
activeSheet.setStyle(1, 1, style, GC.Spread.Sheets.SheetArea.viewport); 
activeSheet.getCell(1, 1).value("This is Distributed Alignment"); 

水平方向配置の「均等割り付」は、以下の方法で SpreadJS の他の機能と相互作用します:

  • 折り返して全体を表示する – 内容に「均等割り付」が指定された場合、文字列の折り返し機能が自動的に実装されるため、特に設定する必要がありません。

  • 縮小して全体を表示する - 均等割り付が指定された場合、このオプションが無効になります。

  • インデント - 均等割り付が指定された場合、セルの左側と右側の両方からインデントを設定します。

  • 最後の行を両端揃えする - 均等割り付が指定された場合、このオプションが無効になります。

  • 省略記号を表示 - 均等割り付が指定された場合、このオプションが無効になります。

両端揃えの配置

両端揃えの機能では、水平方向と垂直方向の両端揃え配置を使用でき、セルの幅および高さにわたってテキストをセルの両端に合わせて均等に割り付けます。

両端揃え配置を適用すると、テキストの折り返しが自動的に有効になり、単語間および行間の間隔が調整されます。これにより、手動の調整を最小限に抑えながら、整ったレイアウトのドキュメントを作成できます。

次の図と表では、レイアウト条件の違いに応じて、両端揃えが水平方向および垂直方向にどのように動作するかを示します。

image

文字の方向

動作の説明

例

水平方向

  • 最終行を除き、各行の先頭文字と末尾文字を左余白および右余白に揃えます。

  • 最終行または1 行のみのテキストは、既定で左詰めになります。

  • 利用可能なセル幅にわたってテキストを均等に割り付けるために、単語間隔が自動的に調整され、必要に応じて行間隔も調整されます。

  • ハイフネーションをサポートし、単語間の過剰な空きを抑える場合があります。

image

垂直方向

  • 先頭行を上余白に、最終行をセルの下余白に揃えます。

  • 1 行のみのテキストの場合、セルの上端に揃えます。

  • 複数行がある場合、テキスト行はセルの高さにわたって均等に割り付けられます。

image

使用手順

var style = new GC.Spread.Sheets.Style();
style.hAlign = GC.Spread.Sheets.HorizontalAlign.justify;
style.vAlign = GC.Spread.Sheets.VerticalAlign.justify;
activeSheet.setStyle(1, 1, style, GC.Spread.Sheets.SheetArea.viewport);
activeSheet.getCell(1, 1).value("Justified paragraph demonstration.");

次の表では、両端揃え配置が、自動テキストの折り返し、セル結合、テキストの方向などの他のレイアウト機能とどのように相互作用するかを説明します。

関連する機能

相互作用の詳細

自動テキストの折り返し

  • 両端揃え配置を適用すると、折り返して全体を表示するが自動的に有効になります。

  • 両端揃え配置が有効な間は、手動での「折り返して全体を表示する」の切り替えは無視されます。

結合セルとの互換性

両端揃え配置は、結合セルの合算された幅と高さに自動的に適応し、拡張された領域全体にわたるテキストの均等割り付けを維持します。

テキストの方向

  • テキストを任意の角度(< 0° または > 0°)に回転した場合、両端揃えは無視され、方向の設定が配置を決定します。–90° または 90° に回転した場合:

  • 回転テキストモードでは、両端揃えは回転方向に応じて、折り返しありの上詰め/下詰め、または左詰め/右詰めの配置に近い動作になります。

縮小して全体を表示する

  • セルに複数行が含まれる場合、縮小して全体を表示するは適用されません。

  • 両端揃え配置が有効な場合、内容に関係なく、縮小して全体を表示するを上書きして無効にします。

省略記号を表示する

両端揃え配置が有効な場合、「省略記号を表示する」オプションは無視されます。

リッチテキスト

  • 下線/取り消し線: 両端揃え時に、単語間で行が折り返される場合があります。

  • リスト: 両端揃え配置では、インデントが正しく表示されない場合があります。

  • 上付き文字/下付き文字: 両端揃え配置を適用すると、両方が比例してスケーリングされます。

インデント

水平方向の配置を両端揃えに設定した場合、インデントは無視されます。

次の図は、結合セル内および異なるテキストの方向において、両端揃え配置がどのように動作するかを示します。

image

image

次の図は、既定の上詰め(左詰め)配置と比較して、両端揃え配置が、下線、取り消し線、リスト、上付き文字/下付き文字などの異なる書式種類を含むリッチテキストにどのような影響を与えるかを示します。

image

SpreadJSデザイナの使用

セルの書式設定ウィンドウの配置タブにアクセスすることで、配置とインデントの機能を使用できます。「ホーム」タブ > 「配置」グループ > 右下の矢印ボタンをクリックして、「セルの書式設定」ウィンドウを開きます。

designer.gif