Intelligent Media Management:範囲

範囲

1 つ以上の隣接するセルのブロックを含むセル、行、列、または範囲を取得します。

• 構文

  expression.Range

  expression: ドキュメントタイプのアプリケーションオブジェクト。

• 例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
    
    // 範囲オブジェクトを取得します。
    const range = await app.Range('A1');
  }

メソッド

Range.Item()

Item() メソッドを使用して、特定の範囲内のセルの位置を取得できます。

• 構文

  expression.Range.Item({ RowIndex, ColumnIndex })

  expression: ドキュメントタイプのアプリケーションオブジェクト。

• パラメーター

  プロパティ	データ型	必須	説明
  RowIndex	数値	はい	返すセルのサブ範囲のインデックスまたは相対行番号。 ColumnIndex パラメーターが指定されている場合、このパラメーターは返すセルの相対行番号を指定します。 ColumnIndex パラメーターが指定されていない場合、このパラメーターはサブ範囲のインデックスを指定します。
  ColumnIndex	数値	いいえ	返すセルの相対列番号。

• 例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
    
    // 範囲オブジェクトを取得します。
    const range = await app.Range('A1:D2');
  
    // 範囲内のセルの相対位置を取得します。この例では、B2 が使用されています。
    const item1 = await range.Item(2, 2);
    await item1.Select();
  }

Range.Activate()

Activate() メソッドを使用して、範囲をアクティブ化できます。

• 構文

  expression.Range.Activate()

  expression: ドキュメントタイプのアプリケーションオブジェクト。

• 例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
    
    // 範囲オブジェクトを取得します。
    const range = await app.Range('A1');
  
    // 範囲 A1 をアクティブ化します。
    range.Activate();
  }

Range.AddComment()

AddComment() メソッドを使用して、範囲にコメントを追加できます。

• 構文: expression.Range.AddComment({ Text })

  expression: ドキュメントタイプのアプリケーションオブジェクト。

• パラメーター

  プロパティ	データ型	必須	説明
  Text	文字列	いいえ	コメントのテキスト。

• 例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
    
    // 範囲オブジェクトを取得します。
    const range = await app.Range('A1');
  
    // 範囲 A1 にコメントを追加します。
    range.AddComment('Aliyun');
  }

Range.Address()

Address() メソッドを使用して、マクロ言語での範囲参照を示す文字列値を取得できます。

• 構文

  expression.Range.Address({ RowAbsolute, ColumnAbsolute, ReferenceStyle, External, RelativeTo })

  expression: ドキュメントタイプのアプリケーションオブジェクト。

• パラメーター

  プロパティ	データ型	必須	説明
  RowAbsolute	ブール値	いいえ	参照の行部分を絶対参照として返すかどうかを指定します。有効な値: true (デフォルト) false
  ColumnAbsolute	ブール値	いいえ	参照の列部分を絶対参照として返すかどうかを指定します。有効な値: true (デフォルト) false
  ReferenceStyle	列挙型	いいえ	参照スタイル。デフォルト値: xlA1。
  External	ブール値	いいえ	外部参照を返すか、ローカル参照を返すかを指定します。有効な値: false (デフォルト): ローカル参照を返します。 true: 外部参照を返します。
  RelativeTo	範囲	いいえ	開始点を定義する範囲オブジェクト。 RowAbsolute パラメーターと ColumnAbsolute パラメーターが false に設定され、ReferenceStyle パラメーターが xlR1C1 に設定されている場合、開始点を含める必要があります。

• 例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
    
    // 範囲オブジェクトを取得します。
    const range = await app.Range('A1');
  
    // マクロ言語での範囲参照を示す文字列値を取得します。
    const address1 = await range.Address();
    console.log('address1:', address1);
  
    const address2 = await range.Address(false, false);
    console.log('address2:', address2);
  
    const address3 = await range.Address(true, true, -4150);
    console.log('address3:', address3);
  }

Range.AutoFill()

AutoFill() メソッドを使用して、範囲内のセルにオートフィルを実行できます。

• 構文

  expression.Range.AutoFill({ Destination, Type })

  expression: ドキュメントタイプのアプリケーションオブジェクト。

