Fila y columna

API de Facade

Las definiciones completas del tipo de API de Facade se pueden encontrar en API de Facade.

Fila

Insertar fila después de la posición dada

insertRowAfter(afterPosition): inserta una fila después de la fila especificada posición.

TypeScript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()// This inserts a row after the first row positionsheet.insertRowAfter(0)

Insertar fila antes de la posición dada

insertRowBefore(beforePosition): inserta una fila antes de la posición de fila especificada.

TypeScript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()// This inserts a row before the first row positionsheet.insertRowBefore(0)

Inserta varias filas en la ubicación especificada

insertRows(rowIndex, numRows): inserta una o más filas en blanco consecutivas en una hoja comenzando en la ubicación especificada.

TypeScript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()// Shifts all rows down by threesheet.insertRows(0, 3)

Insertar varias filas después de la posición dada

insertRowsAfter(afterPosition, howMany): inserta un número específico de filas después de la posición de la fila dada.

TypeScript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()// This inserts five rows after the first rowsheet.insertRowsAfter(0, 5)

Inserta varias filas antes de la posición dada

insertRowsBefore(beforePosition, howMany): inserta un número específico de filas antes de la posición de fila dada.

TypeScript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()// This inserts five rows before the first rowsheet.insertRowsBefore(0, 5)

Eliminar fila en la posición dada

deleteRow(rowPosition): elimina la fila en la posición de fila especificada.

TypeScript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()// Rows start at "0" - this deletes the first rowsheet.deleteRow(0)

Elimina varias filas comenzando en la posición dada

deleteRows(rowPosition, howMany): elimina un número específico de filas comenzando en la posición de fila dada.

TypeScript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()// Rows start at "0" - this deletes the first two rowssheet.deleteRows(0, 2)

Eliminar varias filas por posiciones especificadas

deleteRowsByPoints(rowPoints): elimina varias filas (no necesariamente consecutivas) especificadas por una matriz de posiciones de fila.

TypeScript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()// Rows start at "0" - this deletes the 3rd row and rows 5 to 7fWorksheet.deleteRowsByPoints([2, [4, 6]])

Mover filas a una nueva posición

moveRows(rowSpec, destinationIndex): Mueve las filas seleccionadas por el rango dado a la posición indicada por destinationIndex. El rowSpec en sí no tiene que representar exactamente una fila completa o un grupo de filas para mover: selecciona todas las filas que abarca el rango.

TypeScript
// The code below moves rows 1-2 to destination index 5// This results in those rows becoming rows 3-4const sheet = univerAPI.getActiveWorkbook().getActiveSheet()// Selects row 1 and row 2 to be movedconst rowSpec = sheet.getRange('1:2')sheet.moveRows(rowSpec, 5)

Ocultar filas en un rango determinado

hideRow(row): Oculta las filas en el rango especificado.

TypeScript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()// This hides the first rowconst range = sheet.getRange('1:1')sheet.hideRow(range)

Ocultar varias filas consecutivas

hideRows(rowIndex, numRows): Oculta una o más filas consecutivas comenzando en el índice dado. Utilice el índice 0 para este método.

TypeScript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()// Hides the first three rowssheet.hideRows(0, 3)

Mostrar fila en un rango determinado

unhideRow(row): muestra la fila en el rango especificado.

TypeScript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()// This unhides the first row if it was previously hiddenconst range = sheet.getRange('1:1')sheet.unhideRow(range)

Mostrar varias filas consecutivas

showRows(rowIndex, numRows): muestra una o más filas consecutivas comenzando en el índice dado. Utilice el índice 0 para este método.

TypeScript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()// Unhides the first three rowssheet.showRows(0, 3)

Establecer altura de fila

setRowHeight(rowPosition, height): establece la altura de la fila dada en píxeles. De forma predeterminada, las filas crecen para ajustarse al contenido de las celdas. Si desea forzar las filas a una altura específica, use setRowHeightsForced(startRow, numRows, height).

TypeScript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()// Sets the first row to a height of 200 pixelssheet.setRowHeight(0, 200)

Establecer altura para varias filas

setRowHeights(startRow, numRows, height): establece la altura de las filas dadas en píxeles. De forma predeterminada, las filas crecen para ajustarse al contenido de las celdas. Si desea forzar las filas a una altura específica, use setRowHeightsForced(startRow, numRows, height).

TypeScript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()// Sets the first three rows to a height of 200 pixelssheet.setRowHeights(0, 3, 200)

Forzar ajuste de altura para varias filas

setRowHeightsForced(startRow, numRows, height): establece la altura de las filas dadas en píxeles. De forma predeterminada, las filas crecen para ajustarse al contenido de las celdas. Cuando usa setRowHeightsForced, las filas se fuerzan a la altura especificada incluso si el contenido de la celda es más alto que la altura de la fila.

TypeScript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()// Sets the first three rows to a height of 5 pixelssheet.setRowHeightsForced(0, 3, 5)

Cambio de tamaño de filas automático

autoResizeRows(startRow, numRows): cambia automáticamente el tamaño de la altura de las filas dadas para que se ajusten a su contenido de texto.

TypeScript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()// Set the first 3 rows to a height that fits their text.sheet.autoResizeRows(0, 3)

Establecer fila personalizada properties

setRowCustom(custom): establezca propiedades personalizadas para filas determinadas, almacene un objeto custom en la fila, en el que puede colocar cualquier dato que se ajuste al formato JSON, para el almacenamiento personalizado de información adicional. La actualización de los datos custom sobrescribirá los originales custom datos. Si necesita conservar los datos custom originales al actualizar los datos, obtenga los datos custom con anticipación y combínelos en datos nuevos antes de actualizar.

