Class UIPanelBase

Method Details

• getPredefinedProps

  public void getPredefinedProps()

  Gets potential references to predefined properties for this container. This method is called once just after cloning of the property container.

  The method should get reference to using the getProp(...) methods. This allows the subclass to be able to retrieve the new instances to the properties created during addPredefinedProps() if stored in instance variables.

  Subclasses must override this method to do the appropriate initialization, as this method does nothing for the PropCnr class implementation.

  Overrides:

  getPredefinedProps in class UIContainer

• createLayout

  protected PanelData createLayout()

  Create the layout property.

  Returns:

  A new instance of EPanelData named Atom.LAYOUT.

• getLayout

  public PanelData getLayout()

  Gets the layout properties of this component. If the properties are not present, they are created.

  Specified by:

  getLayout in interface IUIComp

  Overrides:

  getLayout in class UIComp

  Returns:

  The layout properties.

• shouldCreateProps

  protected boolean shouldCreateProps(Element element)

  Checks if a child Element should be created as properties or if it should be skipped. Override this method (and call super.shouldCreateProps(element)) if the container creates other child elements.

  Overrides:

  shouldCreateProps in class PropCnr

  Parameters:

  element - The element in question.

  Returns:

  true to create properties out of it, false to ignore the element.

• clone

  public UIPanelBase 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 UIContainer

• onPropDispose

  protected void onPropDispose()

  Called when a property is disposed of by delete/remove in a container, or by the dispose method.

  This call is done just at the end of the delete/remove routine in the container, without synchronization.

  During this call, whatever components that e.g. the client needs to disposed of is done.

  Subclasses needing to perform some intelligent operations upon deletion should do it by overloading this method and always call the super.onPropDispose() method.

  Overrides:

  onPropDispose in class UIComp

• virtualize

  public UIPanelBase virtualize(IAppSessionGyro appGyro, IClientSessionGyro clientGyro, VirtualSpace virtualSpace) throws CloneNotSupportedException, PropException

  Call this method to "virtualize" a property tree. This method is used at runtime in the Server for the application session of virtual instances of VirtualSpace, but also virtual instances of panels, for the individual client session. The VirtualSpace is virtualized once for the application session and is shared for parallel client sessions.

  This method is similar to cloning, but enables references that are already resolved to remain if they point to a shared instance, e.g. the VirtualSpace pointing to its participants in the application property container shared instance, or a panel with references to text IDs, assets, etc.

  It is up to the property class to handle this by overriding this method.

  Overrides:

  virtualize in class PropCnr

  Parameters:

  appGyro - The application gyro instance performing the virtualization.

  clientGyro - The client gyro session, can be null if not initialized from the client gyro.

  virtualSpace - The virtualized or virtualizing VirtualSpace.

  Returns:

  The virtualized property.

  Throws:

  CloneNotSupportedException - If a subclass doesn't allow cloning, e.g. the client properties.

  PropException - For property errors during the virtualization.

• getNonVirtualized

  public UIPanelBase getNonVirtualized()

  Gets the non-virtualized instance of this panel.

  Returns:

  The non-virtualized panel, always non-null.

• getAppSessionGyro

  public IAppSessionGyro getAppSessionGyro()

  Returns the Application Session Gyro instance of this virtualized property.

  Specified by:

  getAppSessionGyro in interface IGProp<GProp<?>[]>

  Overrides:

  getAppSessionGyro in class GProp<GProp<?>[]>

  Returns:

  The Application Session Gyro if this instance is virtualized, null otherwise.

• getClientSessionGyro

  public IClientSessionGyro getClientSessionGyro()

  Returns the Client Session Gyro instance of this virtualized property. This method only work for properties in a panel tree. Data connectors may sometimes also provide IClientSessionGyro support.

  To get the IClientSessionGyro instance from the current thread use IClientSessionGyro.getSessionInstance(), or IClientSessionGyro.getSessionInstance(SessionInfo) to get it from the session information instance.

  Specified by:

  getClientSessionGyro in interface IGProp<GProp<?>[]>

  Overrides:

  getClientSessionGyro in class GProp<GProp<?>[]>

  Returns:

  The Client Session Gyro if this instance is virtualized and is in a UIPanelBase (panels) tree (or for certain data connectors), null otherwise.