• パラメーター

  プロパティ	データ型	必須	説明
  Destination	範囲	いいえ	セルを塗りつぶす範囲。宛先範囲には、ソース範囲を含める必要があります。
  Type	列挙型	いいえ	塗りつぶしの種類。デフォルト値: Enum.XlAutoFillType.xlFillDefault です。

• 例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
    
    // Rangeオブジェクトを取得します。
    const range = await app.Range('A1:A2');
  
    // 塗りつぶすセルを指定します。
    const fillRange = await app.Range('A1:A20');
  
    // 指定されたセルにオートフィルを実行します。
    await range.AutoFill(fillRange);
  }

Range.ClearComments()

ClearComments() メソッドを使用して、範囲からコメントをクリアできます。

• 構文

  expression.Range.ClearComments()

  expression: ドキュメント型のアプリケーション オブジェクト。

• 例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
    
    // Range オブジェクトを取得します。
    const range = await app.Range('A1:A2');
  
    // 範囲からコメントをクリアします。
    await range.ClearComments();
  }

Range.ClearContents()

ClearContents() メソッドを使用して、範囲からコンテンツをクリアできます。

• 構文

  expression.Range.ClearContents()

  expression: ドキュメント型のアプリケーション オブジェクト。

• 例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
    
    // Range オブジェクトを取得します。
    const range = await app.Range('A1:A2');
  
    // 範囲からコンテンツをクリアします。
    await range.ClearContents();
  }

Range.ClearComments()

2 つの Range オブジェクトが重複しているかどうかを Contain() メソッドを使用して確認できます。

• 構文

  expression.Range.Contain({ Range })

  式: ドキュメントタイプのアプリケーションオブジェクト。

• パラメータ

  プロパティ	データ型	必須	説明
  範囲	範囲	はい	もう一方の範囲オブジェクトです。

• 例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
    
    // 範囲オブジェクトを取得します。
    const range = await app.Range('A1:A2');
  
    // 範囲からコメントをクリアします。
    await range.ClearComments();
  }

Range.Merge()

Merge() メソッドを使用して、範囲内のセルをマージできます。

• 構文

  expression.Range.Merge({ Across })

  式: ドキュメントタイプのアプリケーションオブジェクト。

• パラメータ

  プロパティ	データ型	必須	説明
  Across	ブール値	はい	範囲の各行のセルを 1 つのセルにマージするかどうかを指定します。有効値： false (デフォルト) true

• 例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
    
    // 範囲オブジェクトを取得します。
    const range = await app.Range('A1:A2');
  
    // 範囲からコンテンツをクリアします。
    await range.ClearContents();
  }

Range.UnMerge()

UnMerge() メソッドを使用して、範囲内のセルを分割できます。

• 構文

  expression.Range.UnMerge({ CancelCenter })

  expression: ドキュメントタイプのアプリケーションオブジェクト。

• パラメーター

  プロパティ	データ型	必須	説明
  キャンセルセンター	ブール値	いいえ	マージされたセルを範囲の中央に配置するかどうかを指定します。有効値: false (デフォルト) true

• 例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
    
    // 範囲オブジェクトを取得します。
    const range = await app.Range('A1:D2');
  
    // もう一方の範囲オブジェクトを取得します。
    const newRange = await app.Range('A1:B4');
  
    // 2 つの範囲が重複するかどうかを確認します。
    const contain = await range.Contain(newRange);
    console.log(contain);
  }

Range.Offset()

Offset() メソッドを使用して、範囲の内容を移動できます。

• 構文

  expression.Range.Offset({ RowOffset, ColumnOffset })

  expression: ドキュメントタイプのアプリケーションオブジェクト。

• パラメーター

  プロパティ	データ型	必須	説明
  RowOffset	数値	いいえ	範囲の内容を移動する行数です。有効値: 正の整数: 範囲の内容を下に移動します。 負の整数: 範囲の内容を上に移動します。 0 (デフォルト): 範囲の内容を移動しません。
  列オフセット	番号	いいえ	範囲の内容を移動する列数です。有効値： 正の整数：範囲の内容を右方向に移動します。 負の整数：範囲の内容を左方向に移動します。 0 (デフォルト)：範囲の内容を移動しません。

