EditMode Property

---

See Also    DLL    Example

Applies To

fpSpread control

Description

Sets or returns whether a cell is in edit mode. This property is available at run time only.

Syntax

BOOL CSpreadSheet::GetEditMode( );
void CSpreadSheet::SetEditMode(BOOL value);

[form.]fpSpread.EditMode[ = boolean%]

Remarks

A cell enters edit mode when

• the user starts typing in the cell
• the user double-clicks the cell
• the EditMode property is set to True

A cell leaves edit mode when

• the user presses the Enter key
• the user activates a different cell
• the application loses the focus
• the EditMode property is set to False

The edit mode setting indicates whether the user is currently editing the active cell. If you set the EditMode property, the setting affects the active cell.

When the cell is in edit mode, the active cell usually displays a flashing I-beam cursor. When the cell is not in edit mode, the active cell usually displays a focus rectangle.

When a cell enters or leaves edit mode, the EditMode event occurs.

When a cell enters edit mode, by default the cursor is positioned at the end of the existing text in the cell. You can change it to select the existing text in the cell by setting the EditModeReplace property. You can specify which cell becomes the active cell when you press the Enter key to leave edit mode by setting the EditEnterAction property. If you prefer, you can specify that a cell is always in edit mode when it becomes the active cell using the EditModePermanent property.

This setting is applied to the current sheet setting unless you first set the Sheet property to specify the sheet for which you are setting the property.

Data Type

Integer (Boolean)

See Also

Keeping Edit Mode Permanently On
Setting the Edit Mode

EditEnterAction, EditModePermanent, EditModeReplace, Sheet properties

EditChange, EditError, EditMode events

DLL Correspondence

SSGetEditMode, SSSetEditMode functions