ExcelScript.ListDataValidation interface

Paket:

ExcelScript

Stellt die Kriterien für die Datenüberprüfung auflisten dar.

Hinweise

Beispiele

/**
 * This script creates a dropdown selection list for a cell.
 * It uses the existing values of the selected range as the choices for the list.
 */
function main(workbook: ExcelScript.Workbook) {
    // Get the values for data validation.
    const selectedRange = workbook.getSelectedRange();
    const rangeValues = selectedRange.getValues();

    // Convert the values into a comma-delimited string.
    let dataValidationListString = "";
    rangeValues.forEach((rangeValueRow) => {
        rangeValueRow.forEach((value) => {
            dataValidationListString += value + ",";
        });
    });

    // Clear the old range.
    selectedRange.clear(ExcelScript.ClearApplyTo.contents);

    // Apply the data validation to the first cell in the selected range.
    const targetCell = selectedRange.getCell(0, 0);
    const dataValidation = targetCell.getDataValidation();

    // Set the content of the dropdown list.
    let validationCriteria : ExcelScript.ListDataValidation = {
        inCellDropDown: true,
        source: dataValidationListString
    };
    let validationRule: ExcelScript.DataValidationRule = {
        list: validationCriteria
    };
    dataValidation.setRule(validationRule);
}

Eigenschaften

inCellDropDown	Gibt an, ob die Liste in einer Zellen-Dropdownliste angezeigt werden soll. Der Standardwert ist true.
source	Quelle der Liste für die Datenüberprüfung Beim Festlegen des Werts kann er als Range Objekt oder als Zeichenfolge übergeben werden, die eine durch Trennzeichen getrennte Zahl, einen booleschen Wert oder ein Datum enthält.

Details zur Eigenschaft

inCellDropDown

Gibt an, ob die Liste in einer Zellen-Dropdownliste angezeigt werden soll. Der Standardwert ist true.

inCellDropDown: boolean;

Eigenschaftswert

boolean

source

Quelle der Liste für die Datenüberprüfung Beim Festlegen des Werts kann er als Range Objekt oder als Zeichenfolge übergeben werden, die eine durch Trennzeichen getrennte Zahl, einen booleschen Wert oder ein Datum enthält.

source: string | Range;

Eigenschaftswert

string | ExcelScript.Range