ExcelScript.DataValidationErrorAlert interface

パッケージ:

ExcelScript

データ検証のエラー 警告プロパティを表します。

注釈

例

/**
 * This script creates a data validation rule for the range B1:B5.
 * All values in that range must be a positive number.
 * Attempts to enter other values are blocked and an error message appears.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the range B1:B5 in the active worksheet.
  const currentSheet = workbook.getActiveWorksheet();
  const positiveNumberOnlyCells = currentSheet.getRange("B1:B5");

  // Create a data validation rule to only allow positive numbers.
  const positiveNumberValidation: ExcelScript.BasicDataValidation = {
    formula1: "0",
    operator: ExcelScript.DataValidationOperator.greaterThan
  };
  const positiveNumberOnlyRule: ExcelScript.DataValidationRule = {
    wholeNumber: positiveNumberValidation
  };

  // Set the rule on the range.
  const rangeDataValidation = positiveNumberOnlyCells.getDataValidation();
  rangeDataValidation.setRule(positiveNumberOnlyRule);

  // Create an alert to appear when data other than positive numbers are entered.
  const positiveNumberOnlyAlert: ExcelScript.DataValidationErrorAlert = {
    message: "Positive numbers only",
    showAlert: true,
    style: ExcelScript.DataValidationAlertStyle.stop,
    title: "Invalid data"
  };
  rangeDataValidation.setErrorAlert(positiveNumberOnlyAlert);
}

プロパティ

message	エラー アラート メッセージを表します。
showAlert	ユーザーが無効なデータを入力したときにエラー アラート ダイアログを表示するかどうかを指定します。 既定値は true です。
style	データ検証アラートの種類については、「 ExcelScript.DataValidationAlertStyle 」を参照してください。
title	エラー アラート ダイアログのタイトルを表します。

プロパティの詳細

message

エラー アラート メッセージを表します。

message: string;

プロパティ値

string

showAlert

ユーザーが無効なデータを入力したときにエラー アラート ダイアログを表示するかどうかを指定します。 既定値は true です。

showAlert: boolean;

プロパティ値

boolean

style

データ検証アラートの種類については、「 ExcelScript.DataValidationAlertStyle 」を参照してください。

style: DataValidationAlertStyle;

プロパティ値

ExcelScript.DataValidationAlertStyle

title

エラー アラート ダイアログのタイトルを表します。

title: string;

プロパティ値

string