• 例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
    
    // 範囲オブジェクトを取得します。
    const range = await app.Range('A1:D2');
  
    // セルをマージします。
    await range.Merge();
  }

Range.Select()

有効値内のアクティブなセルを Select() メソッドを使用して選択できます。

• 構文

  expression.Range.Select()

  expression: ドキュメントタイプのアプリケーションオブジェクト。

• パラメーター

  プロパティ	データ型	必須	説明
  ActiveCell	オブジェクト	いいえ	範囲内で選択されるアクティブ セル。フォーマット：{row: number, col: number}。 row：範囲内で選択されるアクティブ セルの行番号。 col：範囲内で選択されるアクティブ セルの列番号。 説明 行番号または列番号が範囲を超える場合、範囲の最初のセルが選択されます。
  Twinkle	ブール値	いいえ	点滅アニメーションを表示するかどうかを指定します。有効な値： false (デフォルト) true

• 例

  • 例 1:

    async function example() {
      await instance.ready();
    
      const app = instance.Application;
      
      // Range オブジェクトを取得します。
      const range = await app.Range('A1');
    
      // 範囲 A1 を選択します。
      range.Select();
    
      // 5,000 ミリ秒後に範囲 B1:D2 を選択します。
      setTimeout(async () => {
        const newRange = await app.Range('B1:D2');
        newRange.Select();
      }, 5000);
    }

  • 例 2

    async function example() {
      await instance.ready();
    
      const app = instance.Application;
      
      // Range オブジェクトを取得します。
      const range = await app.Range('A1');
    
      // 範囲 A1 を選択し、点滅アニメーションを表示します。
      range.Select(null, true);
    
      // 5,000 ミリ秒後に範囲 B1:D2 を選択し、B1:D2 の 2 列目と 2 行目のセルをアクティブセルとして選択します。
      setTimeout(async () => {
        const newRange = await app.Range('B1:D2');
        newRange.Select({row: 2, col: 2}, true);
      }, 5000);
    }

Range.ToImageDataURL()

ToImageDataURL() メソッドを使用して、範囲をイメージとしてエクスポートできます。

• 構文

  expression.Range.ToImageDataURL()

  expression: ドキュメント型のアプリケーション オブジェクト。

• 例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
    
    // Range オブジェクトを取得します。
    const range = await app.Range('A1:D2');
  
    // 範囲をイメージとしてエクスポートします。
    const img = await range.ToImageDataURL();
    console.log(img);
  }

Range.Insert()

1 つ以上の行、列、またはセルを Insert() メソッドを使用して範囲に追加できます。

• 構文

  expression.Range.Insert()

  expression: ドキュメント型のアプリケーション オブジェクト。

• 例

  • 1 つ以上の行を追加する

    async function example() {
      await instance.ready();
    
      const app = instance.Application;
      
      // Range オブジェクトを取得します。
      const range = await app.Range('B5:D10');
    
      // 範囲内のすべての行を選択し、範囲の上に 1 つ以上の行を追加します。
      await range.EntireRow.Insert();
    }

  • 1 つ以上の列を追加する

    async function example() {
      await instance.ready();
    
      const app = instance.Application;
      
      // Range オブジェクトを取得します。
      const range = await app.Range('B5:D10');
    
      // 範囲内のすべての列を選択し、範囲の左側に 1 つ以上の列を追加します。
      await range.EntireColumn.Insert();
    }

Range.PasteSpecial()

PasteSpecial() メソッドを使用して、コピーされた Range オブジェクトをコピー先の範囲に貼り付けることができます。

• 構文

  expression.Range.PasteSpecial()

  expression: ドキュメントタイプのアプリケーションオブジェクト。

• パラメーター

  プロパティ	データ型	必須	説明
  貼り付け	Enum.XlPasteType	いいえ	貼り付けの種類。詳細については、「XlPasteType」セクションの「表」トピックをご参照ください。
  操作	Enum.XlPasteSpecialOperation	いいえ	貼り付け操作です。
  SkipBlanks	ブール値	いいえ	クリップボード上のソース範囲にある空白のセルをコピー先の範囲に貼り付けるかどうかを指定します。有効値： false (デフォルト) true
  転置	ブール値	いいえ	貼り付け時にソース範囲の行と列を入れ替えるかどうかを指定します。有効値： false (デフォルト) true

