GML::START_EDIT - Initiate Grid Edit Mode

Syntax

CALL "GML::START_EDIT"

Description

This procedure initiates editing mode in a main grid cell based on the values in GML_TPL$ template variables GML_TPL.ROW_N% and GML_TPL.COL_N%. This procedure is valid only when applied to the main grid (GML_TPL.MEMBER%=1).

Options

Placing text in the variable GML_TPL.TEXT$ prior to executing the START_EDIT procedure will place that value into the selected grid cell when the cell changes to the edit mode. If variable GML_TPL.MASK$[c] contains a mask, and [c] is equal to the value in GML_TPL.COL_N%, it will be used as a mask for data entry into the cell.

If the START_EDIT procedure is executed and the cell to be edited is set to a non editable mode, the procedure will return a –9 or a –12 in variable GML.FLAG% indicating that the START_EDIT procedure was not successfully executed. Setting the GML_TPL$ template variable GML_TPL.DEF_FLAG% to a –1 will allow editing of a non editable cell.

Example

2400 GML.SET%=1
2410 CALL "GML::TPL_PREP"
2430 GML_TPL.ROW_N%=4
2440 GML_TPL.COL_N%=2
2450 CALL "GML::START_EDIT"

See Also

Visual PRO/5 Grid Management Library

Alphabetical Listing of GML Procedures