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 หากการขีดเส้นใต้ไม่มีผล

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