• 例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
    
    // Range オブジェクトを取得します。
    const range = await app.Selection
  
    // Range オブジェクトをコピー先の範囲に貼り付けます。
    await range.PasteSpecial();
  }

Range.Find()

Find() メソッドを使用して、範囲内のデータを検索できます。このメソッドは、範囲関連のプロパティとメソッドを使用できる Range オブジェクトを返します。

• 構文

  expression.Range.Find({ What, After, LookIn, LookAt, SearchOrder, SearchDirection, MatchCase, MatchByte, SearchFormat })

  expression: ドキュメント型のアプリケーション オブジェクト。

• パラメーター

  プロパティ	データ型	必須	説明
  What	String	はい	検索対象のデータ。
  After	Range	いいえ	検索を開始するセル。このパラメーターを指定しない場合、検索は範囲の左上隅にあるセルの後から開始されます。
  LookIn	Enum	いいえ	検索のタイプ。デフォルト値: Enum.LookIn.etSmart。詳細については、「表」トピックのLookIn セクションをご参照ください。
  LookAt	Enum	いいえ	テキスト全体を一致させるか、テキストの一部を一致させるかを指定します。デフォルト値: Enum.LookAt.etPart。詳細については、「表」トピックのLookAt セクションをご参照ください。
  SearchOrder	Enum	いいえ	検索の順序。デフォルト値: Enum.SearchOrder.etByRows。詳細については、「表」トピックのSearchOrder セクションをご参照ください。
  SearchDirection	Enum	いいえ	検索の方向。デフォルト値: Enum.SearchDirection.etNext。詳細については、「表」トピックのSearchDirection セクションをご参照ください。
  MatchCase	Boolean	いいえ	大文字と小文字を区別するかどうかを指定します。有効値: false (デフォルト) true
  MatchByte	Boolean	いいえ	2 バイト文字が 2 バイト文字のみと一致するかどうかを指定します。有効値: true: 2 バイト文字は 2 バイト文字のみと一致します。 false (デフォルト): 2 バイト文字は、対応する 1 バイト文字と一致する可能性があります。
  SearchFormat	Object	いいえ	検索のフォーマット。

• 例

  //@file=base.xlsx
  async function example() {
    await instance.ready();
  
    const app = instance.Application;
  
    // すべてのセルを含むセル オブジェクト。
    const cells = await app.Cells;
    
    // セルを検索します。
    let range = await cells.Find('123');
  
    // 次のセルを検索します。
    range = await cells.Find('123', range);
  
    // 見つかったセルを選択します。
    await range.Select();
  }

範囲.FindAll()

指定した範囲内のすべての特定のデータを FindAll() メソッドを使用して検索できます。このメソッドは、一致するすべてのセルのアドレスを含む配列を返します。

• 構文

  expression.Range.FindAll({ What, LookIn, LookAt, SearchOrder, MatchCase, MatchByte, SearchRange })

  expression: ドキュメントタイプのアプリケーションオブジェクト。

• パラメーター

  プロパティ	データ型	必須	説明
  何	文字列	はい	検索対象のデータ。
  LookIn	Enum	いいえ	検索のタイプ。デフォルト値: Enum.LookIn.etSmart 。詳細については、「Table」トピックのLookIn セクションをご参照ください。
  LookAt	Enum	いいえ	テキスト全体とテキストの一部どちらを照合するかを指定します。デフォルト値: Enum.LookAt.etPart。詳細については、「Table」トピックのLookAt セクションをご参照ください。
  SearchOrder	Enum	いいえ	検索の順序。デフォルト値：Enum.SearchOrder.etByRows。詳細については、「Table」トピックのSearchOrder セクションをご参照ください。
  MatchCase	ブール値	いいえ	検索で大文字と小文字が区別されるかどうかを指定します。有効な値： false (デフォルト) true
  MatchByte	ブール値	いいえ	2 バイト文字が 2 バイト文字のみと一致するかどうかを指定します。有効な値： true：2 バイト文字は 2 バイト文字のみと一致します。 false（デフォルト）：2 バイト文字は、対応する 1 バイト文字と一致する可能性があります。
  検索範囲	列挙型	いいえ	検索範囲です。デフォルト値：Enum.FindScope.etSheet です。詳細については、「Table」トピックの FindScope セクションをご参照ください。

