191 lines
3.0 KiB
ReStructuredText
191 lines
3.0 KiB
ReStructuredText
Cell and ranges
|
|
~~~~~~~~~~~~~~~
|
|
|
|
Cells
|
|
^^^^^
|
|
|
|
* By name
|
|
|
|
.. code-block:: python
|
|
|
|
sheet = app.active_sheet
|
|
cell = sheet['A1']
|
|
app.msgbox(cell.name)
|
|
|
|
|
|
* By position [row, column]
|
|
|
|
.. code-block:: python
|
|
|
|
cell = sheet[1, 4]
|
|
app.msgbox(cell.name)
|
|
|
|
|
|
Ranges
|
|
^^^^^^
|
|
|
|
* By name
|
|
|
|
.. code-block:: python
|
|
|
|
sheet = app.active_sheet
|
|
rango = sheet['B2:D5']
|
|
app.msgbox(rango.name)
|
|
|
|
* By position [start_row:end_row, start_column:end_column]
|
|
|
|
.. code-block:: python
|
|
|
|
rango = sheet[1:5,1:4]
|
|
app.msgbox(rango.name)
|
|
|
|
* Group ranges
|
|
|
|
.. code-block:: python
|
|
|
|
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
|
|
|
|
.. code-block:: python
|
|
|
|
ranges = doc.get_ranges('A1:B1')
|
|
app.debug(ranges.names)
|
|
|
|
* Get columns by name.
|
|
|
|
.. code-block:: python
|
|
|
|
sheet = app.active_sheet
|
|
rango = sheet['B:B']
|
|
app.debug(rango.name)
|
|
|
|
rango = sheet['D:F']
|
|
app.debug(rango.name)
|
|
|
|
* Get columns by position.
|
|
|
|
.. code-block:: python
|
|
|
|
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
|
|
|
|
.. code-block:: python
|
|
|
|
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
|
|
|
|
.. code-block:: python
|
|
|
|
sheet = app.active_sheet
|
|
rango = sheet['A1:E10']
|
|
app.msgbox(rango.name)
|
|
|
|
* Get address
|
|
|
|
.. code-block:: python
|
|
|
|
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
|
|
|
|
.. code-block:: python
|
|
|
|
sheet = app.active_sheet
|
|
rango = sheet.used_area
|
|
app.msgbox(rango.name)
|
|
|
|
* Get current region
|
|
|
|
.. code-block:: python
|
|
|
|
rango = sheet['A1'].current_region
|
|
app.msgbox(rango.name)
|
|
|
|
* Get next free cell
|
|
|
|
.. code-block:: python
|
|
|
|
cell = sheet['A1'].next_cell
|
|
app.msgbox(cell.name)
|
|
|
|
* Get merged area
|
|
|
|
.. code-block:: python
|
|
|
|
sheet = app.active_sheet
|
|
rango = sheet['A1'].merged_area
|
|
app.msgbox(rango.name)
|
|
|
|
* Get visible cells
|
|
|
|
.. code-block:: python
|
|
|
|
sheet = app.active_sheet
|
|
rangos = sheet['A1:E10'].visible
|
|
for r in rangos:
|
|
app.debug(r.name)
|
|
|
|
* Get empty cells
|
|
|
|
.. code-block:: python
|
|
|
|
sheet = app.active_sheet
|
|
rangos = sheet['A1:E10'].empty
|
|
for r in rangos:
|
|
app.debug(r.name)
|