Package com.iizix.prop.ui

Class UIContainer

java.lang.Object
com.iizix.prop.GProp<GProp<?>[]>
com.iizix.prop.PropCnr
com.iizix.prop.ui.UIComp
com.iizix.prop.ui.UIContainer
All Implemented Interfaces:
EventListener, IFocusComp, IMessageBox, IComponent, ICustomDataProvider, IGProp<GProp<?>[]>, IPropCnr, IUIComp, IUIContainer, IUIContextMenuOwner, IUIFocusComp, IVSComponentListener, IVSComponentState, IVSFieldListener, IVSGenericComponentListener, Cloneable
Direct Known Subclasses:
AbstractContentUIContainer, EUIContainer, MList, MUIHeading, MUITabBar, UIAccordion, UICalendarList, UIMap, UIMenu, UIMenuBar, UIPanelBase, UIPanelPartCnr, UISwapContainer, UITabContainer, UITable, UITitlePane
public class UIContainer extends UIComp implements IUIContainer, IUIFocusComp, IUIContextMenuOwner, IVSGenericComponentListener
The UIContainer class is a standard simple container for components.
Author:
Christopher Mindus

  • Field Details

    • UICOMP_CLASS

      public static final Class<?>[] UICOMP_CLASS
      Accepted children components array: UIComp class.

    • VS_STATE_FOCUS_PROP_NAME

      public static final String VS_STATE_FOCUS_PROP_NAME
      The property name for VS connection for state and focus.
      See Also:

    • WARN_EMPTY_PROP_NAME

      public static final String WARN_EMPTY_PROP_NAME
      The property name for empty container warning issuing, if property is not present or true, the warning will be shown.
      See Also:

  • Constructor Details

    • UIContainer

      public UIContainer()
      Creates an UI container with the specified name with a null value.

    • UIContainer

      public UIContainer(Atom propertyAtom)
      Creates an UI container with the specified name with a null value.
      Parameters:
      propertyAtom - the property atom.

    • UIContainer

      public UIContainer(Atom propertyAtom, GProp<?>[] properties) throws PropException
      Creates an UI container with the specified name and properties.
      Parameters:
      propertyAtom - the property atom.
      properties - the property array value for the property.
      Throws:
      PropException - as structural changes in containers on client is prohibited.

  • Method Details

    • clone

      public UIContainer clone()
      Creates a clone out of this property. The cloning is overridden by the subclasses in order to handle cloning of its class variables appropriately.

      Cloning is used for "virtualization" of a property tree in the server. Client property classes will therefore throw CloneNotSupportedException.

      Once a tree has been cloned, the change-flag is reset, and the create-flag is set. All listeners are also removed! The new cloned property is an orphan, i.e. has no parent set. All children properties are also (deep) cloned.

      Note that the cloning process is done WITHOUT thread synchronization for performance reasons, thus no modifications should be done to the tree!

      Overrides:
      clone in class UIComp

    • addPredefinedProps

      protected void addPredefinedProps() throws PropException
      Adds the predefined properties for this container. This method is called once just after construction of the property container and sometimes population of it.

      This implementation creates the UIComps property named Atom.COMPONENTS for the UI components, and saves the reference to it for fast access.

      Overrides:
      addPredefinedProps in class PropCnr
      Throws:
      PropException - For property exceptions.

    • addPredefinedPropsImpl

      protected void addPredefinedPropsImpl() throws PropException
      Adds the predefined containers for identifications, fields and actions. This method is overridden fully by the Editor versions of the class.
      Throws:
      PropException - For property exceptions.

    • getPredefinedProps

      public void getPredefinedProps()
      Adds the predefined containers for identifications, fields and actions. This method is overridden fully by the Editor versions of the class.
      Overrides:
      getPredefinedProps in class UIComp

    • updateUICompsReference

      protected void updateUICompsReference()
      Updates the reference to the UIComps instance named Atom.COMPONENTS, used when cloning and for the panel part container (or any time the UIComps instance has been changed).

    • resetComponentID

      public void resetComponentID()
      Resets the component ID, typically when copied or saved in order to add make copies of the (some) component data. The operation is recursive.
      Overrides:
      resetComponentID in class UIComp

    • onVirtualContainerCreated

      protected final void onVirtualContainerCreated()
      Called when a property container has been virtualized because it was added into another property container that was virtualized, and this container was not. Typically, UI and VS will issue a onUICreate or onVSCreate.
      Overrides:
      onVirtualContainerCreated in class PropCnr

    • invokeOnUICreateTree

      protected final void invokeOnUICreateTree(UIPanelBase panel)
      Invokes the onUICreate method for the component if a panel is present. This method should only be invoked when a component is resolved during the post-resolve virtualization process, or when a component is added into an already virtualized UI component tree.

      The OnCreate method is called first for the parents, then its children recursively.

      Overrides:
      invokeOnUICreateTree in class UIComp
      Parameters:
      panel - The panel in which the component is a child of (or the panel itself).
      Throws:
      NullPointerException - If the panel is null.

    • hasImplicitAlignFillX

      public boolean hasImplicitAlignFillX()
      Returns if the container has implicit component horizontal fill.

      The default behavior is to forward the reply to LayoutMgr.hasImplicitAlignFillX().

      Overrides:
      hasImplicitAlignFillX in class UIComp
      Returns:
      true means component will always fill the space in X, false otherwise.

    • hasImplicitAlignFillY

      public boolean hasImplicitAlignFillY()
      Returns if the container has implicit component vertical fill.

      The default behavior is to forward the reply to LayoutMgr.hasImplicitAlignFillY().

      Overrides:
      hasImplicitAlignFillY in class UIComp
      Returns:
      true means component will always fill the space in Y, false otherwise.

    • getDeviceType

      public int getDeviceType()
      Gets the device type: -1=mobile, 0=both, 1=desktop.
      Specified by:
      getDeviceType in interface IUIComp

    • isMobileContextMenuSupported

      public boolean isMobileContextMenuSupported()
      Returns if the component can show the context menu in mobile mode.
      Specified by:
      isMobileContextMenuSupported in interface IUIContextMenuOwner
      Returns:
      Container component does not by default supports context menus for mobile.

    • createCompsCnr

      public UIComps createCompsCnr()
      Creates the components for the Editor.

    • getCompsCnr

      public UIComps getCompsCnr()
      Gets the container associated with this layout manager and the UI container.
      Specified by:
      getCompsCnr in interface IUIContainer
      Returns:
      The UI components container.

    • getComponents

      public UIComp[] getComponents()
      Gets the UI components of the container.
      Specified by:
      getComponents in interface IUIContainer
      Returns:
      The array of components, always non-null.

    • getComponentCount

      public int getComponentCount()
      Gets the UI component count.
      Specified by:
      getComponentCount in interface IUIContainer
      Returns:
      The UI component count.

    • isEmptyContainerAllowed

      public boolean isEmptyContainerAllowed()
      Returns whether the container should have children in a normal conditions, i.e. a warning message should be displayed in the Designer when it is empty. This is intended to be used to avoid use of empty containers. Some containers, e.g. the mobile heading is allowed to be empty.
      Returns:
      false (default) not to allow empty container, true otherwise.

    • doIssueEmptyContainerWarning

      public boolean doIssueEmptyContainerWarning()
      Returns whether the container should have children in a normal conditions, i.e. a warning message should be displayed in the Designer when it is empty. This is intended to be used to avoid use of empty containers. Some containers, e.g. the mobile heading is allowed to be empty.
      Returns:
      false (default) not to allow empty container, true otherwise.

    • getRadioSelectionComponents

      public UIComp[] getRadioSelectionComponents(String groupName)
      Gets the components being part of the selection group specified. Each component returned implements the this IRadioComponent interface.
      Specified by:
      getRadioSelectionComponents in interface IUIContainer
      Parameters:
      groupName - The group name, possibly null (for default).
      Returns:
      An array of the selection components.

    • getSelectedRadioComponent

      public UIComp getSelectedRadioComponent(String groupName)
      Gets the currently selected radio component in the group.
      Specified by:
      getSelectedRadioComponent in interface IUIContainer
      Parameters:
      groupName - The group name, possibly null.
      Returns:
      The selected radio component, null for none.

    • setRadioSelectionComponent

      public boolean setRadioSelectionComponent(IUIRadioComponent radioComponent, boolean isSelected)
      Sets the selection to the specified radio component.
      Specified by:
      setRadioSelectionComponent in interface IUIContainer
      Parameters:
      radioComponent - The radio-interface-implementing (interface IUIRadioComponent component.
      isSelected - The selection state.
      Returns:
      true if at least one change occurred, false for none.

    • canAcceptUIContainerFocus

      public String canAcceptUIContainerFocus()
      Returns if this container can accept focus itself or for one of its children components. If this is a component and not a container, this request is redirected to the parent container.

      This method recurses up to the topmost UI container, and all containers must return null for this method to return null.

      Typically, a container returns itself as instance if it is disabled or hidden.

      Specified by:
      canAcceptUIContainerFocus in interface IUIComp
      Overrides:
      canAcceptUIContainerFocus in class UIComp
      Returns:
      null if this container (or parent container if this is a component) and all containers up to the topmost level returns null, otherwise the container that did not accept focus.

    • setUIContainerFocus

      public String setUIContainerFocus(UIComp requestor, boolean doAnimate)
      Sets the focus to the UI container and all its parents. This method is called when focus is to be set to a component, making it possible for containers such as accordion/swap/tab to change its main container into view.

      Subclasses must override this method to process it, but make sure to call super.setUIContainerFocus(requestor) first!

      Specified by:
      setUIContainerFocus in interface IUIComp
      Overrides:
      setUIContainerFocus in class UIComp
      Parameters:
      requestor - The requestor is a child to this container.
      doAnimate - Flag to enable animation when selection is changed for e.g. accordion, swap or tab containers.
      Returns:
      null for success, otherwise an error message why it failed.

    • getVSStateFocus

      public final VSComponent getVSStateFocus()
      Gets the VS component for state and focus of this container.
      Overrides:
      getVSStateFocus in class UIComp
      Returns:
      The component (generally a VS Group), null if none is set.

    • getFirstContainerVSStateFocus

      public VSComponent getFirstContainerVSStateFocus()
      Gets the first VS component encountered for state and focus of this container or in the parent tree up to the panel level.
      Overrides:
      getFirstContainerVSStateFocus in class UIComp
      Returns:
      The component (generally a VS Group), null if none is set.

    • onResolved

      public void onResolved(VSComponentReference reference, VSComponent component)
      Called when the property reference has been resolved. UI components use this method to set its state according to the VS component.
      Specified by:
      onResolved in interface IVSGenericComponentListener
      Parameters:
      reference - The VSComponentReference instance holding the component reference.
      component - The VS component reference that is now resolved.

    • onBroken

      public void onBroken(VSComponentReference reference, VSComponent component)
      Called when the property reference has been broken, i.e. unresolved.
      Specified by:
      onBroken in interface IVSGenericComponentListener
      Parameters:
      reference - The VSComponentReference instance holding the component reference.
      component - The VS component reference that is now unresolved.

    • onStateChanged

      public void onStateChanged(VSComponent component, IVSComponentState.State state, boolean on)
      Called when the VS component changes state.
      Specified by:
      onStateChanged in interface IVSGenericComponentListener
      Parameters:
      component - The VS component.
      state - The state change.
      on - New state.

    • onVSComponentSelectionChanged

      protected void onVSComponentSelectionChanged(boolean on)
      Called when the VS component has its selected state changed. By default, the parent container is verified for selection support. These are typically accordion, swap, tab containers.
      Parameters:
      on - The selected state.

    • onComponentSelectedInParent

      public void onComponentSelectedInParent(boolean on)
      Called by the parent container to inform that this component has been selected in its container. The containers that call this method are typically accordion, swap and tab containers.

      The container processes this method by selecting the VSComponent for state and focus that may be connected.

      Overrides:
      onComponentSelectedInParent in class UIComp
      Parameters:
      on - The selection state.

    • onSelectionChanged

      protected void onSelectionChanged(GEvent event)
      Method called when the selection of the component changed due to a property change (value changed, property added or removed).
      Overrides:
      onSelectionChanged in class UIComp
      Parameters:
      event - The event that causes the selection change.

    • onSelectionChanged

      protected void onSelectionChanged(boolean on)
      Called when the container is selected as the current container in an index-based single-selection container such as accordion, swap and tab containers.

    • verify

      public boolean verify(PropVerification verification)
      Verifies this property container. The check performed is the extension of classes and that no circular reference is present.
      Specified by:
      verify in interface IGProp<GProp<?>[]>
      Overrides:
      verify in class UIComp
      Parameters:
      verification - The property verification class.
      Returns:
      true if verification should proceed, false if disposed of and verification should not take place.

    • verifyComponentScope

      protected boolean verifyComponentScope(UIContainer scopeContainer, String what, PropVerification verification, VSComponent vsOuter)
      Verifies that this component has it's VS references inside the outer VS reference.
      Overrides:
      verifyComponentScope in class UIComp
      Parameters:
      scopeContainer - The scope container.
      what - What the scope container is.
      verification - The property verification class.
      vsOuter - The outer VS parent.
      Returns:
      true if OK, false if somehow outside.

    • getUIComponent

      public <COMP extends UIComp> COMP getUIComponent(@UIRef String uiPath, Class<COMP> uiClass) throws NotFoundException
      Gets a UI component with relative reference from this container.

      Note: A UI path is not the same as a property path, it omits the UI container UIComps instance from the path.

      Note 2: If the path is empty, "this" component is returned if the component class uiClass matches, otherwise NotFoundException is thrown.

      Parameters:
      uiPath - The UI path for the component.
      uiClass - The UI class of the component.
      Returns:
      The component, never null.
      Throws:
      NotFoundException - The not-found exception is thrown if the component is not found instead of returning null.

    • getUIComponentNull

      public <COMP extends UIComp> COMP getUIComponentNull(@UIRef String uiPath, Class<COMP> uiClass)
      Gets a UI component with relative reference from this container.

      Note: A UI path is not the same as a property path, it omits the UI container UIComps instance from the path.

      Note 2: If the path is empty, "this" component is returned if the component class uiClass matches, otherwise null is returned.

      Parameters:
      uiPath - The UI path for the component.
      uiClass - The UI class of the component.
      Returns:
      The component, or null if not found.

    • getFirstUIComponent

      public <COMP extends UIComp> COMP getFirstUIComponent(String name, Class<COMP> uiClass) throws NotFoundException
      Gets the first UI component of the specified name and UI class. The search for the component is done from this container and its children containers.
      Specified by:
      getFirstUIComponent in interface IUIComp
      Parameters:
      name - The name of the component.
      uiClass - The UI class of the component.
      Returns:
      The component, never null.
      Throws:
      NotFoundException - The not-found exception is thrown if the component is not found instead of returning null.

    • getFirstUIComponentNull

      public <COMP extends UIComp> COMP getFirstUIComponentNull(String name, Class<COMP> uiClass)
      Gets the first UI component of the specified name and UI class. The search for the component is done from this container and its children containers.
      Specified by:
      getFirstUIComponentNull in interface IUIComp
      Parameters:
      name - The name of the component.
      uiClass - The UI class of the component.
      Returns:
      The component, or null if not found.

    • mustHaveWidth

      public boolean mustHaveWidth()
      Does this component requires a width?
      Overrides:
      mustHaveWidth in class UIComp
      Returns:
      true if the width must be defined and non-zero, false otherwise.

    • mustHaveHeight

      public boolean mustHaveHeight()
      Does this component requires a height.
      Overrides:
      mustHaveHeight in class UIComp
      Returns:
      true if the height must be defined and non-zero, false otherwise.

    • getApproximateSize

      public Size getApproximateSize()
      Returns the size of the component in pixels. The size is a calculation and does not exactly reflect the real size that may be different due to additional styles not taken into account by this method. The size is calculated from the font of the component and default or defined values (such as character length or number of lines for text area).
      Specified by:
      getApproximateSize in class UIComp
      Returns:
      The size of the component: 300x200.