• 例

  //@file=base.xlsx
  async function example() {
    await instance.ready();
  
    const app = instance.Application;
  
    // すべてのセルを含むセルオブジェクト。
    const cells = await app.Cells;
    
    // セルを検索し、「123」を含むすべてのセルのアドレスを返します。
    let results = await cells.FindAll('123');
  
    // 見つかった最初のセル。
    const range = await app.Range(results[0]);
    
    // セルを選択します。
    await range.Select();
  }

Range.Copy()

Copy() メソッドを使用して、範囲の内容をクリップボードにコピーできます。

• 構文

  expression.Range.Copy()

  expression: ドキュメント型のアプリケーション オブジェクト。

• 例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
  
    // 範囲オブジェクトを取得します。
    const range = await app.Range('A1:D2');
  
    // 範囲の内容をクリップボードにコピーします。
    await range.Copy();
    // 範囲の内容がクリップボードにコピーされ、Ctrl + V を押すと貼り付けることができます。
  }

Range.RemoveDuplicates()

RemoveDuplicates() メソッドを使用して、範囲から重複する値を削除できます。

• 構文

  expression.Range.RemoveDuplicates({ Columns, Header })

  expression: ドキュメント型のアプリケーション オブジェクト。

• パラメータ

• 例

  async function example() {
      await instance.ready();
  
      const app = instance.Application;
  
      // Range オブジェクトを取得します。
      const range = await app.Range('A1:D2');
      
      // 重複する値を削除します。
      await range.RemoveDuplicates([1,2]);
  }

プロパティ

Range.Cells

Cells プロパティを使用して、範囲内のセルを取得できます。

• 構文

  expression.Range.Cells

  expression: ドキュメント型のアプリケーション オブジェクト。

• 例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
    
    // Range オブジェクトを取得します。
    const range = await app.Range('A1:B2');
  
    // すべてのセルを取得します。
    const cells = await range.Cells;
  
    // 最初のセルを取得します。
    const cell = await cells.Item(1);
    window.cells = cells;
  
    // セルを選択します。
    await cell.Select();
  }

Range.Column

Column プロパティを使用すると、範囲内の最初の列の番号を取得できます。

• 構文

  expression.Range.Column

  expression: ドキュメントタイプのアプリケーションオブジェクトです。

• 例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
    
    // Range オブジェクトを取得します。
    const range = await app.Range('A1:B2');
  
    // 範囲の最初の列の番号を取得します。
    const column = await range.Column;
    console.log(column);
  }

Range.ColumnEnd

ColumnEnd プロパティを使用すると、範囲内の最後の列番号を取得できます。

• 構文

  expression.Range.ColumnEnd

  expression: ドキュメント型のアプリケーション オブジェクト。

• 例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
    
    // Range オブジェクトを取得します。
    const range = await app.Range('A1:B2');
  
    // 範囲の最後の列の番号を取得します。
    const columnEnd = await range.ColumnEnd;
    console.log(columnEnd);
  }

Range.ColumnWidth

ColumnWidth プロパティを使用して、範囲の幅を指定できます。

• 構文

  expression.Range.ColumnWidth

  expression: ドキュメントタイプのアプリケーションオブジェクトです。

• 例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
    
    // Range オブジェクトを取得します。
    const range = await app.Range('A1:B2');
  
    // 範囲の幅を指定します。単位：ピクセル。
    range.ColumnWidth = 30;
  }

Range.Columns

[Columns] プロパティを使用して、範囲内の列を取得できます。

• 構文

  expression.Range.Columns

  expression: ドキュメント型のアプリケーション オブジェクト。

