Office.TableData class

Paquete:

office

Representa los datos de una tabla o office.TableBinding.

Constructores

(constructor)(rows, headers)	Construye una nueva instancia de la TableData clase
(constructor)()	Construye una nueva instancia de la TableData clase

Propiedades

headers	Obtiene o establece los encabezados de la tabla.
rows	Obtiene o establece las filas de la tabla. Devuelve una matriz de matrices que contiene los datos de la tabla. Devuelve una matriz vacía si no hay filas.

Detalles del constructor

(constructor)(rows, headers)

Construye una nueva instancia de la TableData clase

constructor(rows: any[][], headers: any[]);

Parámetros

rows

any[][]

headers

any[]

(constructor)()

Construye una nueva instancia de la TableData clase

constructor();

Detalles de las propiedades

headers

Obtiene o establece los encabezados de la tabla.

headers: any[];

Valor de propiedad

any[]

Comentarios

Para especificar encabezados, debe especificar una matriz de matrices que se corresponda con la estructura de la tabla. Por ejemplo, para especificar encabezados para una tabla de dos columnas, establecería la propiedad header en [['header1', 'header2']].

Si especifica null para la propiedad headers (o deja la propiedad vacía al construir un objeto TableData), los siguientes resultados se producen cuando se ejecuta el código.

• Si inserta una tabla nueva, se crearán los encabezados de columna predeterminados para la tabla.

• Si sobrescribe o actualiza una tabla existente, los encabezados existentes no se modificarán.

Ejemplos

// The following example creates a single-column table with a header and three rows.
function createTableData() {
    const tableData = new Office.TableData();
    tableData.headers = [['header1']];
    tableData.rows = [['row1'], ['row2'], ['row3']];
    return tableData;
}

rows

Obtiene o establece las filas de la tabla. Devuelve una matriz de matrices que contiene los datos de la tabla. Devuelve una matriz vacía si no hay filas.

rows: any[][];

Valor de propiedad

any[][]

Comentarios

Para especificar filas, debe especificar una matriz de matrices que se corresponda con la estructura de la tabla. Por ejemplo, para especificar dos filas de valores de cadena en una tabla de dos columnas, establecería la propiedad rows en [['a', 'b'], ['c', 'd']]].

Si especifica null para la propiedad rows (o deja la propiedad vacía al construir un objeto TableData), los siguientes resultados se producen cuando se ejecuta el código.

• Si inserta una nueva tabla, se insertará una fila en blanco.

• Si sobrescribe o actualiza una tabla existente, las filas existentes no se modificarán.

Ejemplos

// The following example creates a single-column table with a header and three rows.
function createTableData() {
    const tableData = new Office.TableData();
    tableData.headers = [['header1']];
    tableData.rows = [['row1'], ['row2'], ['row3']];
    return tableData;
}