SORT_OFF

SORT_OFF N

STOPS THE AUTOMATIC SORT OF THE SYSTEM OBJECT NUMBER N

  • Type: Command
  • Parameter: 1
  • Group: System Objects

ACTION

The command SORT_OFF N stops the automatic sort of the items of the system object designated by its number N.

Remark: the automatic sort is started by the command SORT_ON.

SYNTAX: SORT_OFF N

  • N = system object number (integer or real). Must be greater than 0 and less than or equal to the allowed maximum number of system objects.

USE

  • The command SORT_OFF is used to stop the automatic sorting of the content of a system object COMBO, LIST or DLIST.

ERROR

  • If number N is not a correct expression.
  • If number N exceeds the allowed maximum number of system objects.
  • If number N is less than 0.
  • If system object number N does not exist.
  • If system object number N is not of the type : COMBO, LIST, DLIST.

EXAMPLE

rem create a LIST

list 1

rem add 3 lines

item_add 1,"BBB"

item_add 1,"CCC"

item_add 1,"AAA"

rem start the automatic sort

sort_on 1

rem add one item

item_add 1,"ABC"

rem the order is : AAA,ABC,BBB,CCC

rem stop the automatic sort

sort_off 1

rem add one item

item_add 1,"ABD"

rem the order is : AAA,ABC,BBB,CCC,ABD

SEE ALSO

SORT

SORT_OFF