Item_Entry - Cm_Entry

Sends iMessage to the current object if it is non-zero

Type: Event
Return Data Type: Integer

Parameters

Parameter	Type	Description
iMessage	Integer	The Message id (e.g. get_IsEntryOk)
iItem	Integer	The entering item number

Syntax

Function Item_Entry Integer iMessage Integer iItem Returns Integer

Description

The Item_Entry message sends iMessage to the current object if it is non-zero. This is an intermediate message sent during item change so that the program can intercept the change before it actually takes place. For example, you might check iMessage and if it is zero, substitute a generic message:

function item_entry integer entry_msg integer item_number returns integer
    integer ret_val
    if entry_msg eq 0 move generic_msg to entry_msg
    forward get item_entry entry_msg item_number to ret_val
    function_return ret_val
end_function

Return Value

Returns 0 if entry is ok, non-zero if entry should not be allowed