配置設定
配置設定の構成
Microsoft Excelの配置設定
セルの書式設定にMicrosoft Excelを使用したことがある人であれば、Microsoft Excelの配置設定に精通しているでしょう。
上記の図から分かるように、異なる種類の配置オプションがあります:
- テキストの配置(水平および垂直)
- インデント
- 方向
- テキスト コントロール。
- テキスト方向。
これらの配置設定は、Aspose.Cellsで完全にサポートされており、以下で詳しく説明します。
Aspose.Cellsの配置設定
Aspose.Cellsは、Excelファイルを表すクラスWorkbookを提供します。Workbookクラスには、Excelファイル内の各ワークシートにアクセスできるWorksheets コレクションが含まれています。ワークシートはWorksheet クラスで表されます。Worksheet クラスはCells コレクションを提供します。Cells コレクション内の各アイテムはCell クラスのオブジェクトを表します。
Aspose.Cellsは、GetStyle およびSetStyle メソッドを提供しています。これらはCell クラスで使用され、セルの書式設定を取得および設定します。Style クラスには、配置設定を構成するための便利なプロパティが提供されています。
TextAlignmentType 列挙型を使用して任意のテキスト配置タイプを選択します。TextAlignmentType 列挙型の事前定義されたテキスト配置タイプは次のとおりです:
テキスト配置タイプ | 説明 |
---|---|
Bottom | 下部のテキスト配置を表します。 |
Center | 中央のテキスト配置を表します。 |
CenterAcross | 横方向に中央揃えのテキスト配置を表します。 |
Distributed | 分散テキスト配置を表します。 |
Fill | 塗りつぶしのテキスト配置を表します。 |
General | 一般的なテキスト配置を表します。 |
Justify | 両端揃えのテキスト配置を表します。 |
Left | 左揃えのテキスト配置を表します。 |
Right | 右揃えのテキスト配置を表します。 |
Top | 上部のテキスト配置を表します。 |
JustifiedLow | アラビア語のテキストに対して調整されたカシダ長でテキストを配置します。 |
ThaiDistributed | 特にタイ語のテキストを分散配置し、各文字を単語として扱います。 |
水平配置
Style オブジェクトのHorizontalAlignment プロパティを使用してテキストを水平に配置します。
垂直配置
水平配置と同様に、Style オブジェクトのVerticalAlignment プロパティを使用してテキストを垂直に配置します。
インデント
セル内のテキストのインデントレベルをStyle オブジェクトのIndentLevel プロパティで設定することができます。
方向
セル内のテキストの方向(回転)をStyle オブジェクトのRotationAngle プロパティで設定します。
テキストコントロール
次のセクションでは、テキストの折り返し、収縮に合わせるなど、テキストの制御方法について説明します。
テキストの折り返し
セル内のテキストを折り返すと、テキストが切れたり隣接するセルに流れ出ないようになり、読みやすくなります。テキストの折り返しは、StyleのIsTextWrappedプロパティを使用してオンまたはオフに設定できます。
収縮に合わせる
フィールド内のテキストを折り返すオプションは、セルのサイズに合わせてテキストサイズを収縮することもできます。これは、StyleのIsTextWrappedプロパティをtrueに設定することで行います。
セルの結合
Aspose.Cellsは、Microsoft Excelのように複数のセルを1つに結合する機能をサポートしています。Aspose.Cellsには、このタスクを行うための2つの方法が提供されています。1つ目は、CellsのMergeメソッドを呼び出す方法です。Mergeメソッドは、次のパラメータを取り、セルを結合します:
- 最初の行: 結合の開始行。
- 最初の列: 結合の開始列。
- 行数: 結合する行数。
- 列数: 結合する列数。
もう1つの方法は、まずCellsのCreateRangeメソッドを呼び出して結合するセルの範囲を作成する方法です。CreateRangeメソッドは、前述のMergeメソッドと同じパラメータを取り、Rangeオブジェクトを返します。Rangeオブジェクトには、Rangeオブジェクトで指定された範囲を結合するMergeメソッドも用意されています。
テキストの方向
セル内のテキストの読み取り順を設定することが可能です。読み取り順は、文字や単語などが表示される視覚的な順序です。たとえば、英語は左から右への言語であり、アラビア語は右から左への言語です。
読み取り順は、StyleのTextDirectionプロパティを使用して設定されます。Aspose.Cellsは、TextDirectionType列挙型で事前定義されたテキストの方向タイプを提供しています。
テキスト方向の種類 | 説明 |
---|---|
Context | 最初に入力された文字の言語と一貫した読み取り順 |
LeftToRight | 左から右の読み取り順 |
RightToLeft | 右から左の読み取り順 |