Package com.smartgwt.client.types

Enum RowSpanEditMode

java.lang.Object
java.lang.Enum<RowSpanEditMode>
com.smartgwt.client.types.RowSpanEditMode
All Implemented Interfaces:
ValueEnum, Serializable, Comparable<RowSpanEditMode>, Constable
public enum RowSpanEditMode extends Enum<RowSpanEditMode> implements ValueEnum
When ListGrid.allowRowSpanning is enabled, certain cells may span multiple rows. In this case, the cell displays the value from the record in the first row. If the grid is editable (and the field is also editable), these settings allow the user to specify what happens to the data when the user edits this cell.

Note that in this scenario, a user may begin an edit on the row-spanning cell directly (via double-click for example), or on a cell in another column in any of the rows spanned by the cell. The appropriate behavior with respect to user-experience and how the data is manipulated will depend on the application in question. Developers may of course entirely disable editing for the field via ListGridField.canEdit or ListGrid.canEditCell().

See also: ListGrid.useRowSpanStyling

  • Enum Constant Details

    • FIRST

      public static final RowSpanEditMode FIRST
      This setting assumes that only the field-value for the first record spanned by this cell is significant. In this case the editor will only show for this cell if the user is editing the first spanned record. If the user initialized the edit on another spanned row, the editor will not show for this field.

      If this enumerated value is used in a Component XML file or server-side DataSource descriptor (.ds.xml file), use the value "first".

    • EACH

      public static final RowSpanEditMode EACH
      This setting assumes that each row's values are logically separate, so if a cell spans multiple rows, and a user initializes an edit on some cell in the second spanned row, the spanning cell will show an editor containing the value for the second spanned row. This may differ from the value displayed when not in edit mode (which is derived from the first spanned row by default). This setting may be useful for developers who which to implement their own logic on how to handle spanning cell display values and/or edit values (for example by using custom formatting and applying custom logic to handle editing on ListGridField.editorEnter() and ListGridField.editorExit()).

      If this enumerated value is used in a Component XML file or server-side DataSource descriptor (.ds.xml file), use the value "each".

  • Method Details

    • values

      public static RowSpanEditMode[] values()
      Returns an array containing the constants of this enum type, in the order they are declared.
      Returns:
      an array containing the constants of this enum type, in the order they are declared

    • valueOf

      public static RowSpanEditMode valueOf(String name)
      Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)
      Parameters:
      name - the name of the enum constant to be returned.
      Returns:
      the enum constant with the specified name
      Throws:
      IllegalArgumentException - if this enum type has no constant with the specified name
      NullPointerException - if the argument is null

    • getValue

      public String getValue()
      Specified by:
      getValue in interface ValueEnum