1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83
|
.. py:currentmodule:: ixion
Sheet
=====
.. class:: ixion.Sheet()
Class :class:`~ixion.Sheet` represents a single sheet that stores cells in
a 2-dimensional grid address space. Rows and columns are used to specify a
position in the grid, and both rows and columns are 0-based, with the
top-left-most cell having the address of row 0 and column 0.
.. attribute:: Sheet.name
A string representing the name of the sheet object. This is a read-only
attribute.
.. method:: Sheet.set_numeric_cell(row, column, value)
Set a numeric *value* to a cell at specified *row* and *column* position.
:param int row: row position.
:param int column: column position.
:param float value: numeric value to set to the specified position.
.. method:: Sheet.set_string_cell(row, column, value)
Set a string *value* to a cell at specified *row* and *column* position.
:param int row: row position.
:param int column: column position.
:param str value: string value to set to the specified position.
.. method:: Sheet.set_formula_cell(row, column, value)
Set a formula expression (*value*) to a cell at specified *row* and *column* position.
:param int row: row position.
:param int column: column position.
:param str value: formula expression to set to the specified position.
.. method:: Sheet.get_numeric_value(row, column)
Get a numeric value representing the content of a cell at specified *row*
and *column* position. If the cell is of numeric type, its value is
returned. If it's a formula cell, the result of the calculated formula
result is returned if the result is of numeric type.
:param int row: row position.
:param int column: column position.
:rtype: float
:return: numeric value of the cell at specified position.
.. method:: Sheet.get_string_value(row, column)
Get a string value representing the content of a cell at specified *row*
and *column* position. If the cell is of string type, its value is
returned as-is. If it's a formula cell, the result of the calculated
formula result is returned if the result is of string type.
:param int row: row position.
:param int column: column position.
:rtype: str
:return: string value of the cell at specified position.
.. method:: Sheet.get_formula_expression(row, column)
Given a formula cell at specified *row* and *column* position, get the
formula expression stored in that cell.
:param int row: row position.
:param int column: column position.
:rtype: str
:return: formula expression stored in the cell at specified position.
.. method:: Sheet.erase_cell(row, column)
Erase the cell at specified *row* and *column* position. The slot at the
specified position becomes empty afterward.
:param int row: row position.
:param int column: column position.
|