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, HasValueSourceProvider

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

A multi-column form component.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	Form.CaptionPosition Caption alignment.

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 a columns with a given index.
void	add(Component childComponent, int column, int row) Adds a component to a columns with a given index to a given position.
Form.CaptionPosition	getCaptionPosition()
int	getChildrenCaptionWidth()
int	getChildrenCaptionWidth(int column) Returns fixed caption width 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 alignment of component captions.
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	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

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

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 a columns with a given index.

Parameters:

childComponent - a component to add

column - a columns index

add

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

Adds a component to a columns with a given index to a given position.

Parameters:

childComponent - a component to add

column - a columns index

row - a row index

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:

alignment of component captions

setCaptionPosition

void setCaptionPosition(Form.CaptionPosition captionAlignment)

Sets alignment of component captions.

Parameters:

captionAlignment - component captions alignment

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

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