com.haulmont.cuba.gui

Interface FrameContext

All Known Subinterfaces:

WindowContext

All Known Implementing Classes:

FrameContextImpl, WindowContextImpl

public interface FrameContext

Provides access to frame parameters and component values.

Method Summary

Modifier and Type	Method and Description
void	addValueChangeListener(java.lang.String componentName, Component.ValueChangeListener listener) Add the value listener to the specified component
void	addValueListener(java.lang.String componentName, ValueListener listener) Deprecated.
Frame	getFrame()
java.util.Map<java.lang.String,java.lang.Object>	getParams() For a window contains parameters passed to the window on opening.
<T> T	getParamValue(java.lang.String param) Value of an external parameters passed to the window on opening.
<T> T	getValue(java.lang.String property) Retrieves value of a component by complex name, dereferencing path to the component and possible drill down to the value
void	removeValueChangeListener(java.lang.String componentName, Component.ValueChangeListener listener) Remove the value listener from the specified component
void	removeValueListener(java.lang.String componentName, ValueListener listener) Deprecated.
void	setValue(java.lang.String property, java.lang.Object value) Set value of a component by its path in the window

Method Detail

getFrame

Frame getFrame()

getParams

java.util.Map<java.lang.String,java.lang.Object> getParams()

For a window contains parameters passed to the window on opening.
For a frame, linked to the window in XML, contains owning window parameters.
For a frame, opened dynamically by openFrame() method contains parameters, passed to the method.

getParamValue

<T> T getParamValue(java.lang.String param)

Value of an external parameters passed to the window on opening.

getValue

<T> T getValue(java.lang.String property)

Retrieves value of a component by complex name, dereferencing path to the component and possible drill down to the value

Parameters:

property - path to the value. Parsed by the following rules:
First split by dots taking into account square brackets, and looking for a component from left to right.
If a component not found, return null.
If a component found and it is a Component.HasValue or ListComponent, retrieve its value.
If the value is null, return it.
If there is nothing left in the path after the component name, return the value.
Else if the value is Instance, drill down to it and return the value of the property by remaining property path.
If the value is an EnumClass and remaining property path is "id", return EnumClass.getId() value.

setValue

void setValue(java.lang.String property,
              java.lang.Object value)

Set value of a component by its path in the window

Parameters:

property - path to the component (separated by dots, taking into account square brackets)

value - value to set

Throws:

java.lang.UnsupportedOperationException - if the component not found or is not a Component.HasValue

addValueListener

@Deprecated
void addValueListener(java.lang.String componentName,
                                  ValueListener listener)

Deprecated.

Add the value listener to the specified component

removeValueListener

@Deprecated
void removeValueListener(java.lang.String componentName,
                                     ValueListener listener)

Deprecated.

Remove the value listener from the specified component

addValueChangeListener

void addValueChangeListener(java.lang.String componentName,
                            Component.ValueChangeListener listener)

Add the value listener to the specified component

removeValueChangeListener

void removeValueChangeListener(java.lang.String componentName,
                               Component.ValueChangeListener listener)

Remove the value listener from the specified component