• onVirtualizationCompleted

  protected final void onVirtualizationCompleted(IAppSessionGyro appGyro, IClientSessionGyro clientGyro, VirtualSpace virtualSpace, boolean isPostResolve)

  Called when virtualization completed.

  This method is called to the entire tree of the newly virtualized property container.

  Overrides:

  onVirtualizationCompleted in class PropCnr

  Parameters:

  appGyro - The application gyro instance performing the virtualization.

  clientGyro - The client gyro session, can be null if not initialized from the client gyro.

  virtualSpace - The virtualized VirtualSpace.

  isPostResolve - Flag indicating this call is done after references are attempted to be resolved.

• getPanelOwner

  public final UIPanelBase getPanelOwner()

  Gets the panel owner.

  Specified by:

  getPanelOwner in interface IUIPanelOwner

  Returns:

  The panel itself.

• isPopupPanel

  public boolean isPopupPanel()

  Returns if this is a pop-up panel placed on top of main panels.

  Returns:

  The default panel returns false.

• getPropBaseReference

  public PropCnr getPropBaseReference()

  The panel is the base component base reference.

  Specified by:

  getPropBaseReference in interface IGProp<GProp<?>[]>

  Overrides:

  getPropBaseReference in class PropCnr

  Returns:

  This UIPanelBase instance.

• getDeviceType

  public int getDeviceType()

  Gets the device type: -1=mobile, 0=both, 1=desktop.

  Specified by:

  getDeviceType in interface IUIComp

  Overrides:

  getDeviceType in class UIContainer

• getVSReference

  public VSParticipant getVSReference(Atom refAtom)

  Gets a VSReference instance from the container or any parent containers. The method is used by VSRelativeReference to look up the VSReference instance in order to resolve the relative path to the target property.

  Specified by:

  getVSReference in interface IGProp<GProp<?>[]>

  Overrides:

  getVSReference in class PropCnr

  Parameters:

  refAtom - The property atom of the requesting relative reference property.

  Returns:

  The instance of the VSParticipant (that extends VSReference) or null if unassigned.

• createVSReference

  public VSParticipant createVSReference(Atom refAtom, PropCnr[] returnParent)

  Creates a VSReference instance from the container or any parent containers. The method is used in the Designer to create a VirtualSpace connection for VSRelativeReference to look up the VSReference instance in order to resolve the relative path to the target property.

  This method needs to be overridden by subclasses of PropCnr that has a VSReference as property, and *SHOULD* match getVSReference(Atom).

  The default is to re-target the call to the parent container, and if the root, a folder or a file property is reached, null is returned.

  Overrides:

  createVSReference in class PropCnr

  Parameters:

  refAtom - The property asking for the VSReference.

  returnParent - An array of PropCnr [1] that will be filled in with the parent property of the VSRefernce.

  Returns:

  The instance of the VSReference or null if unassigned. The returned instance could also be a VSParticipant and should therefore be processed accordingly.

  For this method, it's a VSParticipant.

• getVSParticipant

  public VSParticipant getVSParticipant()

  Gets the VSParticipant instance. This is also an instance of VSReference.

  Specified by:

  getVSParticipant in interface IUIPanelOwner

  Returns:

  The instance of the VSParticipant, or null if not yet defined.

• getVirtualSpace

  public VirtualSpace getVirtualSpace()

  Gets the VirtualSpace for this panel.

  Method for IVSParticipant: Gets the referrer's back-reference to the VirtualSpace. This is used by the VSParticipantReference when verifying its references.

  Specified by:

  getVirtualSpace in interface IUIComp

  Specified by:

  getVirtualSpace in interface IVSAccessor

  Overrides:

  getVirtualSpace in class UIComp

  Returns:

  The VirtualSpace, or null for none.

