com.haulmont.cuba.gui.components

Interface Form

All Superinterfaces:

ChildEditableController, Component, Component.BelongToFrame, Component.Editable, Component.HasCaption, Component.HasDescription, Component.HasIcon, ComponentContainer, EditableChangeNotifier, HasContextHelp, HasHtmlCaption, HasHtmlDescription, HasHtmlSanitizer, HasValueSourceProvider

public interface Form
extends Component, Component.BelongToFrame, Component.HasCaption, Component.HasIcon, ComponentContainer, Component.Editable, EditableChangeNotifier, HasContextHelp, ChildEditableController, HasValueSourceProvider, HasHtmlCaption, HasHtmlDescription, HasHtmlSanitizer

A multi-column form component.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	Form.CaptionAlignment Caption alignment of form child components.
static class	Form.CaptionPosition Caption position of form child components.

Nested classes/interfaces inherited from interface com.haulmont.cuba.gui.components.EditableChangeNotifier

EditableChangeNotifier.EditableChangeEvent

Nested classes/interfaces inherited from interface com.haulmont.cuba.gui.components.HasContextHelp

HasContextHelp.ContextHelpIconClickEvent

Nested classes/interfaces inherited from interface com.haulmont.cuba.gui.components.Component

Component.Alignment, Component.BelongToFrame, Component.Disposable, Component.Editable, Component.Focusable, Component.HasCaption, Component.HasDescription, Component.HasIcon, Component.HasXmlDescriptor, Component.OptionsStyleProvider, Component.Wrapper

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	NAME

Fields inherited from interface com.haulmont.cuba.gui.components.Component

AUTO_SIZE, AUTO_SIZE_PX, FULL_SIZE, UNITS_PERCENTAGE, UNITS_PIXELS

Method Summary

Modifier and Type	Method and Description
default void	add(Component... childComponents) Sequentially adds components to the first column.
void	add(Component childComponent) Adds a component to the first column.
void	add(Component childComponent, int column) Adds a component to the column with the given index.
void	add(Component childComponent, int column, int row) Adds a component to a column with the given index to the given position.
void	add(Component childComponent, int column, int colSpan, int rowSpan) Adds a component to a column with the given index with the given span.
void	add(Component childComponent, int column, int row, int colSpan, int rowSpan) Adds a component to a column with the given index to the given position with the given span.
Form.CaptionPosition	getCaptionPosition()
Form.CaptionAlignment	getChildrenCaptionAlignment()
Form.CaptionAlignment	getChildrenCaptionAlignment(int column) Returns alignment of child component captions for a column with the given index.
int	getChildrenCaptionWidth()
int	getChildrenCaptionWidth(int column) Returns fixed caption width for column with a given index.
float	getColumnFlex(int column) Returns the flex layout ratio for column with a given index.
int	getColumns()
Component	getComponent(int column, int row)
java.util.Collection<Component>	getComponents(int column)
void	setCaptionPosition(Form.CaptionPosition captionAlignment) Sets position of component captions.
void	setChildrenCaptionAlignment(Form.CaptionAlignment alignment) Sets alignment of child component captions in all columns.
void	setChildrenCaptionAlignment(int column, Form.CaptionAlignment alignment) Sets alignment of child component captions for a column with the given index.
void	setChildrenCaptionWidth(int width) Sets fixed captions width for all columns.
void	setChildrenCaptionWidth(int column, int width) Set fixed captions width for column with a given index.
void	setColumnFlex(int column, float flex) Sets flex layout ratio for column with a given index.
void	setColumns(int columns) Sets the number of columns in the Form.

Methods inherited from interface com.haulmont.cuba.gui.components.Component.BelongToFrame

getFrame, setFrame

Methods inherited from interface com.haulmont.cuba.gui.components.Component.HasIcon

getIcon, setIcon, setIconFromSet

Methods inherited from interface com.haulmont.cuba.gui.components.ComponentContainer

focusFirstComponent, getComponent, getComponentNN, getComponents, getOwnComponent, getOwnComponents, getOwnComponentsStream, remove, remove, removeAll

Methods inherited from interface com.haulmont.cuba.gui.components.EditableChangeNotifier

addEditableChangeListener, removeEditableChangeListener

Methods inherited from interface com.haulmont.cuba.gui.components.HasContextHelp

getContextHelpIconClickHandler, getContextHelpText, isContextHelpTextHtmlEnabled, setContextHelpIconClickHandler, setContextHelpText, setContextHelpTextHtmlEnabled

Methods inherited from interface com.haulmont.cuba.gui.components.Component.Editable

isEditable, isEditableWithParent, setEditable

Methods inherited from interface com.haulmont.cuba.gui.components.Component

addStyleName, getAlignment, getHeight, getHeightSizeUnit, getHeightUnits, getId, getParent, getStyleName, getWidth, getWidthSizeUnit, getWidthUnits, isEnabled, isEnabledItself, isEnabledRecursive, isResponsive, isVisible, isVisibleItself, isVisibleRecursive, removeStyleName, requestFocus, setAlignment, setEnabled, setHeight, setHeightAuto, setHeightFull, setId, setParent, setResponsive, setSizeAuto, setSizeFull, setStyleName, setVisible, setWidth, setWidthAuto, setWidthFull, unwrap, unwrapComposition, unwrapCompositionOrNull, unwrapOrNull, withUnwrapped, withUnwrappedComposition

