SalTableRow

Namespace: PPJ.Runtime.Windows

Assembly: PPJ.Runtime.50 (5.0.0.0)

Represents a SAL table row, its state flags, and context-sensitive access to column values.

C#

public class SalTableRow

VB.NET

Public Class SalTableRow

Reading a column indexer changes the parent table context row.

Example:

void MarkSelected(PPJ.Runtime.Windows.SalTableRow row)
{
    row.Selected = true;
    row.Tag = "Reviewed";
}

Properties

ContextRow

Int32: Gets the SAL context-row index translated from the current grid-row position.

Deleted

Boolean: Gets or sets the logical deletion state, hiding deleted rows and repositioning the grid to a valid row.

Deletion can be refused for a header row or when an active editor cannot finish.

Enabled

Boolean: Gets or sets whether the underlying grid row allows editing.

Fetched

Boolean: Gets or sets whether this row has been fetched from its data source.

Throws:

• InvalidOperationException True is assigned when the row is already marked fetched.

Flags

Int32: Gets SAL row flags synchronized from the grid state or replaces the flags and applies their effects.

Grid

C1FlexGrid: Gets the ComponentOne grid containing the row.

GridRow

Row: Gets the underlying ComponentOne grid row.

Item(index)

SalTableColumn: Sets this row as the table context and gets a column by collection index.

Item(name)

SalTableColumn: Sets this row as the table context and finds a column by its exact control name.

Item(column)

SalTableColumn: Sets this row as the context for an existing column in the same table.

ParentTable

SalTableWindow: Gets the SAL table that owns the row.

Selected

Boolean: Gets or sets whether the underlying grid row is selected.

Tag

Object: Gets or sets application data associated with this row wrapper.

Visible

Boolean: Gets or sets the grid row visibility and refreshes fetched rows.

Hiding clears selection. Showing checks header and active-editor restrictions before proceeding.

Methods

IsModified(col)

Checks the stored modification bit for a column.

Parameter	Type	Description
col	Int32	The nonnegative column modification-bit index.

Returns: Boolean. The bit value, or false when no modification map exists or the index exceeds its length.

Remove()

Removes the grid row after any active editor successfully finishes, then refreshes virtual rows and current-row positioning.

Fixed header rows and rows blocked by editor validation are retained.

SetFlags(flags, on)

Enables or clears selected SAL row flags and applies their effects to the grid row.

Parameter	Type	Description
flags	Int32	The Sys.ROW_* flags to change.
on	Boolean	True to set the flags; false to clear them.

SetModified(col, on)

Updates a column modification bit and marks the row edited when any column remains modified.

Parameter	Type	Description
col	Int32	The modification-bit index; negative values are ignored.
on	Boolean	The desired modification state.

Clearing the last modified bit does not automatically clear ROW_Edited.