配置設定
配置設定の構成
Microsoft Excelの配置設定
セルの書式設定にMicrosoft Excelを使用したことがある人であれば、Microsoft Excelの配置設定に精通しているでしょう。
上記の図から分かるように、異なる種類の配置オプションがあります:
- テキストの配置(水平および垂直)
- インデント
- 方向
- テキスト コントロール。
- テキスト方向。
これらの整列設定はすべてAspose.Cells for Python via .NETで完全にサポートされており、詳細は以下に記載されています。
Aspose.Cells for Python via .NETの整列設定
Aspose.Cells for Python via .NETは、Excelファイルを表すクラスWorkbookを提供します。Workbookクラスには、Excelファイル内の各ワークシートにアクセスするためのworksheetsコレクションが含まれています。ワークシートはWorksheetクラスで表されます。Worksheetクラスはcellsコレクションを提供します。cellsコレクションの各アイテムはCellクラスのオブジェクトを表します。
Aspose.Cells for Python via .NETは、セルの書式を取得・設定するためのget_styleとset_styleメソッドを提供します。Cellクラスは、整列設定を構成するための便利なプロパティを提供します。
TextAlignmentType 列挙型を使用して任意のテキスト配置タイプを選択します。TextAlignmentType 列挙型の事前定義されたテキスト配置タイプは次のとおりです:
テキスト配置タイプ | 説明 |
---|---|
GENERAL | 一般的なテキスト整列を表す |
BOTTOM | 下部のテキスト整列を表す |
CENTER | 中央のテキスト整列を表す |
CENTER_ACROSS | 横に中央揃えのテキスト整列を表す |
DISTRIBUTED | 分散されたテキスト整列を表す |
FILL | 塗りつぶしのテキスト整列を表す |
JUSTIFY | 両端揃えのテキスト整列を表す |
LEFT | 左寄せのテキスト配置を表す |
RIGHT | 右寄せのテキスト配置を表す |
TOP | 上寄せのテキスト配置を表す |
JUSTIFIED_LOW | アラビア語テキストのための調整されたカシダの長さでテキストを揃える |
THAI_DISTRIBUTED | タイ語を特別に分散させる、各文字が単語として扱われるため |
水平配置
Style オブジェクトのhorizontal_alignment プロパティを使用してテキストを水平に配置します。
垂直配置
水平配置と同様に、Style オブジェクトのvertical_alignment プロパティを使用してテキストを垂直に配置します。
インデント
セル内のテキストのインデントレベルをStyle オブジェクトのindent_level プロパティで設定することができます。
方向
セル内のテキストの方向(回転)をStyle オブジェクトのrotation_angle プロパティで設定します。
テキストコントロール
次のセクションでは、テキストの折り返し、収縮に合わせるなど、テキストの制御方法について説明します。
テキストの折り返し
セル内のテキストを折り返すと、テキストが切れたり隣接するセルに流れ出ないようになり、読みやすくなります。テキストの折り返しは、Styleのis_text_wrappedプロパティを使用してオンまたはオフに設定できます。
収縮に合わせる
フィールド内のテキストを折り返すオプションは、セルのサイズに合わせてテキストサイズを収縮することもできます。これは、Styleのis_text_wrappedプロパティをtrueに設定することで行います。
セルの結合
Microsoft Excelのように、Aspose.Cells for Python via .NETは複数のセルを一つに結合することをサポートしています。Aspose.Cells for Python via .NETはこのタスクに2つのアプローチを提供します。ひとつはcellsコレクションのmergeメソッドを呼び出す方法です。mergeメソッドは次のパラメータを取ってセルを結合します:
- 最初の行: 結合の開始行。
- 最初の列: 結合の開始列。
- 行数: 結合する行数。
- 列数: 結合する列数。
もう1つの方法は、まずcellsのcreate_rangeメソッドを呼び出して結合するセルの範囲を作成する方法です。create_rangeメソッドは、前述のmergeメソッドと同じパラメータを取り、Rangeオブジェクトを返します。Rangeオブジェクトには、Rangeオブジェクトで指定された範囲を結合するmergeメソッドも用意されています。
テキストの方向
セル内のテキストの読み取り順を設定することが可能です。読み取り順は、文字や単語などが表示される視覚的な順序です。たとえば、英語は左から右への言語であり、アラビア語は右から左への言語です。
読み取り順序は、Styleオブジェクトのtext_directionプロパティで設定されます。Aspose.Cells for Python via .NETは、TextDirectionType列挙型にあらかじめ定義されたテキスト方向タイプを提供します。
テキスト方向の種類 | 説明 |
---|---|
CONTEXT | 最初に入力された文字の言語と一致した読み取り順 |
LEFT_TO_RIGHT | 左から右の読み取り順 |
RIGHT_TO_LEFT | 右から左の読み取り順 |