• 例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
    
    // Range オブジェクトを取得します。
    const range = await app.Range('A1:B2');
  
    // 範囲内のすべての列を取得します。
    const columns = await range.Columns;
  
    // 範囲内の 2 番目の列を取得します。
    const column = await columns.Item(2);
  
    // 列を選択します。
    await column.Select();
  }

Range.Count

範囲内のセルの数を取得するには、Count プロパティを使用します。

• 構文

  expression.Range.Count

  expression: ドキュメント型のアプリケーション オブジェクト。

• 例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
    
    // Range オブジェクトを取得します。
    const range = await app.Range('A1:B2');
  
    // 範囲内のセルの数を取得します。
    const count = await range.Count;
    console.log(count);
  }

Range.EntireColumn

EntireColumn プロパティを使用すると、範囲を含む列全体を取得できます。

• 構文

  expression.Range.EntireColumn

  expression: ドキュメント型のアプリケーション オブジェクト。

• 例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
    
    // Range オブジェクトを取得します。
    const range = await app.Range('A1');
  
    // 範囲を含む列全体を取得します。
    const entireColumn = range.EntireColumn;
  
    // 列を選択します。
    await entireColumn.Select();
  }

Range.EntireRow

EntireRow プロパティを使用すると、範囲を含む行全体を取得できます。

• 構文

  expression.Range.EntireRow

  expression: ドキュメント型のアプリケーション オブジェクト。

• 例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
    
    // Range オブジェクトを取得します。
    const range = await app.Range('A1');
  
    // 範囲を含む行全体を取得します。
    const entireRow = range.EntireRow;
  
    // 行を選択します。
    await entireRow.Select();
  }

Range.Formula

A1 表記で範囲内のオブジェクトの暗黙的に交差する数式を Formula プロパティを使用して表現できます。

• 構文

  expression.Range.Formula

  式: ドキュメント型のアプリケーション オブジェクト。

• 例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
    
    // Range オブジェクトを取得します。
    const range = await app.Range('A2');
  
    // 数式 A2=A1 + B1 を指定します。
    range.Formula = '=A1+B1';
  }

Range.FormulaArray

FormulaArray プロパティを使用して、範囲の配列数式を指定または取得できます。

• 構文

  expression.Range.FormulaArray

  expression: ドキュメント型のアプリケーション オブジェクト。

• 例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
    
    // Range オブジェクトを取得します。
    const range = await app.Range('A2:B2');
  
    // セル A2:B2 に数式 =Sum(A1:B1) を指定します。
    range.FormulaArray = '=Sum(A1:B1)';
    
    // 数式を取得します。
    const formulaArray = await range.FormulaArray;
    console.log(formulaArray);
  }

Range.Hidden

Hidden プロパティを使用して、範囲を含む行または列全体を非表示にするかどうかを指定できます。

• 構文

  expression.Range.Hidden = Boolean

  expression: ドキュメントタイプのアプリケーションオブジェクトです。

  Boolean に true を指定すると、行または列が非表示になります。false を指定すると、行または列が表示されます。

• 例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
    
    // Range オブジェクトを取得します。
    const range = await app.Range('A1');
  
    // 範囲を含む列全体を取得します。
    const entireColumn = range.EntireColumn;
  
    // 列を非表示にします。
    entireColumn.Hidden = true;
  }

Range.HorizontalAlignment

HorizontalAlignment プロパティを使用して、範囲の水平方向の配置を指定および取得できます。詳細については、「Table」Topic の XlHAlign セクションをご参照ください。

• 構文

  expression.Range.HorizontalAlignment

  expression: ドキュメントタイプのアプリケーションオブジェクトです。

• 例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
    
    // Range オブジェクトを取得します。
    const range = await app.Range('A1');
  
    // 中央揃えを指定します。
    range.HorizontalAlignment = await app.Enum.XlHAlign.xlHAlignCenter;
  
    setTimeout(async () => {
      // 3,000 ミリ秒後に配置を取得します。
      const horizontalAlignment = await range.HorizontalAlignment;
      console.log(horizontalAlignment);
    }, 3000);
  }

Range.Left

Left プロパティを使用すると、列 A の左端から範囲の左端までの距離を取得できます。