• getParticipantDescription

  public String getParticipantDescription()

  Returns the given description of the referrer participant.

  Specified by:

  getParticipantDescription in interface IReferrerParticipant

  Returns:

  The string the Designer entered in the Description field, or "n/a" for none.

• getParticipantType

  public String getParticipantType()

  Returns the given type of the referrer participant.

  Specified by:

  getParticipantType in interface IReferrerParticipant

• isPrimaryParticipant

  public boolean isPrimaryParticipant()

  Checks if this panel is primary or not. A primary participant is chosen in the selection processing when multiple participants are ordered in a VSParticipantsHolder container.

  Specified by:

  isPrimaryParticipant in interface IReferrerParticipant

  Returns:

  The default implementation returns true.

• getGroupID

  public int getGroupID(GroupNameProp groupName)

  Gets the unique ID for a group name.

  Specified by:

  getGroupID in interface IUIGroupSeparator

  Parameters:

  groupName - The group name. Return The unique for the group name.

• onPrepare

  protected void onPrepare(IAppOwner appOwner, IModuleOwner moduleOwner, boolean isPostCall, List<Throwable> errors) throws PropException

  Called when the application is being prepared. The order of onPrepare calls is always parent first, the children. The method is called twice, first time with isPostCall set to false, then a second time with true.

  Overrides:

  onPrepare in class UIComp

  Parameters:

  appOwner - The application owner.

  moduleOwner - The Module owner.

  isPostCall - Flag indicating this is a post-call.

  errors - A list of errors that occurred but did not cause an abort.

  Throws:

  PropException - For property errors during the application preparation to need to abort.

• invokeOnUIConnectMethod

  public void invokeOnUIConnectMethod(IClientSessionGyro clientGyro)

  Invoke the create event methods of the component and the panel.

  This method is not intended to be called, it is used by the framework.

  Parameters:

  clientGyro - The client gyro.

• invokeOnUIFocusMethod

  protected void invokeOnUIFocusMethod(boolean isFocusGained, UIComp component, UIComp opposite, IGProp<?> trigger)

  Invoke the focus event methods of the component and the panel.

  This method is not intended to be called, it is used by the UI focus engine.

  Parameters:

  isFocusGained - Flag for focus gained operation.

  component - The UI component.

  opposite - The opposite UI component.

  trigger - The trigger property.

• invokeOnUITextChangeMethod

  public void invokeOnUITextChangeMethod(UIComp component, GProp<?> trigger)

  Invoke the onUITextChange event methods of the component and the panel.

  Parameters:

  component - The UI component.

  trigger - The trigger property.

• invokeOnUIValueChangeMethod

  public void invokeOnUIValueChangeMethod(UIComp component, GProp<?> trigger)

  Invoke the onUIValueChange event methods of the component and the panel.

  Parameters:

  component - The UI component.

  trigger - The trigger property.

• invokeOnUISelectionMethod

  public void invokeOnUISelectionMethod(IUISelectionComp source, GProp<?> trigger, IUISelection selection)

  Invoke the focus event method.

  Parameters:

  source - The selection UI component source.

  trigger - The trigger, null for none.

  selection - The selection.

• isParticipating

  public final boolean isParticipating(EnvProps envProps)

  Checks if this panel is participating in the VirtualSpace, i.e. if it's used in the current user session or if it's e.g. the wrong resolution or device.

  Specified by:

  isParticipating in interface IReferrerParticipant

  Parameters:

  envProps - The Client Environment instance of the current client connection.

  Returns:

  The participation state, by default true.

• getPanelMappings

  public final VSMappings getPanelMappings()

  Gets the panels components that refer to the VirtualSpace in question, and their mappings to the VSComponent's. Only resolved references are returned.

  The return value is cached, and refreshed when required, i.e. if panel components are added or removed.

  Returns:

  The map of components to a VirtualSpace, null when panel is not mapped to a VirtualSpace.

• onEventSelf

  public void onEventSelf(GEvent event)

  Invalidates cached mappings.

  Specified by:

  onEventSelf in interface IGProp<GProp<?>[]>

  Overrides:

  onEventSelf in class UIComp

  Parameters:

  event - The property event.

