SET ENTERABLE

version 2004 (Modified)

SET ENTERABLE ({*; }entryArea; enterable)

The SET ENTERABLE command makes the form objects specified by object either enterable or non-enterable.

If you specify the optional * parameter, you indicate an object name (a string) in object. If you omit the optional * parameter, you indicate a table, field or variable in object. In this case, specify a table, field or variable reference (field or variable objects only) instead of a string. For more information about object names, see the section Object Properties.

Using this command is equivalent to selecting Enterable for a field or variable in the Form Editor's Property List window. This command works in subforms only if it is in the form method of the subform.

When the entryArea is enterable (TRUE), the user can move the cursor into the area and enter data. When the entryArea is non-enterable (FALSE), the user cannot move the cursor into the area and cannot enter data.

The SET ENTERABLE command can also be used to enable the "Enter in List" mode by programming for subforms and list forms displayed using the MODIFY SELECTION and DISPLAY SELECTION commands:

• For subforms, in the entryArea parameter, pass either the name of the subform table or the name of the subform object itself, for example: SET ENTERABLE(*;"Subform";True).

• For list forms, you must pass the name of the form table in the entryArea parameter, for example: SET ENTERABLE([MyTable];True).

Making an object non-enterable does not prevent you from changing its value programmatically.

1. The following example sets a shipping field, depending on the weight of the shipment. If the shipment is 1 ounce or less, then the shipper is set to US Mail and the field is set to be non-enterable. Otherwise, the field is set to be enterable.

   If ([Shipments]Weight<=1)
      [Shipments]Shipper:="US Mail" 
      SET ENTERABLE([Shipments]Shipper;False) 
   Else 
      SET ENTERABLE([Shipments]Shipper;True) 
   End if

2. Here is the object method of a checkbox located in the header of a list in order to control the Enter in List mode:

   C_BOOLEAN(bEnterable)
   SET ENTERABLE([Table1];bEnterable)

DISABLE BUTTON, ENABLE BUTTON, SET VISIBLE.