AllowChangeSelectedRow - cWebList

Tests whether you can move off the selected row to a different row

Type: Function

Return Data Type: Boolean

Parameters: String sGotoRow String sToRowID

ParameterDescription
sGotoRowIndicates how to treat the second parameter:

ConstantMeaning
"row"Indicates that we are going to a specific row as specified in sToRowID
"first"Indicates that we are going to the first row in the data set. Ignore sToRowID
"last"Indicates that we are going to the last row in the data set. Ignore sToRowID
"new"Indicates that we are creating a new row. Ignore sToRow

sToRowIDIs the row ID of the row the user is navigating to


Return Value

Return True if the row change is allowed, return False if it is disallowed.


Syntax
Function AllowChangeSelectedRow String sGotoRow String sToRowID Returns Boolean

Call: Get AllowChangeSelectedRow sGotoRow sToRowID to BooleanVariable


Description

You can augment AllowChangeSelectedRow to perform special tests to allow, or disallow the user to move from the currently selected row to some other row in the grid.

AllowChangeSelectedRow has special predefined behaviour. If you are augmenting this method, you should always perform your customization then 'forward send' this message, for example:

Function AllowChangeSelectedRow String sGotoRow String sToRowID Returns Boolean
    Boolean bAllow
    Move True to bAllow
    // add your logic here..

    If (bAllow) Begin
        Forward Get AllowChangeSelectedRow sGotoRow sToRowID to bAllow
    End

    Function_Return bAllow
End_Function