• 構文

  expression.Range.Left

  expression: ドキュメント型のアプリケーション オブジェクト。

• 例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
    
    // Range オブジェクトを取得します。
    const range = await app.Range('B2');
  
    // 中央揃えを指定します。
    range.HorizontalAlignment = await app.Enum.XlHAlign.xlHAlignCenter;
  
    // 列 A の左端から B2 の左端までの距離を取得します。
    const left = await range.Left;
    console.log(left);
  }

Range.MergeArea

MergeArea プロパティを使用して、セル結合範囲を取得できます。

• 構文

  expression.Range.MergeArea

  expression: ドキュメント型のアプリケーション オブジェクト。

• 例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
    
    // Range オブジェクトを取得します。
    const range = await app.Range('A1:D2');
  
    // セルを結合します。
    await range.Merge();
  
    setTimeout(async () => {
      // 5,000 ミリ秒後に結合されたセルの範囲を取得します。
      const mergeArea = await range.MergeArea;
      mergeArea.Select();
    }, 5000);
  }

Range.MergeCells

MergeCells プロパティを使用して、範囲に結合されたセルが含まれているかどうかを確認できます。

• 構文

  expression.Range.MergeCells

  式: ドキュメントタイプのアプリケーションオブジェクト。

• 例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
    
    // Range オブジェクトを取得します。
    const range = await app.Range('A1:D2');
  
    // セルをマージします。
    await range.Merge();
  
    // 範囲にマージされたセルが含まれているかどうかを確認します。
    const mergeCells = await range.MergeCells;
    console.log(mergeCells);
  }

Range.Row

Row プロパティを使用すると、範囲内の最初の行の番号を取得できます。

• 構文

  expression.Range.Row

  式: ドキュメント型のアプリケーション オブジェクト。

• 例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
    
    // Range オブジェクトを取得します。
    const range = await app.Range('A1:B2');
  
    // 範囲の最初の行の番号を取得します。
    const row = await range.Row;
    console.log(row);
  }

Range.RowEnd

範囲内の最後の行の番号を取得するには、RowEnd プロパティを使用します。

• 構文

  expression.Range.RowEnd

  expression: ドキュメント型のアプリケーション オブジェクト。

• 例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
    
    // Range オブジェクトを取得します。
    const range = await app.Range('A1:B2');
  
    // 範囲の最後の行の番号を取得します。
    const rowEnd = await range.RowEnd;
    console.log(rowEnd);
  }

Range.RowHeight

RowHeight プロパティを使用して、範囲の高さを指定できます。

• 構文

  expression.Range.RowHeight

  expression: ドキュメントタイプのアプリケーションオブジェクトです。

• 例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
    
    // Range オブジェクトを取得します。
    const range = await app.Range('A1:B2');
  
    // 範囲の高さを指定します。単位：ピクセル。
    range.RowHeight = 100;
  }

Range.Rows

Rows プロパティを使用して、範囲内の行を取得できます。

• 構文

  expression.Range.Rows

  expression: ドキュメント型のアプリケーション オブジェクト。

• 例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
    
    // Range オブジェクトを取得します。
    const range = await app.Range('A1:B2');
  
    // すべての行を取得します。
    const rows = await range.Rows;
  
    // 2 番目の行を取得します。
    const row = await rows.Item(2);
  
    // 行を選択します。
    await row.Select();
  }

Range.Text

Text プロパティを使用して、セルのフォーマット済みテキストを読み取ることができます。このプロパティは読み取り専用です。

• 構文

  expression.Range.Text

  式: ドキュメントタイプのアプリケーションオブジェクト。

• 例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
  
    // Range オブジェクトを取得します。
    const range = await app.Range('A1:B2');
  
    // セルのフォーマットされたテキストを読み取ります。
    const text = await range.Text;
    console.log(text);
  }

Range.Top

Top プロパティを使用すると、行 1 の上端から範囲の上端までの距離を取得できます。

• 構文

  expression.Range.Top

  expression: ドキュメント型のアプリケーション オブジェクト。