TypeScript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()// Set custom properties for the first and third rowssheet.setRowCustom({  0: { color: 'red' },  2: { size: 16 },})

Columna

Insertar columna después de la posición dada

insertColumnAfter(afterPosition): inserta una columna después de posición de columna dada.

TypeScript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()// This inserts a column after the first column positionsheet.insertColumnAfter(0)

Insertar columna antes de la posición dada

insertColumnBefore(beforePosition): inserta una columna antes de la posición de columna dada.

TypeScript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()// This inserts a column in the first column positionsheet.insertColumnBefore(0)

Inserta varias columnas en la ubicación especificada

insertColumns(columnIndex, numColumns): inserta uno o más espacios en blanco consecutivos columnas en una hoja comenzando en la ubicación especificada.

TypeScript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()// Shifts all columns by threesheet.insertColumns(0, 3)

Insertar varias columnas después de la posición dada

insertColumnsAfter(afterPosition, howMany): Inserta un número determinado de columnas después de la posición de la columna dada.

TypeScript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()// Inserts two columns after the first columnsheet.insertColumnsAfter(0, 2)

Inserta varias columnas antes de la posición dada

insertColumnsBefore(beforePosition, howMany): Inserta una cantidad de columnas antes de la posición de la columna dada.

TypeScript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()// This inserts five columns before the first columnsheet.insertColumnsBefore(0, 5)

Eliminar columna en la posición dada

deleteColumn(columnPosition): elimina la columna en la posición de la columna dada.

TypeScript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()// Columns start at "0" - this deletes the first columnsheet.deleteColumn(0)

Elimina varias columnas comenzando en la posición dada

deleteColumns(columnPosition, howMany): elimina una cantidad de columnas comenzando en la posición de la columna dada.

TypeScript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()// Columns start at "0" - this deletes the first two columnssheet.deleteColumns(0, 2)

Eliminar varias columnas por posiciones especificadas

deleteColumnsByPoints(columnPoints): elimina varias columnas (no necesariamente consecutivas) especificadas por una matriz de posiciones de columnas.

TypeScript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()// Columns start at "0" - this deletes the Column C and Columns E-GfWorksheet.deleteColumnsByPoints([2, [4, 6]])

Mover columnas a una nueva posición

moveColumns(columnSpec, destinationIndex): mueve las columnas seleccionadas por el rango dado a la posición indicada por el destinationIndex. El columnSpec en sí no tiene que representar exactamente una columna completa o un grupo de columnas para mover: selecciona todas las columnas que abarca el rango.

TypeScript
// The code below moves rows A-B to destination index 5.// This results in those columns becoming columns C-D.const sheet = univerAPI.getActiveWorkbook().getActiveSheet()// Selects column A and column B to be moved.const columnSpec = sheet.getRange('A:B')sheet.moveColumns(columnSpec, 5)

Ocultar columnas en un rango dado

hideColumn(column): oculta la columna o columnas en el rango dado.

TypeScript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()// This hides the first columnconst range = sheet.getRange('A:A')sheet.hideColumn(range)

Ocultar varias columnas consecutivas columnas

hideColumns(columnIndex, numColumns): Oculta una o más columnas consecutivas comenzando en el índice dado. Utilice el índice 0 para este método.

TypeScript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()// Hides the first three columnssheet.hideColumns(0, 3)

Mostrar columna en el rango dado

unhideColumn(column): muestra la columna en el rango dado.

TypeScript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()// This unhides the first column if it was previously hiddenconst range = sheet.getRange('A:A')sheet.unhideColumn(range)

Mostrar varias columnas consecutivas

showColumns(columnIndex, numColumns): muestra una o más columnas consecutivas comenzando en el índice dado. Utilice el índice 0 para este método.

TypeScript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()// Unhides the first three columnssheet.showColumns(0, 3)

Establecer ancho de columna

setColumnWidth(columnPosition, width): establece el ancho de la columna dada en píxeles.

TypeScript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()// Sets the first column to a width of 200 pixelssheet.setColumnWidth(0, 200)

Establece ancho para múltiples columnas

setColumnWidths(startColumn, numColumns, width): establece el ancho de la columna dada columnas en píxeles.

TypeScript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()// Sets the first three columns to a width of 200 pixelssheet.setColumnWidths(0, 3, 200)

Cambiar automáticamente el tamaño de las columnas

autoResizeColumns(startColumn, numColumns): establece el ancho de las columnas dadas para que se ajusten automáticamente a su contenido de texto.

TypeScript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()// Set the A:C columns to a width that fits their text.sheet.autoResizeColumns(0, 3)

Establece propiedades personalizadas de la columna

setColumnCustom(custom): establece propiedades personalizadas para las columnas determinadas, almacene un objeto custom en la columna, en el que puede colocar cualquier dato que se ajuste al formato JSON, para el almacenamiento personalizado de información adicional. La actualización de los datos custom sobrescribirá los datos custom originales. Si necesita conservar los datos custom originales al actualizar los datos, obtenga los datos custom con anticipación y combínelos en datos nuevos antes de actualizar.

TypeScript
const sheet = univerAPI.getActiveWorkbook().getActiveSheet()// Set custom properties for the first and third columnssheet.setColumnCustom({  0: { color: 'red' },  2: { size: 16 },})

¿Cómo es esta guía?

© 2026 DreamNum Co., Ltd.