Class BooleanCondition

BooleanCondition

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

เมธอด

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

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

getBackgroundObject()

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

// Logs the boolean condition background color for each conditional format rule
// on a sheet.
const sheet = SpreadsheetApp.getActiveSheet();
const rules = sheet.getConditionalFormatRules();
for (const rule of rules) {
  const color = rule.getBooleanCondition().getBackgroundObject();
  Logger.log(`Background color: ${color.asRgbColor().asHexString()}`);
}

รีเทิร์น

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


getBold()

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

// Logs the boolean condition font weight for each conditional format rule on a
// sheet.
const sheet = SpreadsheetApp.getActiveSheet();
const rules = sheet.getConditionalFormatRules();
for (const rule of rules) {
  const bold = rule.getBooleanCondition().getBold();
  Logger.log(`Bold: ${bold}`);
}

รีเทิร์น

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


getCriteriaType()

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

// Log information about the conditional formats on the active sheet that use
// boolean conditions.

const formats = SpreadsheetApp.getActiveSheet.getConditionalFormats();
SpreadsheetApp.getActiveSheet.getConditionalFormats().forEach((format) => {
  const booleanCondition = format.getBooleanCondition();
  if (booleanCondition) {
    const criteria = booleanCondition.getCriteriaType();
    const args = booleanCondition.getCriteriaValues();
    Logger.log(`The conditional format rule is ${criteria} ${args}`);
  }
});

รีเทิร์น

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


getCriteriaValues()

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

// Log information about the conditional formats on the active sheet that use
// boolean conditions.

const formats = SpreadsheetApp.getActiveSheet.getConditionalFormats();
SpreadsheetApp.getActiveSheet.getConditionalFormats().forEach((format) => {
  const booleanCondition = format.getBooleanCondition();
  if (booleanCondition) {
    const criteria = booleanCondition.getCriteriaType();
    const args = booleanCondition.getCriteriaValues();
    Logger.log(`The conditional format rule is ${criteria} ${args}`);
  }
});

รีเทิร์น

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


getFontColorObject()

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

// Logs the boolean condition font color for each conditional format rule on a
// sheet.
const sheet = SpreadsheetApp.getActiveSheet();
const rules = sheet.getConditionalFormatRules();
for (const rule of rules) {
  const color = rule.getBooleanCondition().getFontColorObject();
  Logger.log(`Font color: ${color.asRgbColor().asHexString()}`);
}

รีเทิร์น

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


getItalic()

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

// Logs the boolean condition font style for each conditional format rule on a
// sheet.
const sheet = SpreadsheetApp.getActiveSheet();
const rules = sheet.getConditionalFormatRules();
for (const rule of rules) {
  const italic = rule.getBooleanCondition().getItalic();
  Logger.log(`Italic: ${italic}`);
}

รีเทิร์น

Boolean|null — ไม่ว่าเงื่อนไขบูลีนจะทำให้ข้อความเป็นตัวเอียงหรือไม่ หรือ null if italicising is unaffected


getStrikethrough()

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

// Logs the boolean condition strikethrough setting for each conditional format
// rule on a sheet.
const sheet = SpreadsheetApp.getActiveSheet();
const rules = sheet.getConditionalFormatRules();
for (const rule of rules) {
  const strikethrough = rule.getBooleanCondition().getStrikethrough();
  Logger.log(`Strikethrough: ${strikethrough}`);
}

รีเทิร์น

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


getUnderline()

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

// Logs the boolean condition underline setting for each conditional format rule
// on a sheet.
const sheet = SpreadsheetApp.getActiveSheet();
const rules = sheet.getConditionalFormatRules();
for (const rule of rules) {
  const underline = rule.getBooleanCondition().getUnderline();
  Logger.log(`Underline: ${underline}`);
}

รีเทิร์น

Boolean|null — whether or not the boolean condition underlines the text, or null if underlining is unaffected

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