Class BooleanCondition

BooleanCondition

เข้าถึงเงื่อนไขบูลีนใน ConditionalFormatRules ชิ้น กฎการจัดรูปแบบตามเงื่อนไขอาจมีเงื่อนไขเดียวที่เป็นบูลีน ตัวเงื่อนไขบูลีน มีเกณฑ์บูลีน (พร้อมค่า) และการตั้งค่าการจัดรูปแบบ เกณฑ์จะได้รับการประเมิน เทียบกับเนื้อหาของเซลล์ ซึ่งจะเป็นค่า true หรือ false หาก เกณฑ์ประเมินเป็น true ระบบจะนำการตั้งค่าการจัดรูปแบบของเงื่อนไขไปใช้กับเซลล์

เมธอด

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
getBackgroundObject()Colorรับสีพื้นหลังสำหรับเงื่อนไขบูลีนนี้
getBold()Booleanแสดงผล true หากเงื่อนไขบูลีนนี้ทำให้ข้อความเป็นตัวหนาและแสดงผล false หากเป็นเช่นนี้ เงื่อนไขบูลีนจะนำตัวหนาออกจากข้อความ
getCriteriaType()BooleanCriteriaรับประเภทเกณฑ์ของกฎตามที่ระบุไว้ใน enum ของ BooleanCriteria
getCriteriaValues()Object[]รับอาร์เรย์ของอาร์กิวเมนต์สำหรับเกณฑ์ของกฎ
getFontColorObject()Colorรับสีแบบอักษรสำหรับเงื่อนไขบูลีนนี้
getItalic()Booleanแสดงผล true หากเงื่อนไขบูลีนนี้ทำให้ข้อความเป็นตัวเอียง และแสดงผล false หาก เงื่อนไขแบบบูลีนนี้จะลบตัวเอียงออกจากข้อความ
getStrikethrough()Booleanแสดงผล true หากเงื่อนไขบูลีนนี้ขีดทับผ่านข้อความและแสดงผล false หากเงื่อนไขบูลีนนี้นำขีดทับออกจากข้อความ
getUnderline()Booleanแสดงผล true หากเงื่อนไขบูลีนนี้ขีดเส้นใต้ข้อความและแสดงผล false หาก เงื่อนไขแบบบูลีนนี้จะนําการขีดเส้นใต้ออกจากข้อความ

เอกสารโดยละเอียด

getBackgroundObject()

รับสีพื้นหลังสำหรับเงื่อนไขบูลีนนี้ แสดงผล null หากไม่ได้ตั้งค่าไว้

// Logs the boolean condition background color for each conditional format rule on a sheet.
var sheet = SpreadsheetApp.getActiveSheet();
var rules = sheet.getConditionalFormatRules();
for (int i = 0; i < rules.length; i++) {
  var color = rules[i].getBooleanCondition().getBackgroundObject();
  Logger.log("The background color for rule %s is %s", i, color.asRgbColor().asHexString());
}

รีเทิร์น

Color — สีพื้นหลัง หรือ null หากไม่ได้ตั้งค่าไว้สำหรับเงื่อนไขนี้


getBold()

แสดงผล true หากเงื่อนไขบูลีนนี้ทำให้ข้อความเป็นตัวหนาและแสดงผล false หากเป็นเช่นนี้ เงื่อนไขบูลีนจะนำตัวหนาออกจากข้อความ แสดงผล null หากการทำตัวหนาไม่ได้รับผลกระทบ

// Logs the boolean condition font weight for each conditional format rule on a sheet.
var sheet = SpreadsheetApp.getActiveSheet();
var rules = sheet.getConditionalFormatRules();
for (int i = 0; i < rules.length; i++) {
  var bold = rules[i].getBooleanCondition().getBold();
  Logger.log("The font bold setting for rule %s is %b", i, weight);
}

รีเทิร์น

Boolean — ระบุว่าเงื่อนไขบูลีนทำให้ข้อความเป็นตัวหนาหรือไม่ หรือ null หากการทำตัวหนาคือ ไม่ได้รับผลกระทบ


getCriteriaType()

รับประเภทเกณฑ์ของกฎตามที่ระบุไว้ใน enum ของ BooleanCriteria หากต้องการดาวน์โหลด อาร์กิวเมนต์สำหรับเกณฑ์ ให้ใช้ getCriteriaValues() หากต้องการใช้ค่าเหล่านี้เพื่อสร้างหรือ แก้ไขกฎการจัดรูปแบบตามเงื่อนไขได้ที่ ConditionalFormatRuleBuilder.withCriteria(criteria, args)

// Log information about the conditional formats on the active sheet that use
// boolean conditions.
var sheet = SpreadsheetApp.getActiveSheet;
var formats = sheet.getConditionalFormats();
sheet.getConditionalFormats().forEach(function(format) {
  var booleanCondition = format.getBooleanCondition();
  if (booleanCondition) {
    var criteria = booleanCondition.getCriteriaType();
    var args = booleanCondition.getCriteriaValues();
    Logger.log('The conditional format rule is %s %s', criteria, args);
  }
});

