Trabajando con Cells GridWeb
Accediendo a Cells en la Hoja de Trabajo
Este tema analiza las celdas y analiza la característica más básica de GridWeb: acceder a las celdas.
Cada hoja de trabajo contiene un objeto GridCells, una colección de objetos GridCell. Un objeto GridCell representa una celda en Aspose.Cells.GridWeb. Es posible acceder a cualquier celda utilizando GridWeb. Hay dos métodos preferidos:
A continuación se analiza cada enfoque.
Usando el nombre Cell
Todas las celdas tienen un nombre único. Por ejemplo, A1, A2, B1, B2, etc. Aspose.Cells.GridWeb permite a los desarrolladores acceder a cualquier celda deseada utilizando el nombre de la celda. Simplemente pase el nombre de la celda (como índice) a la colección GridCells de GridWorksheet.
Uso de índices de filas y columnas
Una celda también se puede reconocer por su ubicación en términos de índices de filas y columnas. Simplemente pase los índices de fila y columna de una celda a la colección GridCells de GridWorksheet. Este enfoque es más rápido que el anterior.
Accediendo y modificando el valor de un Cell
Accediendo a Cells en la Hoja de Trabajo discutido el acceso a las celdas. Este tema amplía esa discusión para mostrar cómo acceder y modificar valores de celda usando GridWeb API.
Acceder y modificar el valor de un Cell
Valores de cadena
Antes de acceder y modificar el valor de una celda, es necesario saber cómo acceder a las celdas. Para obtener detalles sobre los diferentes enfoques para acceder a las celdas, consulteAccediendo a Cells en la Hoja de Trabajo.
Cada celda tiene una propiedad llamada getStringValue(). Una vez que se accede a una celda, los desarrolladores pueden acceder al método getStringValue() para acceder al valor de la cadena de la celda.
Todo tipo de valores
Aspose.Cells.GridWeb también proporciona un método especial, putValue, para cada celda. Con este método es posible insertar o modificar cualquier tipo de valor (Booleano, int, doble, DateTime y string) en una celda.
También existe una versión sobrecargada del método putValue que puede tomar cualquier tipo de valor en formato de cadena y convertirlo automáticamente a un tipo de datos adecuado. Para que esto suceda, pase el valor booleano verdadero a otro parámetro del método putValue como se muestra a continuación en el ejemplo.
Agregar fórmulas al Cells
La característica más valiosa que ofrece Aspose.Cells.GridWeb es la compatibilidad con fórmulas o funciones. Aspose.Cells.GridWeb tiene su propio motor de fórmulas que calcula las fórmulas en las hojas de trabajo. Aspose.Cells.GridWeb admite funciones o fórmulas integradas y definidas por el usuario. Este tema analiza en detalle cómo agregar fórmulas a celdas usando Aspose.Cells.GridWeb API.
¿Cómo sumar y calcular una fórmula?
Es posible agregar, acceder y modificar fórmulas en celdas utilizando la propiedad Fórmula de una celda. Aspose.Cells.GridWeb admite fórmulas definidas por el usuario que van desde simples hasta complejas. Sin embargo, con Aspose.Cells.GridWeb también se proporciona una gran cantidad de funciones o fórmulas integradas (similares a Microsoft Excel). Para ver la lista completa de funciones integradas, consulte estelista de funciones admitidas.
La sintaxis de la fórmula debe ser compatible con la sintaxis de Excel Microsoft. Por ejemplo, todas las fórmulas deben comenzar con un signo igual (=).
Para agregar una fórmula mediante programación, Aspose.Cells.GridWeb la reconocerá como una fórmula incluso si no usa un signo =, pero si los usuarios finales que trabajan en la GUI deben usarlo.
Fórmula agregada a la celda B3 pero no calculada por GridWeb
En la captura de pantalla anterior, puede ver que se agregó una fórmula a B3 pero aún no se ha calculado. Para calcular todas las fórmulas, llame al método calcularFormula del control GridWeb GridWorksheetCollection después de agregar fórmulas a las hojas de cálculo, como se muestra a continuación.
Los usuarios también pueden calcular fórmulas haciendo clic en Enviar*.
Al hacer clic en el botón Enviar de GridWeb
IMPORTANTE: Si un usuario hace clic en Guardar oDeshacer botones o las pestañas de la hoja, GridWeb calcula todas las fórmulas automáticamente.
Resultado de la fórmula después del cálculo.
Referencia a Cells de otras hojas de trabajo
Usando Aspose.Cells.GridWeb, es posible hacer referencia a valores almacenados en diferentes hojas de trabajo en sus fórmulas, creando fórmulas complejas.
La sintaxis para hacer referencia a un valor de celda de una hoja de trabajo diferente es NombreHoja!NombreCelda.
Crear validación de datos en un GridCell de GridWeb
Aspose.Cells.GridWeb le permite agregarValidación de datos utilizando el método GridWorksheet.getValidations().add(). Al utilizar este método, debe especificar elCell Gama. Pero si desea crear una validación de datos en una sola GridCell, puede hacerlo directamente utilizando el método GridCell.createValidation(). De manera similar, puedes eliminar Validación de datos desde un GridCell usando el método GridCell.removeValidation().
El siguiente código de muestra crea unValidación de datos en una celda B3. Si ingresa cualquier valor que no esté entre 20 y 40, se mostrará la celda B3Error de validacion en forma derojo xxxx como se muestra en esta captura de pantalla.
Crear botones de comando personalizados
Aspose.Cells.GridWeb contiene botones especiales como Enviar, Guardar y Deshacer. Todos estos botones realizan tareas específicas para Aspose.Cells.GridWeb. También es posible agregar botones personalizados que realicen tareas personalizadas. Este tema explica cómo utilizar esta característica.
El siguiente código de muestra explica cómo crear un botón de comando personalizado y cómo manejar su evento de clic. Puede utilizar cualquier icono para su botón de comando personalizado. Con fines ilustrativos, utilizamos este icono de imagen.
Como puede ver en la siguiente captura de pantalla, cuando el usuario hace clic en el botón de comando personalizado, agrega un texto en la celda A1 que dice**“Se hizo clic en mi botón de comando personalizado”.**
Manejo de eventos del botón de comando personalizado
El siguiente código de muestra explica cómo realizar el manejo de eventos del botón de comando personalizado.
Formato de celdas para GridWeb
Posibles escenarios de uso
GridWeb ahora permite a los usuarios ingresar datos de celda en formato porcentual como 3% y los datos de la celda automáticamente tendrán el formato 3,00%. Sin embargo, tendrá que establecer el estilo de celda en Formato de porcentaje, que es GridTableItemStyle.NumberType 9 o 10. El número 9 tendrá el formato 3% como 3%, pero el número 10 tendrá el formato 3% como 3,00%.
Ingrese Cell datos de la hoja de trabajo GridWeb en formato de porcentaje
El siguiente código de muestra establece la celda A1 GridTableItemStyle.NumberType como 10, por lo tanto, los datos de entrada 3% se formatearán automáticamente como 3,00% como se muestra en la captura de pantalla.
