MSG-BEGIN-SORT

This event is fired each time a sort is required for a grid with either the Sortable-Columns style or Sort-Types. Depending on the sort settings, the EVENT-STATUS item has different meanings.

If the event is fired by a Grid with the Sortable-Columns style:

 

EVENT-DATA-1 contains a value of 0 if the sort has been issued by setting the Action property to ACTION-SORT, or 1 if the sort has been issued by clicking on the heading. EVENT-DATA-2 contains the order type:

1	no order
2	ascending
3	descending

To prevent the sort from completing and leave the grid unchanged, set EVENT-ACTION to EVENT-ACTION-FAIL. To change the sort settings, modify the Sort-data property and set EVENT-ACTION to EVENT-ACTION-COMPLETE.

If the event is fired by a Grid with Sort-Types:

 

EVENTDATA-1 contains the column number. Setting EVENT-ACTION to EVENT-ACTION-FAIL or EVENT-ACTION-COMPLETE, the sort is not performed. Do it if you wish to provide a custom sort procedure by emptying the grid and reloading it in the desired order.