Class ModalPopup

java.lang.Object
org.eclnt.jsfserver.defaultscreens.BasePopup
org.eclnt.jsfserver.defaultscreens.ModalPopup
All Implemented Interfaces:
Serializable, Comparable<ModalPopup>

public class ModalPopup extends BasePopup implements Serializable, Comparable<ModalPopup>
Server side management of modal popups. Direct implementations use the static createInstance() method for creating the popup, then hold a reference and work with this reference. - By default you do not use direct implementations, though. E.g. when using page beans (IPageBean) then you create popups via the page bean's method PageBean.openModalPopup(org.eclnt.jsfserver.pagebean.IPageBean, String, int, int, IModalPopupListener).
See Also:
  • Constructor Details

    • ModalPopup

      public ModalPopup()
  • Method Details

    • createInstance

      public static ModalPopup createInstance()
      Direct creation of modal popup. This method of creating a popup is some quite internal way - which is normally not used by application programming. Please use the PageBean-way of opening popups using PageBean.openModalPopup(org.eclnt.jsfserver.pagebean.IPageBean, String, int, int, org.eclnt.jsfserver.defaultscreens.ModalPopup.IModalPopupListener) or PageBean.openModalPopup(org.eclnt.jsfserver.pagebean.IPageBean, String, int, int, IModalPopupListener) instead.
    • close

      public void close()
      Close popup.
      Overrides:
      close in class BasePopup
    • compareTo

      public int compareTo(ModalPopup o)
      Specified by:
      compareTo in interface Comparable<ModalPopup>
    • setHighlightReference

      public void setHighlightReference(boolean highlightReference)
      If set to true then the screen background that is drawn below the popup is built in a way that the component that is directly referenced (e.g. by BasePopup.setLeftTopReferenceComponentIdLeft(String)) is not part of the background - and is highlighted as consequence.
    • getHighlightReference

      public boolean getHighlightReference()
    • setScreenBackgroundColor

      public void setScreenBackgroundColor(String screenBackgroundColor)
      Defines the color of the screen background that is drawn "behind" the modal popup dialog. The default is taken from the CSS style, but you may override e.g. in order to make it transparent or in order to assign a special color.
    • getScreenBackgroundColor

      public String getScreenBackgroundColor()
    • showAsTopPopup

      public void showAsTopPopup()
      Indicate that this is the popup that should be shown on top of other modal popups if two modal popups are opened at same point of time.

      This is the short version of the calling the method showAsTopPopup(boolean) with parameter true.
    • showAsTopPopup

      public void showAsTopPopup(boolean value)
      Same as showAsTopPopup() but now with explicit passing of parameter.

      Why is there a version with explicit passing the value as parameter? ...because the default popups of CaptainCasa (OKPopup, YESNOPopup) automatically requiest to be shown as top popup. In cases you want to reset this, you may call this method with parameter "false".