Intelligent Media Management:Formatconditions

Formatconditions

Range.FormatConditions

指定された範囲内のすべての条件付き書式をクエリします。

• 構文

  expression.Range.FormatConditions

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

• 例

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

メソッド

Range.FormatConditions.Add()

Add() メソッドを使用して、指定された範囲に条件付き書式を追加します。

• 構文

  expression.Range.FormatConditions.Add({ Type, Operator, Formula1, Formula2 })

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

• パラメーター

  プロパティ	データ型	必須	説明
  Type	Enum	はい	条件付き書式がセルの値に基づくか、式に基づくかを指定します。詳細については、「XlFormatConditionType」をご参照ください。
  Operator	数値	いいえ	条件付き書式の演算子。詳細については、「XlFormatConditionOperator」をご参照ください。
  Formula1	数値	いいえ	条件付き書式に関連付けられた値または式。このパラメーターの値には、定数値、文字列値、セル参照、または数式を指定できます。
  Formula2	数値	いいえ	Operator パラメーターが xlBetween または xlNotBetween に設定されている場合、条件付き書式の2番目の部分に関連付けられた値または式。値には、定数値、文字列値、セル参照、または数式を指定できます。 Operator パラメーターの値が xlBetween または xlNotBetween でない場合、このパラメーターは無視されます。

• 例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
    
    // 範囲オブジェクトをクエリします。
    const range = await app.Range('A4:D5');
  
    // 範囲を選択します。
    await range.Select();
  
    // 数式を設定します。
    range.Formula = 'Aliyun';
  
    // すべての条件付き書式をクエリします。
    const formatConditions = await range.FormatConditions;
  
    // 条件付き書式を追加します。
    await formatConditions.Add(
      app.Enum.XlFormatConditionType.xlExpression,
      undefined,
      '=D1=1',
    );
  }

Range.FormatConditions.With()

With() メソッドを使用して、条件付き書式を変更します。

• 構文

  expression.Range.FormatConditions.With({ Interior, Font, Borders })

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

• パラメーター

  プロパティ	データ型	必須	説明
  Interior	オブジェクト	いいえ	内部プロパティオブジェクト。
  Font	オブジェクト	いいえ	フォントオブジェクト。
  Borders	オブジェクト	いいえ	罫線オブジェクト。

• 例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
    
    // 範囲オブジェクトをクエリします。
    const range = await app.Range('A4:D5');
  
    // 範囲を選択します。
    await range.Select();
  
    // 数式を設定します。
    range.Formula = 'Aliyun';
  
    // すべての条件付き書式をクエリします。
    const formatConditions = await range.FormatConditions;
  
    // 条件付き書式を追加します。
    await formatConditions.Add(
      app.Enum.XlFormatConditionType.xlExpression,
      undefined,
      '=D1=1',
    );
  
    // 条件付き書式を編集します。
    await formatConditionsAdd.With({
      Interior: { Color: '#000000' },
      Font: { Bold: true, Color: '#FF0000', Underline: 2, Italic: true, Strikethrough: true },
      Border: { LineStyle: -4119, Color: '#FF0000' },
    });
  }