2.3 KiB
2.3 KiB
Trabajar con conjuntos de rangos
address
Referencia a un rango por su dirección.
rango = rangos['Hoja1.A1:B5']
app.debug(rango)
in
Verificar si un rango esta en la colección.
doc = app.active
hoja = doc.active
rangos = doc.selection
resultado = hoja['D5:F10'] in rangos
app.debug(resultado)
index
Referencia a un rango por índice.
doc = app.active
rangos = doc.selection
rango = rangos[1]
app.debug(rango)
iter
Iterar entre los rangos.
doc = app.active
for rango in doc.selection:
app.debug(rango)
20/08/2022 13:27:03 - DEBUG - Range: $Sheet1.$B$4:$D$7
20/08/2022 13:27:03 - DEBUG - Range: $Sheet1.$G$10:$H$14
len
Contar los rangos en la colección.
doc = app.active
contar = len(doc.selection)
app.debug(contar)
selection
Obtener una referencia desde la selección actual. Deben de estar seleccionados más de un rango de celdas.
doc = app.active
seleccion = doc.selection
app.debug(seleccion)
20/08/2022 13:21:17 - DEBUG - Ranges: ('Sheet1.A5:C8', 'Sheet1.E11:F14')
Propiedades
data
Devolver y establecer datos.
doc = app.active
rangos = doc.selection
datos = rangos.data
app.debug(datos)
rangos.data = datos
!!! warning "Cuidado"
Al asignar esta propiedad, cada matriz de datos debe tener exactamente el mismo tamaño del rango destino.
names
Devolver las direcciones de los rangos.
doc = app.active
rangos = doc.selection
nombres = rangos.names
app.debug(nombres)
style
Establecer el estilo de todos los rangos de la colección.
doc = app.active
rangos = doc.selection
rangos.style = 'Good'
Métodos
add
doc = app.active
hoja = doc.active
rangos = doc.ranges()
rangos.add(hoja['A1:B2'])
rangos.add(hoja['D5:F10'])
app.debug(rangos)
ranges
Crear un nuevo contender de rangos vacío.
doc = app.active
rangos = doc.ranges()
app.debug(rangos)
remove
rangos.remove(hoja['A1:B2'])