หน้านี้ได้รับการแปลโดย Cloud Translation API

Class BooleanCondition

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

เมธอด

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

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

วิธีการ	ประเภทการแสดงผล	รายละเอียดแบบย่อ
`getBackground()`	`String`	รับสตริงสีพื้นหลังสําหรับเงื่อนไขบูลีนนี้
`getFontColor()`	`String`	รับสตริงสีแบบอักษรสําหรับเงื่อนไขบูลีนนี้

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

`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 หากไม่ได้ตั้งค่าสำหรับเงื่อนไขนี้

`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 หากการทําเป็นตัวหนาไม่ได้รับผลกระทบ

`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 หากไม่ได้ตั้งค่าสำหรับเงื่อนไขนี้

`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 หากการทำให้เป็นตัวเอียงไม่ได้รับผลกระทบ

`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 หากขีดทับไม่ได้รับผลกระทบ

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

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

`getBackground()`

เลิกใช้งานแล้ว แทนที่โดย 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().getBackground();
  Logger.log(`Background color: ${color}`);
}

รีเทิร์น

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

`getFontColor()`

เลิกใช้งานแล้ว แทนที่โดย 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) {
  Logger.log(`Font color: ${rule.getBooleanCondition().getFontColor()}`);
}

รีเทิร์น

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