1.156.3 Get methods

table <-cell: x=int|name, y=int|name -> table_cell

Fetch the table_cell object at the given column/row coordinate. Cordinates are 1-based. Fails silently if the table has no cell at the given coordinate. See also table<-row, table<-column, table->append.

table <-cell_from_position: at=point|event, allow_border=[bool] -> table_cell|point

Translate coordinate to cell or point. If the table contains a cell at the given location, this cell will be returned. Otherwise, if the location is within the column/row range of the table, a point will be returned containing the coordinates of the (empty) cell. This may be used to create a cell at the indicated location. For example:

start_typing(Table, Ev:event) :->
        get(Table, cell_from_position, Ev, CellOrPos),
        (   send(CellOrPos, instance_of, table_cell)
        ->  send(CellOrPos?image, keyboard_focus, @on)
        ;   object(CellOrPos, point(X, Y)),
                send(Table, append,
                     new(T, editable_text('')), X, Y),
                send(Table, compute), % force display now
                send(T, keyboard_focus, @on)
        ).

table <-cells_in_region: area -> chain

Find all cells in a row/column region. Handy for operations on a rectangular subpart of the table. See also table<-cell, table<-row or table<-column.

table <-column: x=int|name, create=[bool] -> table_column

Fetch the table_column object at the given 1-based column index or with the given name. If Create is @on, a new column is created and attached to the table if the specified n-th column is not yet defined.

Normally used to specify the column attributes:

...,
get(Table, column, 1, @on, Col),
send(Col, halign, center),
...

Access to the table_column object is can also used with table->delete to delete a column from the table.

See also table<-row, table_slice->name.

table <-row: y=int|name, create=[bool] -> table_row

Fetch the table_row object at the given 1-based row index or with the given name. If Create is @on, a new row is created and attached to the table if the specified n-th row is not yet defined.

Normally used to specify the row attributes:

...,
get(Table, row 1, @on, Col),
send(Col, valign, center),
...

Access to the table_row object is can also used with table->delete to delete a row from the table.

See also table<-column.

table <-selection: -> chain

Chain holding selected cells. See also table->selection.