Rangos Nombrados
Creando un Rango Nombrado
Usar Microsoft Excel
Los siguientes pasos describen cómo nombrar una celda o rango de celdas utilizando Microsoft Excel. Este método se aplica a Microsoft Office Excel 2003, Microsoft Excel 97, 2000 y 2002.
- Selecciona la celda o rango de celdas que deseas nombrar.
- Haz clic en el Cuadro de Nombre al final izquierdo de la barra de fórmulas.
- Escribe el nombre para las celdas.
- Presiona ENTER.
Usar Aspose.Cells
Aquí, usamos la API de Aspose.Cells para realizar la tarea.
Aspose.Cells proporciona una clase, Workbook, que representa un archivo de Microsoft Excel. La clase Workbook contiene una WorksheetCollection que permite acceder a cada hoja de cálculo en un archivo de Excel. Una hoja de cálculo está representada por la clase Worksheet. La clase Worksheet proporciona una colección Cells.
Es posible crear un rango nombrado llamando al método sobrecargado createRange de la colección Cells. Una versión típica del método createRange toma los siguientes parámetros:
- Nombre de la celda superior izquierda, el nombre de la celda superior izquierda en el rango.
- Nombre de la celda inferior derecha, el nombre de la celda inferior derecha en el rango.
Cuando se llama al método createRange, devuelve el rango nombrado recién creado como una instancia de la clase Range.
El siguiente ejemplo muestra cómo crear un rango nombrado de celdas que se extiende sobre B4:G14.
Accediendo a Todos los Rangos Nombrados en una Hoja de Cálculo
Llama al método getNamedRanges de la WorksheetCollection para obtener todos los rangos nombrados en una hoja de cálculo. El método getNamedRanges devuelve un array de todos los rangos nombrados en la WorksheetCollection.
El siguiente ejemplo muestra cómo acceder a todos los rangos nombrados en un libro de trabajo.
Acceder a un Rango Nombrado Específico
Llame al método getRangeByName de la colección WorksheetCollection para obtener un rango especificado por nombre. Un método típico getRangeByName toma el nombre del rango nombrado y devuelve el rango nombrado especificado como una instancia de la clase Range.
El siguiente ejemplo muestra cómo acceder a un rango especificado por su nombre.
Identificar Celdas en un Rango Nombrado
Usando Aspose.Cells, puede insertar datos en las celdas individuales de un rango. Supongamos que tiene un rango nombrado de celdas, es decir, A1:C4. Entonces, la matriz haría 4 * 3 = 12 celdas y las celdas de rango individuales se organizan secuencialmente. Aspose.Cells le proporciona algunas propiedades útiles de la clase Range para acceder a las celdas individuales en el rango. Puede usar los siguientes métodos para identificar las celdas en el rango:
- getFirstRow devuelve el índice de la primera fila en el rango nombrado.
- getFirstColumn devuelve el índice de la primera columna en el rango nombrado.
El siguiente ejemplo muestra cómo ingresar algunos valores en las celdas de un rango especificado.
Ingresar Datos en las Celdas en el Rango Nombrado
Usando Aspose.Cells, puede insertar datos en las celdas individuales de un rango. Supongamos que tiene un rango nombrado de celdas, es decir, H1:J4. Entonces, la matriz haría 4 * 3 = 12 celdas y las celdas de rango individuales se organizan secuencialmente. Aspose.Cells le proporciona algunas propiedades útiles de la clase Range para acceder a las celdas individuales en el rango. Puede usar las siguientes propiedades para identificar las celdas en el rango:
- getFirstRow devuelve el índice de la primera fila en el rango nombrado.
- getFirstColumn devuelve el índice de la primera columna en el rango nombrado.
El siguiente ejemplo muestra cómo ingresar algunos valores en las celdas de un rango especificado.
Formato de Rangos…Configurar Color de Fondo y Atributos de Fuente a un Rango Nombrado
Para aplicar formato, defina un objeto Style para especificar la configuración de estilo y aplíquelo al objeto Range.
El siguiente ejemplo muestra cómo configurar un color de relleno sólido (color de sombreado) con ajustes de fuente a un rango.
Formato Rangos…Añadir Bordes a un Rango Nombrado
Es posible añadir bordes a un rango de celdas en lugar de solo a una celda individual. El objeto Range proporciona un método setOutlineBorders que toma los siguientes parámetros para agregar un borde al rango de celdas:
- borderStyle: el tipo de borde, seleccionado de la enumeración CellBorderType.
- borderColor: el color de la línea del borde, seleccionado de la enumeración Color.
El siguiente ejemplo muestra cómo establecer un borde de contorno en un rango.
La siguiente salida se generaría después de ejecutar el código anterior:
Aplicar estilo a las celdas en un rango
A veces, desea aplicar un estilo a las celdas en un Rango. Para esto, puede iterar sobre las celdas en el rango y usar el método Cell.setStyle para aplicar el estilo a la celda.
El siguiente ejemplo muestra cómo aplicar estilos a las celdas en un Rango.
Eliminar un Rango Nombrado
Aspose.Cells proporciona el método NameCollection.RemoveAt() para borrar el nombre del rango. Para borrar el contenido del rango, utilice el método Cells.ClearRange(). El siguiente ejemplo muestra cómo eliminar un rango nombrado con su contenido.
borderColors