Item_Change - Cm_Menu

A programming hook to perform an action when moving to another item

Type: Event

Parameters

Parameter	Type	Description
iFromItem	Integer	Item to change from
iToItem	Integer	Item to change to

Syntax

Procedure Item_Change Integer iFromItem Integer iToItem

Description

The Item_Change event is triggered each time the current item has changed (navigation is about to move to another item). By default, the message will cause auto_select-mode objects to track the selected item along with the Current_Item. The message is provided as a programming "hook" to perform an action on change of an item.

Procedure Item_Change Integer iFromItem Integer iToItem Returns Integer
    Integer iRetVal

    Get Valid_Item iFromItem To iRetVal
    If (iRetval <> 0) Begin
        Send Bell
        Procedure_Return iFromItem
    End
    Forward Get msg_Item_Change iFromItem iToItem to iRetVal
    Procedure_Return iRetVal
End_Procedure