• 例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
  
    // Range オブジェクトを取得します。
    const range = await app.Range('B2');
  
    // 行 1 の上端から範囲の上端までの距離を取得します。
    const top = await range.Top;
    console.log(top);
  }

Range.VerticalAlignment

VerticalAlignment プロパティを使用して、範囲の垂直方向の配置を指定および取得できます。詳細については、「Table」Topic の XlVAlign セクションをご参照ください。

• 構文

  expression.Range.VerticalAlignment

  expression: ドキュメント型のアプリケーション オブジェクト。

• 例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
  
    // Range オブジェクトを取得します。
    const range = await app.Range('A1');
  
    // 範囲に下揃えを指定します。
    range.VerticalAlignment = await app.Enum.XlVAlign.xlVAlignBottom;
  
    setTimeout(async () => {
      // 3,000 ミリ秒後に配置を取得します。
      const horizontalAlignment = await range.VerticalAlignment;
      console.log(horizontalAlignment);
    }, 3000);
  }

Range.Value

Value プロパティを使用して、範囲内に値を書き込むことができます。

• 構文

  expression.Range.Value

  expression: ドキュメント型のアプリケーション オブジェクト。

• 例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
  
    // Range オブジェクトを取得します。
    const range = await app.Range('A1');
  
    // 範囲に値を書き込みます。
    range.Value = 'Aliyun';
  }

Range.IndentLevel

IndentLevel プロパティを使用して、範囲のインデントレベルを指定できます。

• 構文

  expression.Range.IndentLevel

  expression: ドキュメントタイプのアプリケーションオブジェクトです。

• 例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
  
    // Range オブジェクトを取得します。
    const range = await app.Range('A1');
  
    // 範囲のインデントレベルを 10 単位に設定します。
    range.IndentLevel = 10;
  }

Range.FormatConditions

範囲内のすべての条件付き書式の集合は、FormatConditions プロパティを使用して取得できます。

• 構文

  expression.Range.FormatConditions

  expression: ドキュメントタイプのアプリケーションオブジェクトです。

• 例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
    
    // Range オブジェクトを取得します。
    const range = await app.Range('A1');
  
    // 範囲内のすべての条件付き書式の コレクション を取得します。
    const formatConditions = await range.FormatConditions;
  }

Range.Validation

Validation プロパティを使用して、範囲のデータ入力規則を取得できます。

• 構文

  expression.Range.Validation

  expression: ドキュメント型のアプリケーション オブジェクト。

• 例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
  
    // Range オブジェクトを取得します。
    const range = await app.Range('A1');
  
    // 範囲のデータ入力規則を取得します。
    range.IndentLevel = 10;
  }

Range.Areas

Areas プロパティを使用して、選択したすべての範囲を取得できます。

• 構文

  expression.Range.Areas

  expression: ドキュメント型のアプリケーション オブジェクト。

• 例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
    
    // Range オブジェクトを取得します。
    const range = await app.Selection;
  
    // 選択されたすべての範囲を取得します。
    const areas = await range.Areas;
      
    // 選択された範囲の数。
    const count = await areas.Count;
    
    // 最初に選択された範囲。
    const area = await areas.Item(1)
  
    const address = await area.Address()
  }

Range.Hyperlinks

指定した範囲のハイパーリンク オブジェクトは、Hyperlinks プロパティを使用して取得できます。

• 構文

  expression.Range.Hyperlinks

  expression: ドキュメント型のアプリケーション オブジェクト。

• 例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
    
    // Range オブジェクトを取得します。
    const range = await app.Selection;
  
    // Hyperlink オブジェクトを取得します。
    const hyperlinks = await range.Hyperlinks;
    
    // 単一の Hyperlink オブジェクトを取得します。
    const hyperlink = await hyperlinks.Item(1)
  }

Range.Value2

Value2 プロパティを使用して、セルに値を書き込むことができます。

• 構文

  expression.Range.Value2

  式: ドキュメント型のアプリケーション オブジェクト。

• 例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
  
    // Range オブジェクトを取得します。
    const range = await app.Range('A1:B2');
  
    // セルに値を書き込みます。
    range.Value2 = [['WebOffice', 'WebOffice2'], ['1', '2']];
  }