Spread Windows Forms 18
Spread Windows Forms 18 Product Documentation / Developer's Guide / Customizing Interaction in Cells / Using Edit Mode and Focus / Understanding Edit Mode in a Cell
In This Topic
    Understanding Edit Mode in a Cell
    In This Topic

    Typically, when the end user double-clicks in the cell, the editor control is made available and the user can type in the cell. This ability to edit in a cell is called edit mode. Several properties and methods can customize the use of edit mode.

    When the cell is in edit mode, the active cell typically displays a flashing I-beam cursor, as shown in the figure below. When the cell is not in edit mode, the active cell typically displays a focus rectangle, also as shown.

    Edit Mode Cursor Appearance

    Selected Cell Appearance

    Cell in edit mode Cell selected but not in edit mode

    A cell enters edit mode (edit mode is turned on) when

    A cell leaves edit mode (edit mode is turned off) when

    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.

    If you prefer, you can specify that a cell is always in edit mode when it becomes the active cell using the EditModePermanent property.

    When a cell enters edit mode, the EditModeOn event occurs; when a cell leaves edit mode, the EditModeOff event occurs.

    You can set the position of the cursor in the edit control when it receives the focus by using the SuperEditBase.EditModeCursorPosition property.

    You can start and stop edit mode by using the StartCellEditing and StopCellEditing methods.

    You can keep the cell alignment when editing with the AllowEditorVerticalAlign property.

    Using the Properties Window

    1. At design time, in the Properties window, select the Spread component.
    2. In the Properties window, select the EditModePermanent or EditModeReplace properties.

    Using the Spread Designer

    1. Select the Settings menu.
    2. Select the Edit option (Spread Settings section).
    3. Check the Cells Always in EditMode option for EditModePermanent or Editing Replaces Existing Text for EditModeReplace.
    4. Use the File menu, then Apply and Exit to save the changes.
    See Also