Excel.BasicDataValidation interface

基本的な型データの入力規則を表します。

注釈

API セット: ExcelApi 1.8

使用元

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/22-data-validation/data-validation-types.yaml

function applyDecimal(sheet: Excel.Worksheet) {
    // Decimal values between 0 and 10 are allowed.
    const basicRule: Excel.BasicDataValidation = {
        formula1: 0,
        formula2: 10,
        operator: Excel.DataValidationOperator.between
    };
    const rule: Excel.DataValidationRule = { decimal: basicRule };
    sheet.getRange("B3").dataValidation.rule = rule;
}

プロパティ

formula1

演算子プロパティが GreaterThan などの二項演算子に設定されている場合は、右オペランドを指定します (左側のオペランドは、ユーザーがセルに入力しようとする値です)。 三項演算子 Between および NotBetween を使用して、下限オペランドを指定します。 たとえば、formula1 を 10 に設定し、演算子を GreaterThan に設定すると、範囲の有効なデータは 10 より大きくなければならないことを意味します。 値を設定するときは、数値、範囲オブジェクト、または文字列数式として渡すことができます (ここで、文字列は文字列化された数値、"=A1" のようなセル参照、または "=MIN(A1, B1)" のような数式のいずれかです)。 値を取得するときは、常に文字列数式として返されます。たとえば、"=10"、"=A1"、"=SUM(A1:B5)" などです。

formula2

三項演算子 Between および NotBetween を使用して、上限オペランドを指定します。 GreaterThan などの二項演算子と共には使用されません。 値を設定するときは、数値、範囲オブジェクト、または文字列数式として渡すことができます (ここで、文字列は文字列化された数値、"=A1" のようなセル参照、または "=MIN(A1, B1)" のような数式のいずれかです)。 値を取得するときは、常に文字列数式として返されます。たとえば、"=10"、"=A1"、"=SUM(A1:B5)" などです。

operator

データの検証に使用する演算子。

プロパティの詳細

formula1

演算子プロパティが GreaterThan などの二項演算子に設定されている場合は、右オペランドを指定します (左側のオペランドは、ユーザーがセルに入力しようとする値です)。 三項演算子 Between および NotBetween を使用して、下限オペランドを指定します。 たとえば、formula1 を 10 に設定し、演算子を GreaterThan に設定すると、範囲の有効なデータは 10 より大きくなければならないことを意味します。 値を設定するときは、数値、範囲オブジェクト、または文字列数式として渡すことができます (ここで、文字列は文字列化された数値、"=A1" のようなセル参照、または "=MIN(A1, B1)" のような数式のいずれかです)。 値を取得するときは、常に文字列数式として返されます。たとえば、"=10"、"=A1"、"=SUM(A1:B5)" などです。

formula1: string | number | Range;

プロパティ値

string | number | Excel.Range

注釈

API セット: ExcelApi 1.8

formula2

三項演算子 Between および NotBetween を使用して、上限オペランドを指定します。 GreaterThan などの二項演算子と共には使用されません。 値を設定するときは、数値、範囲オブジェクト、または文字列数式として渡すことができます (ここで、文字列は文字列化された数値、"=A1" のようなセル参照、または "=MIN(A1, B1)" のような数式のいずれかです)。 値を取得するときは、常に文字列数式として返されます。たとえば、"=10"、"=A1"、"=SUM(A1:B5)" などです。

formula2?: string | number | Range;

プロパティ値

string | number | Excel.Range

注釈

API セット: ExcelApi 1.8

operator

データの検証に使用する演算子。

operator: Excel.DataValidationOperator | "Between" | "NotBetween" | "EqualTo" | "NotEqualTo" | "GreaterThan" | "LessThan" | "GreaterThanOrEqualTo" | "LessThanOrEqualTo";

プロパティ値

Excel.DataValidationOperator | "Between" | "NotBetween" | "EqualTo" | "NotEqualTo" | "GreaterThan" | "LessThan" | "GreaterThanOrEqualTo" | "LessThanOrEqualTo"

注釈

API セット: ExcelApi 1.8