Cell and ranges

Cells

• By name

sheet = app.active_sheet
cell = sheet['A1']
app.msgbox(cell.name)

• By position [row, column]

cell = sheet[1, 4]
app.msgbox(cell.name)

Ranges

• By name

sheet = app.active_sheet
rango = sheet['B2:D5']
app.msgbox(rango.name)

• By position [start_row:end_row, start_column:end_column]

rango = sheet[1:5,1:4]
app.msgbox(rango.name)

• Group ranges

doc = app.active
sheet = doc.active
last = doc[-1]
with doc.ranges as r:
    # Add one range
    r.add(sheet['A1:B2'])
    r2 = sheet['C4:D5']
    r3 = last['E7:D8']
    r4 = last['E10:F12']
    # Add multiple ranges
    r.add((r2, r3, r4))
    app.debug(r.names)

• Get the same range in all sheets

ranges = doc.get_ranges('A1:B1')
app.debug(ranges.names)

• Get columns by name.

sheet = app.active_sheet
rango = sheet['B:B']
app.debug(rango.name)

rango = sheet['D:F']
app.debug(rango.name)

• Get columns by position.

sheet = app.active_sheet
# Column B
rango = sheet[0:,1]
app.debug(rango.name)

# Columnas D:F
rango = sheet[0:,3:6]
app.debug(rango.name)

• Get rows

sheet = app.active_sheet
# One row
row = sheet[1]
app.debug(row.name)

# Range rows
row = sheet[3:10,0:]
app.debug(row.name)

Info ranges

• Get absolute name

sheet = app.active_sheet
rango = sheet['A1:E10']
app.msgbox(rango.name)

• Get address

sheet = app.active_sheet
rango = sheet['A1']
a = rango.address
data = f"""Cell Address
Row: {a.Row}
Column: {a.Column}
"""
app.msgbox(data)

rango = sheet['A1:E10']
ra = rango.range_address
data = (
    f'Range Address:\n\n'
    f'Star Row: {ra.StartRow}\n'
    f'End Row: {ra.EndRow}\n'
    f'Star Column: {ra.StartColumn}\n'
    f'End Column: {ra.EndColumn}\n'
)
app.msgbox(data)

Special ranges

• Get used area

sheet = app.active_sheet
rango = sheet.used_area
app.msgbox(rango.name)

• Get current region

rango = sheet['A1'].current_region
app.msgbox(rango.name)

• Get next free cell

cell = sheet['A1'].next_cell
app.msgbox(cell.name)

• Get merged area

sheet = app.active_sheet
rango = sheet['A1'].merged_area
app.msgbox(rango.name)

• Get visible cells

sheet = app.active_sheet
rangos = sheet['A1:E10'].visible
for r in rangos:
    app.debug(r.name)

• Get empty cells

sheet = app.active_sheet
rangos = sheet['A1:E10'].empty
for r in rangos:
    app.debug(r.name)