รีเทิร์น

BooleanCriteria — ประเภทของเกณฑ์การจัดรูปแบบตามเงื่อนไข


getCriteriaValues()

รับอาร์เรย์ของอาร์กิวเมนต์สำหรับเกณฑ์ของกฎ หากต้องการดูประเภทเกณฑ์ ให้ใช้ getCriteriaType() หากต้องการใช้ค่าเหล่านี้เพื่อสร้างหรือแก้ไขกฎการจัดรูปแบบตามเงื่อนไข โปรดดู ConditionalFormatRuleBuilder.withCriteria(criteria, args)

// Log information about the conditional formats on the active sheet that use
// boolean conditions.
var sheet = SpreadsheetApp.getActiveSheet;
var formats = sheet.getConditionalFormats();
sheet.getConditionalFormats().forEach(function(format) {
  var booleanCondition = format.getBooleanCondition();
  if (booleanCondition) {
    var criteria = booleanCondition.getCriteriaType();
    var args = booleanCondition.getCriteriaValues();
    Logger.log('The conditional format rule is %s %s', criteria, args);
  }
});

รีเทิร์น

Object[] — อาร์เรย์ของอาร์กิวเมนต์ที่เหมาะกับประเภทเกณฑ์ของกฎ จำนวนอาร์กิวเมนต์ และประเภทของพวกเขาตรงกับเมธอด when...() ที่สอดคล้องกันของคลาส ConditionalFormatRuleBuilder


getFontColorObject()

รับสีแบบอักษรสำหรับเงื่อนไขบูลีนนี้ แสดงผล null หากไม่ได้ตั้งค่าไว้

// Logs the boolean condition font color for each conditional format rule on a sheet.
var sheet = SpreadsheetApp.getActiveSheet();
var rules = sheet.getConditionalFormatRules();
for (int i = 0; i < rules.length; i++) {
  var color = rules[i].getBooleanCondition().getFontColorObject();
  Logger.log("The font color for rule %s is %s", i, color.asRgbColor().asHexString());
}

รีเทิร์น

Color — สีแบบอักษรหรือ null หากไม่ได้ตั้งค่าสำหรับเงื่อนไขนี้


getItalic()

แสดงผล true หากเงื่อนไขบูลีนนี้ทำให้ข้อความเป็นตัวเอียง และแสดงผล false หาก เงื่อนไขแบบบูลีนนี้จะลบตัวเอียงออกจากข้อความ แสดงค่า null หากตัวเอียงเท่ากับ จะไม่ได้รับผลกระทบ

// Logs the boolean condition font style for each conditional format rule on a sheet.
var sheet = SpreadsheetApp.getActiveSheet();
var rules = sheet.getConditionalFormatRules();
for (int i = 0; i < rules.length; i++) {
  var italic = rules[i].getBooleanCondition().getItalic();
  Logger.log("The font italic setting for rule %s is %b", i, italic);
}

รีเทิร์น

Boolean — ระบุว่าเงื่อนไขบูลีนทำให้ข้อความเป็นตัวเอียงหรือไม่ หรือ null หาก การทำตัวเอียงไม่ได้รับผลกระทบ


getStrikethrough()

แสดงผล true หากเงื่อนไขบูลีนนี้ขีดทับผ่านข้อความและแสดงผล false หากเงื่อนไขบูลีนนี้นำขีดทับออกจากข้อความ แสดงผล null หาก การขีดทับจะไม่ได้รับผลกระทบ

// Logs the boolean condition strikethrough setting for each conditional format rule on a
// sheet.
var sheet = SpreadsheetApp.getActiveSheet();
var rules = sheet.getConditionalFormatRules();
for (int i = 0; i < rules.length; i++) {
  var strikethrough = rules[i].getBooleanCondition().getStrikethrough();
  Logger.log("The font strikethrough setting for rule %s is %b", i, strikethrough);
}

รีเทิร์น

Boolean — ไม่ว่าเงื่อนไขบูลีนจะผ่านข้อความหรือไม่ หรือ null หาก ขีดกลางจะไม่ได้รับผลกระทบ


getUnderline()

แสดงผล true หากเงื่อนไขบูลีนนี้ขีดเส้นใต้ข้อความและแสดงผล false หาก เงื่อนไขแบบบูลีนนี้จะนําการขีดเส้นใต้ออกจากข้อความ แสดง null หากขีดเส้นใต้ จะไม่ได้รับผลกระทบ

// Logs the boolean condition underline setting for each conditional format rule on a sheet.
var sheet = SpreadsheetApp.getActiveSheet();
var rules = sheet.getConditionalFormatRules();
for (int i = 0; i < rules.length; i++) {
  var underline = rules[i].getBooleanCondition().getUnderline();
  Logger.log("The font underline setting for rule %s is %b", i, underline);
}

รีเทิร์น

Boolean — ระบุว่าเงื่อนไขบูลีนขีดเส้นใต้ข้อความหรือไม่ หรือ null หาก การขีดเส้นใต้จะไม่ได้รับผลกระทบ

วิธีการที่เลิกใช้งานแล้ว