名前付き範囲
名前付き範囲の作成
Microsoft Excel の使用
Microsoft Excel を使用してセルまたはセルの範囲に名前を付ける手順を以下に示します。この方法は、Microsoft Office Excel 2003、Microsoft Excel 97、2000、および2002 に適用されます。
- 名前を付けたいセル、セルの範囲を選択します。
- フォーミュラバーの左端にある名前ボックスをクリックします。
- セルに名前を入力します。
- ENTER キーを押します。
Aspose.Cellsの使用
ここでは、Aspose.Cells API を使用してタスクを実行します。
Aspose.Cells は、Microsoft Excel ファイルを表す Workbook クラスを提供します。 Workbook クラスには、Excel ファイル内の各ワークシートにアクセスできる WorksheetCollection を含みます。ワークシートは Worksheet クラスで表されます。 Worksheet クラスは Cells コレクションを提供します。
CellsコレクションのオーバーロードされたcreateRangeメソッドを呼び出すことで、範囲に名前を付けて作成できます。一般的なcreateRangeメソッドは次のパラメータを取ります:
- 左上のセルの名前、範囲内の左上のセルの名前。
- 右下のセルの名前、範囲内の右下のセルの名前。
createRangeが呼び出されると、新しく作成された範囲はRangeクラスのインスタンスとして返されます。
次の例は、B4:G14 のセルの名前付き範囲を作成する方法を示しています。
スプレッドシートのすべての名前付き範囲にアクセスする
WorksheetCollectionのgetNamedRangesメソッドを呼び出して、スプレッドシート内のすべての名前付き範囲を取得します。このメソッドは、すべての名前付き範囲の配列を返します。
次の例は、ワークブック内のすべての名前付き範囲にアクセスする方法を示しています。
特定の名前付き範囲にアクセスする
WorksheetCollectionコレクションのgetRangeByNameメソッドを呼び出すと、名前で指定された範囲を取得できます。一般的なgetRangeByNameメソッドは範囲名を引数に取り、指定された名前付き範囲をRangeクラスのインスタンスとして返します。
次の例は、名前で指定した範囲にアクセスする方法を示しています。
名前付き範囲内のセルを識別する
Aspose.Cells を使用すると、範囲内の個々のセルにデータを挿入することができます。 たとえば、セル A1:C4 の名前付き範囲があるとします。したがって、行列は 4 * 3 = 12 セルを作成し、個々の範囲セルは順番に配置されます。 Aspose.Cells は Range クラスのいくつかの便利なプロパティを提供し、範囲内の個々のセルにアクセスするためのメソッドを提供します。
- getFirstRow は、名前付き範囲内の最初の行のインデックスを返します。
- getFirstColumn は、名前付き範囲内の最初の列のインデックスを返します。
次の例では、指定された範囲のセルに値を入力する方法を示しています。
名前付き範囲内のセルにデータを入力する
Aspose.Cells を使用すると、範囲内の個々のセルにデータを挿入することができます。 たとえば、セル H1:J4 の名前付き範囲があるとします。したがって、行列は 4 * 3 = 12 セルを作成し、個々の範囲セルは順番に配置されます。 Aspose.Cells は Range クラスの有用なプロパティを提供し、範囲内の個々のセルにアクセスするためのメソッドを提供します。
- getFirstRow は、名前付き範囲内の最初の行のインデックスを返します。
- getFirstColumn は、名前付き範囲内の最初の列のインデックスを返します。
次の例では、指定された範囲のセルに値を入力する方法を示しています。
範囲の書式設定…背景色とフォント属性のネームド レンジへの設定
書式を適用するには、Style オブジェクトを定義してスタイル設定を指定し、Range オブジェクトに適用します。
次の例では、範囲に固体の塗りつぶし色(網掛け色)とフォント設定を設定する方法を示しています。
範囲の書式設定…ネームド レンジにボーダーを追加
セルの範囲に境界線を追加することも可能です。単一のセルだけでなく、RangeオブジェクトはsetOutlineBordersメソッドを提供し、次のパラメータで範囲の境界線を追加します:
- borderStyle: ボーダーの種類、CellBorderType 列挙型から選択します。
- borderColor: ボーダーの線の色、Color 列挙型から選択します。
次の例では、範囲にアウトラインボーダーを設定する方法を示しています。
上記のコードを実行した後の出力は、次のようになります:
指定されたRange のセルにスタイルを適用する
時には、Range内のセルにスタイルを適用したい場合があります。その場合、範囲内のセルを反復処理し、Cell.setStyleメソッドを使用してセルにスタイルを適用します。
次の例では、Range のセルにスタイルを適用する方法を示しています。
ネームド レンジの削除
Aspose.CellsはNameCollection.RemoveAt()メソッドを提供し、範囲の名前を削除します。範囲の内容をクリアするには、Cells.ClearRange()メソッドを使用します。 次の例では、ネームド レンジとその内容を削除する方法を示しています。
borderColors