• onRemoteEvent

  public void onRemoteEvent(RemoteEvent event)

  Called when a remote property event should be processed by this property.

  A subclass can override this method to perform appropriate processing and is not required to call super.onRemoteEvent(e).

  The onRemoteEvent is NOT called when in a proxied property container, but rather the normal onEventSelf method.

  Specified by:

  onRemoteEvent in interface IGProp<GProp<?>[]>

  Overrides:

  onRemoteEvent in class UIComp

  Parameters:

  event - The remote event.

• isDesktopType

  public boolean isDesktopType()

  Checks if this panel is of desktop type. (For now, this is the same as not mobile type...)

  Returns:

  true if this panel is of desktop type.

• isMobileType

  public boolean isMobileType()

  Checks if this panel is of mobile type.

  Returns:

  true if this panel is of mobile type, i.e. for touch, and using mobile themes.

• isDeviceTypeMatching

  public boolean isDeviceTypeMatching(int deviceType)

  Returns if the device type is compatible with this panel.

  Parameters:

  deviceType - The device type: -1=mobile, 0=both, 1=desktop.

  Returns:

  true for match, false otherwise (also for invalid device type).

• setPanelType

  public boolean setPanelType(IComplexOperation op, int type)

  Sets the panel type, i.e. desktop, mobile or future values.

  Parameters:

  op - The complex operation, or null for none.

  type - 0=desktop, 1=mobile. (For now...)

  Returns:

  true if changed, false otherwise.

  Throws:

  IllegalArgumentException - If type is not 0 or 1.

• getThemes

  public GThemes getThemes()

  Gets the configured themes for the panel.

  Returns:

  The panel themes, or null if not configured.

• 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 UIContainer

  Parameters:

  verification - The property verification class.

  Returns:

  true if verification should proceed, false if disposed of and verification should not take place.

• isAnimationPropPrivate

  public final boolean isAnimationPropPrivate()

  Returns if the animation property is private or not.

  Specified by:

  isAnimationPropPrivate in interface IUIPanelAnimation

  Returns:

  true for actions.

• getDefaultTextTable

  public TextTable getDefaultTextTable()

  Gets the default text table of the panel. This text table may be derived from another base table, and the default input language code can also be checked.

  Returns:

  The default text table, or null if not defined.

• setDefaultTextTable

  public boolean setDefaultTextTable(String ref)

  Sets the default text table to use for the panel.

  Parameters:

  ref - The text table reference, null for none.

  Returns:

  true for changed, false for no change.

• getOnCreateExistingPanelProcessing

  public int getOnCreateExistingPanelProcessing()

  Returns how to process pop-up panels when this panel is virtualized.

  Returns:

  PP_REPLACE_ALL = replace all panels with this one,
  PP_REPLACE_ALL_POPUPS = replace all pop-up panels with this one,
  PP_REPLACE_LAST_POPUP = replace last pop-up panel (if any),
  PP_ADD_PANEL = add this pop-up panel.

  The default processing for main panel is to return PP_REPLACE_ALL.

• requestRemove

  public boolean requestRemove()

  Requests the removal of the panel with the specified animation. This call is not intended to be called elsewhere than from the client Gyro.

  Returns:

  true for success, false if panel is already removed.

• hasBeenRemoved

  public boolean hasBeenRemoved()

  Returns if this panel is being replaced by another, but has not had the time to be removed from the client yet.

• onVirtualSpaceVirtualized

  public void onVirtualSpaceVirtualized(IAppSessionGyro appGyro, VirtualSpace virtualizedVirtualSpace)

  Called when the VirtualSpace has been virtualized, giving the opportunity for e.g. data connectors to prepare it's virtualized counterparts if this is required.

  This call is done to the non-virtualized instance of the VirtualSpace participant.

  Specified by:

  onVirtualSpaceVirtualized in interface IVSParticipant

  Parameters:

  appGyro - The application gyro instance.

  virtualizedVirtualSpace - The virtualized VirtualSpace instance.