Intelligent Media Management：FormatConditions

FormatConditions

Range.FormatConditions

擷取指定地區中的所有條件式格式設定。

• 文法

  運算式.Range.FormatConditions

  運算式：文件類型應用對象

• 樣本

  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()方法，您可以指定地區添加條件式格式設定。

• 文法

  運算式.Range.FormatConditions.Add({ Type, Operator, Formula1, Formula2 })

  運算式：文件類型應用對象

• 參數

  屬性	資料類型	是否必填	描述
  Type	Enum	是	指定條件式格式設定是基於儲存格值還是基於運算式。更多資訊，請參見XlFormatConditionType。
  Operator	Number	否	條件式格式設定運算子。更多資訊，請參見XlFormatConditionOperator。
  Formula1	Number	否	與條件式格式設定關聯的值或運算式。可為常量值、字串值、儲存格參照或公式。
  Formula2	Number	否	當參數Operator取值為xlBetween或xlNotBetween時，該參數表示與條件式格式設定第二部分相關聯的值或運算式，可以是常量值、字串值、儲存格參照或公式。 當參數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()方法，您可以編輯條件式格式設定。

• 文法

  運算式.Range.FormatConditions.With({ Interior, Font, Borders })

  運算式：文件類型應用對象

• 參數

  屬性	資料類型	是否必填	描述
  Interior	Object	否	內部屬性對象。
  Font	Object	否	字型對象。
  Borders	Object	否	邊框對象。

• 樣本

  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' },
    });
  }