company logo

Cell :: position - Cell position property

The relative position in a line (column position in a region) begins with position 0 for the first column. When a position is set, the position 'overwrites' the column name, i.e. after setting a position, the column name will be ignored when attaching the cell.

When setting a column name, the position will be determined for the new column name. When a new list item is attached to the parent line, the position is reset to -1, when a column name is defined for the cell. It will be recalculated from the column name, when accessing data items via the cell.

Return value:  Position in collection ( int32  )

The position of an entry in a collection or list is the number of the entry in the collection beginning with 0 for the first entry.

Implementation overview

Implementation details

  1. Get cell position
    int32 Cell  :: position (  )

    The function returns the cell position in the attached data item or the cell position currently set for the cell.

  2. to list
  3. Change cell position
    int32 Cell  :: position ( int32 iPosition )

    The function sets the cell position to the value passed in iPosition. Changing the position will reset the column name in the cell, since different columns may correspond to the same column position in different regions.

    In order to force re-calculation of the cell position, one may pass -1 as position, in which case the column name will not be reset.

    • iPosition - Position in collection

      The position of an entry in a collection or list is the number of the entry in the collection beginning with 0 for the first entry.

  4. to list