Configuración de bordes

Añadiendo Bordes a las Celdas

Microsoft Excel permite a los usuarios dar formato a las celdas agregando bordes. El tipo de borde depende de en qué posición se añada. Por ejemplo, un borde superior se añade en la posición superior de una celda. Los usuarios también pueden modificar el estilo de línea y el color de los bordes.

Con Script Aspose.Cells for JavaScript vía C++, los desarrolladores pueden agregar bordes y personalizar su apariencia de la misma manera flexible que en Microsoft Excel.

Añadiendo Bordes a las Celdas

Aspose.Cells proporciona una clase, Workbook que representa un archivo de Microsoft Excel. La clase Workbook contiene una colección worksheets que permite acceder a cada hoja de cálculo en el archivo de Excel. Una hoja de cálculo está representada por la clase Worksheet. La clase Worksheet proporciona la colección cells. Cada elemento en la colección cells representa un objeto de la clase Cell.

Aspose.Cells proporciona la propiedad style en la clase Cell. La style se usa para establecer el estilo de formato de una celda. La clase Style ofrece propiedades para agregar bordes a las celdas.

Añadir bordes a una celda

Los desarrolladores pueden agregar bordes a una celda usando la colección borders del objeto Style. El tipo de borde se pasa como índice a la colección borders. Todos los tipos de borde están predefinidos en la enumeración BorderType.

Enumeración de Bordes

Tipos de Bordes Descripción
BottomBorder Una línea de borde inferior
DiagonalDown Una línea diagonal de la esquina superior izquierda a la esquina inferior derecha
DiagonalUp Una línea diagonal de la esquina inferior izquierda a la esquina superior derecha
LeftBorder Una línea de borde izquierda
RightBorder Una línea de borde derecha
TopBorder Una línea de borde superior

La colección borders almacena todos los bordes. Cada borde en la colección borders está representado por un objeto Border que proporciona dos propiedades, color y lineStyle para establecer el color de línea del borde y su estilo respectivamente.

Para establecer el color de línea de un borde, selecciona un color usando la enumeración Color (parte de JavaScript) y asígnalo a la propiedad color del objeto Border.

El estilo de línea del borde se establece seleccionando un estilo de línea de la enumeración CellBorderType.

Enumeración de Tipo de Bordes de Celda

Estilos de Línea Descripción
DashDot Línea fina con guiones y puntos
DashDotDot Línea fina con guiones y puntos y puntos
Dashed Línea discontinua
Dotted Línea punteada
Double Línea doble
Hair Línea fina
MediumDashDot Línea medianamente punteada
MediumDashDotDot Línea mediana punto-punteada
MediumDashed Línea mediana punteada
None Sin línea
Medium Línea mediana
SlantedDashDot Línea oblicua medianamente punteada
Thick Línea gruesa
Thin Línea delgada
Seleccione uno de los estilos de línea y luego asignarlo a la propiedad lineStyle del objeto Border. 
<!DOCTYPE html>
<html>
    <head>
        <title>Aspose.Cells Example</title>
    </head>
    <body>
        <h1>Add Borders to A1 Cell Example</h1>
        <input type="file" id="fileInput" accept=".xls,.xlsx,.csv" />
        <button id="runExample">Run Example</button>
        <a id="downloadLink" style="display: none;">Download Result</a>
        <div id="result"></div>
    </body>

    <script src="aspose.cells.js.min.js"></script>
    <script type="text/javascript">
        const { Workbook, SaveFormat, Worksheet, Cell } = AsposeCells;

        AsposeCells.onReady({
            license: "/lic/aspose.cells.enc",
            fontPath: "/fonts/",
            fontList: [
                "arial.ttf",
                "NotoSansSC-Regular.ttf"
            ]
        }).then(() => {
            console.log("Aspose.Cells initialized");
        });

        document.getElementById('runExample').addEventListener('click', async () => {
            // This example creates a new workbook and adds borders to cell A1.
            // No try/catch is used so errors propagate for testing.

            // Instantiating a Workbook object
            const workbook = new Workbook();

            // Obtaining the reference of the first (default) worksheet by passing its sheet index
            const worksheet = workbook.worksheets.get(0);

            // Accessing the "A1" cell from the worksheet
            const cell = worksheet.cells.get("A1");

            // Adding some value to the "A1" cell
            cell.value = "Visit Aspose!";

            // Create a style object
            const style = cell.style;

            // Setting the line style and color of the top border
            style.borders.get(AsposeCells.BorderType.TopBorder).lineStyle = AsposeCells.CellBorderType.Thick;
            style.borders.get(AsposeCells.BorderType.TopBorder).color = AsposeCells.Color.Black;

            // Setting the line style and color of the bottom border
            style.borders.get(AsposeCells.BorderType.BottomBorder).lineStyle = AsposeCells.CellBorderType.Thick;
            style.borders.get(AsposeCells.BorderType.BottomBorder).color = AsposeCells.Color.Black;

            // Setting the line style and color of the left border
            style.borders.get(AsposeCells.BorderType.LeftBorder).lineStyle = AsposeCells.CellBorderType.Thick;
            style.borders.get(AsposeCells.BorderType.LeftBorder).color = AsposeCells.Color.Black;

            // Setting the line style and color of the right border
            style.borders.get(AsposeCells.BorderType.RightBorder).lineStyle = AsposeCells.CellBorderType.Thick;
            style.borders.get(AsposeCells.BorderType.RightBorder).color = AsposeCells.Color.Black;

            // Apply the border styles to the cell
            cell.style = style;

            // Saving the Excel file
            const outputData = workbook.save(SaveFormat.Excel97To2003);
            const blob = new Blob([outputData]);
            const downloadLink = document.getElementById('downloadLink');
            downloadLink.href = URL.createObjectURL(blob);
            downloadLink.download = 'book1.out.xls';
            downloadLink.style.display = 'block';
            downloadLink.textContent = 'Download Excel File';

            document.getElementById('result').innerHTML = '<p style="color: green;">Workbook created and styled successfully! Click the download link to get the file.</p>';
        });
    </script>
