Excel.RangeFormat class

Colección de objetos de borde que se aplica al rango global seleccionado.

readonly borders: Excel.RangeBorderCollection;

Valor de propiedad

Comentarios

[ Conjunto de API: ExcelApi 1.1 ]

Especifica el ancho de todas las columnas del intervalo. Si los anchos de columna no son uniformes, null se devolverá.

columnWidth: number;

Valor de propiedad

Comentarios

[ Conjunto de API: ExcelApi 1.2 ]

Contexto de solicitud asociado al objeto . Esto conecta el proceso del complemento al proceso de la aplicación host de Office.

context: RequestContext;

Valor de propiedad

Devuelve el objeto de relleno definido en el intervalo global.

readonly fill: Excel.RangeFill;

Valor de propiedad

Comentarios

[ Conjunto de API: ExcelApi 1.1 ]

Devuelve el objeto de fuente definido en el rango global.

readonly font: Excel.RangeFont;

Valor de propiedad

Comentarios

[ Conjunto de API: ExcelApi 1.1 ]

Representa la alineación horizontal del objeto especificado. Vea Excel.HorizontalAlignment para más información.

horizontalAlignment: Excel.HorizontalAlignment | "General" | "Left" | "Center" | "Right" | "Fill" | "Justify" | "CenterAcrossSelection" | "Distributed";

Valor de propiedad

Comentarios

[ Conjunto de API: ExcelApi 1.1 ]

Devuelve el objeto de protección de formato de un rango.

readonly protection: Excel.FormatProtection;

Valor de propiedad

Comentarios

[ Conjunto de API: ExcelApi 1.2 ]

Alto de todas las filas del intervalo. Si los altos de fila no son uniformes, null se devolverá.

rowHeight: number;

Valor de propiedad

Comentarios

[ Conjunto de API: ExcelApi 1.2 ]

Representa la alineación vertical del objeto especificado. Vea Excel.VerticalAlignment para más información.

verticalAlignment: Excel.VerticalAlignment | "Top" | "Center" | "Bottom" | "Justify" | "Distributed";

Valor de propiedad

Comentarios

[ Conjunto de API: ExcelApi 1.1 ]

Especifica si Excel ajusta el texto del objeto. Un null valor indica que todo el intervalo no tiene una configuración de ajuste uniforme

wrapText: boolean;

Valor de propiedad

Comentarios

[ Conjunto de API: ExcelApi 1.1 ]

Cambia el ancho de las columnas del rango actual para obtener el ajuste perfecto (según los datos actuales de las columnas).

autofitColumns(): void;

Devoluciones

Comentarios

[ Conjunto de API: ExcelApi 1.2 ]

Cambia el alto de las filas del rango actual para obtener el ajuste perfecto (según los datos actuales de las columnas).

autofitRows(): void;

Devoluciones

Comentarios

[ Conjunto de API: ExcelApi 1.2 ]

Pone en cola un comando para cargar las propiedades especificadas del objeto. Debe llamar a context.sync() antes de leer las propiedades.

load(options?: Excel.Interfaces.RangeFormatLoadOptions): Excel.RangeFormat;

Parámetros

Devoluciones

Pone en cola un comando para cargar las propiedades especificadas del objeto. Debe llamar a context.sync() antes de leer las propiedades.

load(propertyNames?: string | string[]): Excel.RangeFormat;

Parámetros

Devoluciones

Ejemplos

// Select all of the range's format properties.
await Excel.run(async (context) => { 
    const sheetName = "Sheet1";
    const rangeAddress = "F:G";
    const worksheet = context.workbook.worksheets.getItem(sheetName);
    const range = worksheet.getRange(rangeAddress);
    range.load(["format/*", "format/fill", "format/borders", "format/font"]);
    await context.sync();
    
    console.log(range.format.wrapText);
    console.log(range.format.fill.color);
    console.log(range.format.font.name);
});

Pone en cola un comando para cargar las propiedades especificadas del objeto. Debe llamar a context.sync() antes de leer las propiedades.

load(propertyNamesAndPaths?: {
            select?: string;
            expand?: string;
        }): Excel.RangeFormat;

Parámetros

Devoluciones

Establece varias propiedades de un objeto al mismo tiempo. Puede pasar un objeto sin formato con las propiedades adecuadas u otro objeto de API del mismo tipo.

set(properties: Interfaces.RangeFormatUpdateData, options?: OfficeExtension.UpdateOptions): void;

Parámetros

Devoluciones

Establece varias propiedades en el objeto al mismo tiempo, en función de un objeto cargado existente.

set(properties: Excel.RangeFormat): void;

Parámetros

Devoluciones

Invalida el método JavaScript toJSON() para proporcionar una salida más útil cuando se pasa un objeto de API a JSON.stringify(). (JSON.stringifya su vez, llama al toJSON método del objeto que se le pasa). Mientras que el objeto original Excel.RangeFormat es un objeto de API, el toJSON método devuelve un objeto JavaScript sin formato (escrito como Excel.Interfaces.RangeFormatData) que contiene copias superficiales de las propiedades secundarias cargadas del objeto original.

toJSON(): Excel.Interfaces.RangeFormatData;

Devoluciones