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