Launch a dialog, optionally raising it in a new dialog window.
The dialog will receive a new pageFlowScope
map, which includes all the values of the currently available pageFlowScope as well as a set of properties passed to this function in the dialogParameters
map. Changes to this newly created scope will not be visible once the dialog returns.
@param dialogRoot the UIViewRoot for the page being launched
@param dialogParameters a set of parameters to populate thenewly created pageFlowScope
@param source the UIComponent that launched the dialog andshould receive the {@link org.apache.myfaces.trinidad.event.ReturnEvent}when the dialog is complete.
@param useWindow if true, use a popup window for the dialogif available on the current user agent device
@param windowProperties the set of UI parameters used tomodify the window, if one is used. The set of properties that\ are supported will depend on the RenderKit
, but common examples include "width", "height", "top" and "left".