Methods inherited from interface com.haulmont.cuba.gui.components.data.HasValueSourceProvider

getValueSourceProvider, setValueSourceProvider

Methods inherited from interface com.haulmont.cuba.gui.components.HasHtmlCaption

isCaptionAsHtml, setCaptionAsHtml

Methods inherited from interface com.haulmont.cuba.gui.components.Component.HasCaption

getCaption, setCaption

Methods inherited from interface com.haulmont.cuba.gui.components.Component.HasDescription

getDescription, setDescription

Methods inherited from interface com.haulmont.cuba.gui.components.HasHtmlDescription

isDescriptionAsHtml, setDescriptionAsHtml

Methods inherited from interface com.haulmont.cuba.gui.components.HasHtmlSanitizer

isHtmlSanitizerEnabled, setHtmlSanitizerEnabled

Field Detail

NAME

static final java.lang.String NAME

See Also:

Constant Field Values

Method Detail

add

void add(Component childComponent)

Adds a component to the first column.

Specified by:

add in interface ComponentContainer

Parameters:

childComponent - a component to add

add

default void add(Component... childComponents)

Sequentially adds components to the first column.

Specified by:

add in interface ComponentContainer

Parameters:

childComponents - components to add

add

void add(Component childComponent,
         int column)

Adds a component to the column with the given index.

Parameters:

childComponent - a component to add

column - a columns index

add

void add(Component childComponent,
         int column,
         int colSpan,
         int rowSpan)

Adds a component to a column with the given index with the given span.

Parameters:

childComponent - a component to add

column - a columns index

colSpan - a number of columns a component should span

rowSpan - a number of rows a component should span

add

void add(Component childComponent,
         int column,
         int row)

Adds a component to a column with the given index to the given position.

Parameters:

childComponent - a component to add

column - a columns index

row - a row index

add

void add(Component childComponent,
         int column,
         int row,
         int colSpan,
         int rowSpan)

Adds a component to a column with the given index to the given position with the given span.

Parameters:

childComponent - a component to add

column - a columns index

row - a row index

colSpan - a number of columns a component should span

rowSpan - a number of rows a component should span

getComponents

java.util.Collection<Component> getComponents(int column)

Parameters:

column - a column index

Returns:

a collection of components directly owned by a column with a given index

getComponent

Component getComponent(int column,
                       int row)

Parameters:

column - a columns index

row - a row index

Returns:

a component placed in a column with a given index in a given position

getCaptionPosition

Form.CaptionPosition getCaptionPosition()

Returns:

position of component captions

setCaptionPosition

void setCaptionPosition(Form.CaptionPosition captionAlignment)

Sets position of component captions.

Parameters:

captionAlignment - component captions position

getChildrenCaptionWidth

int getChildrenCaptionWidth()

Returns:

columns fixed caption width

setChildrenCaptionWidth

void setChildrenCaptionWidth(int width)

Sets fixed captions width for all columns. Set -1 to use auto size.

Parameters:

width - fixed caption width

getChildrenCaptionWidth

int getChildrenCaptionWidth(int column)

Returns fixed caption width for column with a given index.

Parameters:

column - a column index

Returns:

fixed caption width for column with a given index

setChildrenCaptionWidth

void setChildrenCaptionWidth(int column,
                             int width)

Set fixed captions width for column with a given index. Set -1 to use auto size.

Parameters:

column - a column index

width - fixed caption width for column with a given index

getChildrenCaptionAlignment

Form.CaptionAlignment getChildrenCaptionAlignment()

Returns:

alignment of child component captions

setChildrenCaptionAlignment

void setChildrenCaptionAlignment(Form.CaptionAlignment alignment)

Sets alignment of child component captions in all columns.

Applicable only when captions position is Form.CaptionPosition.LEFT.

Parameters:

alignment - captions alignment

getChildrenCaptionAlignment

Form.CaptionAlignment getChildrenCaptionAlignment(int column)

Returns alignment of child component captions for a column with the given index.

Parameters:

column - a column index to get caption

Returns:

alignment of child component captions for a column with the given index

setChildrenCaptionAlignment

void setChildrenCaptionAlignment(int column,
                                 Form.CaptionAlignment alignment)

Sets alignment of child component captions for a column with the given index.

Parameters:

column - a column index to set caption

alignment - alignment of child component captions for a column with the given index

getColumns

int getColumns()

Returns:

number of columns in the Form

setColumns

void setColumns(int columns)

Sets the number of columns in the Form. The column count can not be reduced if there are any components that would be outside of the shrunk Form.

Parameters:

columns - the new number of columns in the Form

getColumnFlex

float getColumnFlex(int column)

Returns the flex layout ratio for column with a given index.

Parameters:

column - a column index

Returns:

flex layout ratio for column with a given index

setColumnFlex

void setColumnFlex(int column,
                   float flex)

Sets flex layout ratio for column with a given index.

Parameters:

column - a column index

flex - the flex ration for the column