OBJECT SET ENTERABLE

Home

4D v16.3


OBJECT SET ENTERABLE ( {* ;} object ; enterable )

Parameter	Type	Description
*	Operator	If specified, Object is an Object Name (String) If omitted, Object is a Field or a Variable
object	Form object	Object Name (if * is specified), or Table or Field or Variable (if * is omitted)
enterable	Boolean	True for enterable; False for non-enterable

Description

The OBJECT 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 Object Properties section.

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 OBJECT 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: OBJECT SET ENTERABLE(*;"Subform";True).
For list forms, you must pass the name of the form table in the entryArea parameter, for example: OBJECT SET ENTERABLE([MyTable];True).

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

Note: To make a list box cell non-enterable, you pass the value -1 to $0 in the On Before Data Entry event, see Managing entry.

Example 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"

    OBJECT SET ENTERABLE([Shipments]Shipper;False)

 Else

    OBJECT SET ENTERABLE([Shipments]Shipper;True)

 End if

Example 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)

 OBJECT SET ENTERABLE([Table1];bEnterable)