Excel.JavaScriptCustomFunctionReferenceCellValue interface
Representa una referencia a una función personalizada de JavaScript.
Comentarios
Conjunto de API: ExcelApi 1.19
Ejemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/20-data-types/data-types-function-references.yaml
// Attach a reference to a JavaScript custom function as a method on a math entity.
await Excel.run(async (context) => {
const sheet: Excel.Worksheet = context.workbook.worksheets.getItem("Sample");
const entityRange: Excel.Range = sheet.getRange("A2");
const referenceType: Excel.FunctionCellValueType = Excel.FunctionCellValueType.javaScriptReference;
const customFunctionReference: Excel.JavaScriptCustomFunctionReferenceCellValue = {
type: Excel.CellValueType.function,
functionType: referenceType,
namespace: "CONTOSO",
id: "GET27"
};
// The namespace and ID identify a function; this value doesn't register its implementation.
const mathEntity: Excel.EntityCellValue = {
type: Excel.CellValueType.entity,
text: "Math value",
properties: {
Value: {
type: Excel.CellValueType.double,
basicValue: 10
},
Get27: customFunctionReference
}
};
entityRange.valuesAsJson = [[mathEntity]];
entityRange.format.autofitColumns();
await context.sync();
console.log("Created the Math value entity in Sample!A2. Read the reference to inspect its metadata.");
});
Propiedades
| basic |
Representa el valor devuelto por |
| basic |
Representa el valor devuelto por |
| function |
Representa el tipo de |
| id | Representa el identificador de la función personalizada. Para obtener más información, consulte Generación automática de metadatos JSON para funciones personalizadas: ID. |
| namespace | Representa el espacio de nombres usado por la función personalizada. Para obtener más información, consulte Referencia de manifiesto: espacio de nombres. |
| type | Representa el tipo de este valor de celda. |
Detalles de las propiedades
basicType
Representa el valor devuelto por Range.valueTypes para una celda con este valor.
basicType?: RangeValueType.error | "Error";
Valor de propiedad
error | "Error"
Comentarios
basicValue
Representa el valor devuelto por Range.values para una celda con este valor. Cuando se accede a través de una valuesAsJson propiedad, este valor de cadena se alinea con la configuración regional en-US. Cuando se accede a través de una valuesAsJsonLocal propiedad, este valor de cadena se alinea con la configuración regional de visualización del usuario.
basicValue?: "#VALUE!" | string;
Valor de propiedad
"#VALUE!" | string
Comentarios
functionType
Representa el tipo de FunctionCellValue.
functionType: FunctionCellValueType.javaScriptReference | "JavaScriptReference";
Valor de propiedad
javaScriptReference | "JavaScriptReference"
Comentarios
id
Representa el identificador de la función personalizada. Para obtener más información, consulte Generación automática de metadatos JSON para funciones personalizadas: ID.
id: string;
Valor de propiedad
string
Comentarios
namespace
Representa el espacio de nombres usado por la función personalizada. Para obtener más información, consulte Referencia de manifiesto: espacio de nombres.
namespace: string;
Valor de propiedad
string
Comentarios
type
Representa el tipo de este valor de celda.
type: CellValueType.function | "Function";
Valor de propiedad
function | "Function"