</html>

Agregar bordes a un rango de celdas

También es posible agregar bordes a un rango de celdas en lugar de solo a una celda. Para ello, primero cree un rango de celdas llamando al método createRange de la colección cells. Toma los siguientes parámetros:

  • Primera fila, la primera fila del rango.
  • Primera columna, representa la primera columna del rango.
  • Número de filas, el número de filas en el rango.
  • Número de columnas, el número de columnas en el rango.

El método createRange devuelve un objeto Range, que contiene el rango de celdas especificado. El objeto Range proporciona un método outlineBorder que toma los siguientes parámetros para agregar un borde al rango de celdas:

  • Tipo de borde, el tipo de borde, seleccionado de la enumeración BorderType.
  • Estilo de línea, el estilo de línea del borde, seleccionado de la enumeración CellBorderType.
  • Color, el color de línea, seleccionado de la enumeración Color.
<!DOCTYPE html>
<html>
    <head>
        <title>Aspose.Cells Example</title>
    </head>
    <body>
        <h1>Aspose.Cells Example - Create Workbook and Apply Borders</h1>
        <input type="file" id="fileInput" accept=".xls,.xlsx,.csv" />
        <button id="runExample">Run Example</button>
        <a id="downloadLink" style="display: none;">Download Result</a>
        <div id="result"></div>
    </body>

    <script src="aspose.cells.js.min.js"></script>
    <script type="text/javascript">
        const { Workbook, SaveFormat, BorderType, CellBorderType, Color } = AsposeCells;

        AsposeCells.onReady({
            license: "/lic/aspose.cells.enc",
            fontPath: "/fonts/",
            fontList: [
                "arial.ttf",
                "NotoSansSC-Regular.ttf"
            ]
        }).then(() => {
            console.log("Aspose.Cells initialized");
        });

        document.getElementById('runExample').addEventListener('click', async () => {
            // This example creates a new workbook, writes to A1, creates a range and applies borders, then offers the file for download.
            const workbook = new Workbook();

            const worksheet = workbook.worksheets.get(0);

            const cell = worksheet.cells.get("A1");

            cell.putValue("Hello World From Aspose");

            const range = worksheet.cells.createRange(0, 0, 1, 3);

            // Applying borders using property assignment conversions for setter methods
            range.outlineBorder = [BorderType.TopBorder, CellBorderType.Thick, Color.Blue];
            range.outlineBorder = [BorderType.BottomBorder, CellBorderType.Thick, Color.Blue];
            range.outlineBorder = [BorderType.LeftBorder, CellBorderType.Thick, Color.Blue];
            range.outlineBorder = [BorderType.RightBorder, CellBorderType.Thick, Color.Blue];

            const outputData = workbook.save(SaveFormat.Excel97To2003);
            const blob = new Blob([outputData]);
            const downloadLink = document.getElementById('downloadLink');
            downloadLink.href = URL.createObjectURL(blob);
            downloadLink.download = 'book1.out.xls';
            downloadLink.style.display = 'block';
            downloadLink.textContent = 'Download Modified Excel File';

            document.getElementById('result').innerHTML = '<p style="color: green;">Workbook created and borders applied successfully! Click the download link to get the file.</p>';
        });
    </script>
</html>
Configuración de fuente con JavaScript a través de C++ Configuración de relleno