%ZEN.Dialog.standardDialog
abstract class %ZEN.Dialog.standardDialog extends %ZEN.Component.page
This base class provides a standard template for the dialog pages provided by Zen. The various dialog pages are implemented as subclasses of this class.To create a new dialog based on this class:
- Create a subclass of this class.
- Define an XData block named dialogBody.
- Within this XData block define the contents of the dialog using a pane component as the container.
- Override the %OnGetTitle() to provide the dialog title.
- Override the %OnGetSubtitle() to provide the dialog subtitle.
- Override the getDialogValue() to supply the return value for the dialog.
- Override the APPLYBUTTON if the dialog has an apply button.
Property Inventory
Method Inventory
- %DrawTitle()
- %OnGetSubtitle()
- %OnGetTitle()
- %OnUseSoftModals()
- adjustSize()
- btnApply()
- btnOK()
- ctrlKeyDown()
- dialogApply()
- dialogCancel()
- dialogFinish()
- dialogTitleGet()
- disableButtons()
- getDialogValue()
- ondialogCancel()
- ondialogFinish()
- ondialogStart()
- onlayoutHandler()
Parameters
parameter APPLYBUTTON = 0;
If true, then this dialog displays an Apply button.
parameter CANCELBUTTON = 1;
If true, then this dialog displays a Cancel button.
parameter DOMAIN = %ZEN;
Inherited description: Localization domain
parameter FAVORITEICON = portal/sysoperate.ico;
SMP favorite icon.
Properties
property dialogTitle as %ZEN.Datatype.string [ ReadOnly ];
Provide a title for the dialog window. The value is supplied
by the %OnGetTitle() method.
Property methods: dialogTitleDisplayToLogical(), dialogTitleIsValid(), dialogTitleLogicalToDisplay(), dialogTitleLogicalToOdbc(), dialogTitleNormalize()
property disabledStyle as %ZEN.Datatype.style [ InitialExpression = "background-image:none;background:#D0D0D0;" ];
Style applied to buttons when automatically disabled.
Property methods: disabledStyleDisplayToLogical(), disabledStyleGet(), disabledStyleIsValid(), disabledStyleLogicalToDisplay(), disabledStyleLogicalToOdbc(), disabledStyleNormalize(), disabledStyleSet()
property hideApplyButton as %ZEN.Datatype.boolean [ Final , InitialExpression = '+..#APPLYBUTTON ];
This is used to indicate whether this dialog has an apply button.
Property methods: hideApplyButtonDisplayToLogical(), hideApplyButtonGet(), hideApplyButtonIsValid(), hideApplyButtonLogicalToDisplay(), hideApplyButtonLogicalToOdbc(), hideApplyButtonLogicalToXSD(), hideApplyButtonNormalize(), hideApplyButtonSet(), hideApplyButtonXSDToLogical()
property hideCancelButton as %ZEN.Datatype.boolean [ InitialExpression = '+..#CANCELBUTTON ];
This is used to indicate whether this dialog has a cancel button.
Property methods: hideCancelButtonDisplayToLogical(), hideCancelButtonGet(), hideCancelButtonIsValid(), hideCancelButtonLogicalToDisplay(), hideCancelButtonLogicalToOdbc(), hideCancelButtonLogicalToXSD(), hideCancelButtonNormalize(), hideCancelButtonSet(), hideCancelButtonXSDToLogical()
Methods
Provide HTML for html title box.
Default implementation displays the standard Zen title bar.
Default implementation displays the standard Zen title bar.
method %OnGetSubtitle() as %String
Get the (localized) subtitle string for the dialog.
This should be implemented in a subclass.
method %OnGetTitle() as %String
Get the (localized) title string for the dialog.
This should be implemented in a subclass.
classmethod %OnUseSoftModals() as %Boolean
Use soft modals for dialogs.
clientmethod adjustSize() [ Language = javascript ]
Adjust size and position of components on this page.
final clientmethod btnApply() [ Language = javascript ]
This method is no longer supported by standardDialog so
make sure it does not get used.
final clientmethod btnOK() [ Language = javascript ]
This method is no longer supported by standardDialog so
make sure it does not get used.
clientmethod ctrlKeyDown(evt, escOnly) [ Language = javascript ]
Key handler used by many controls in dialogs. Defined here for convenience.
To use, add an onkeydown handler to controls in your dialog:
If the user presses ESCAPE within this control, the dialog is cancelled. If the user
presses ENTER, then the dialog is completed (same as pressing OK).
If escOnly is true, then only the ESC key is processed. This is useful for
controls where the ENTER key is needed (such as a textarea).
To use, add an onkeydown handler to controls in your dialog:
<text label="Name" onkeydown="return zenPage.ctrlKeyDown(zenEvent);"/>
clientmethod dialogApply() [ Language = javascript ]
Apply the value for this dialog and keep it open.
Do not overide, instead implement the ondialogFinish method.
clientmethod dialogCancel() [ Language = javascript ]
Close this dialog without applying its value.
Do not overide, instead implement the ondialogCancel method.
clientmethod dialogFinish() [ Language = javascript ]
Apply the value for this dialog and close it.
Do not overide, instead implement the ondialogFinish method.
method dialogTitleGet() as %ZEN.Datatype.string
Get value for dialogTitle property.
clientmethod disableButtons(flag) [ Language = javascript ]
Disable or enable the apply,cancel, and ok buttons for this dialog.
clientmethod getDialogValue() [ Language = javascript ]
Get the value that will be applied when the user presses the OK button.
This is implemented by subclasses.
abstract clientmethod ondialogCancel() [ Language = javascript ]
This callback, if defined, is called when the user presses the Cancel button.
If this returns false, then the dialog is not cancelled.
abstract clientmethod ondialogFinish(action) [ Language = javascript ]
This callback, if defined, is called when the user presses the OK or Apply action buttons.
If this returns false, then the action is cancelled.
abstract clientmethod ondialogStart() [ Language = javascript ]
This callback, if defined, is called when the dialog page is loaded.
final clientmethod onlayoutHandler(load) [ Language = javascript ]
This client event, if present, is fired when the page
is first loaded or whenever it is resized.
If this is called at load time, then load will be true.
If this is called at load time, then load will be true.
Inherited Members
Inherited Properties
- %condition
- %import
- %includeFiles
- %page
- %resource
- align
- aux
- backgroundTimerInterval
- cellAlign
- cellSize
- cellStyle
- cellVAlign
- children
- composite
- containerStyle
- cssLevel
- disabled
- dragAndDrop
- dragEnabled
- dropEnabled
- enclosingClass
- enclosingStyle
- error
- groupClass
- groupStyle
- height
- hidden
- hint
- hintClass
- hintStyle
- id
- index
- label
- labelClass
- labelDisabledClass
- labelPosition
- labelStyle
- layout
- name
- onafterdrag
- onbeforedrag
- onclick
- ondrag
- ondrop
- onhide
- onrefresh
- onshow
- onupdate
- parent
- showLabel
- slice
- title
- tuple
- useSVG
- useSoftModals
- valign
- visible
- width
- window
- zenPersistentPopup
Inherited Methods
- %AddChild()
- %AddChildAfter()
- %AddChildBefore()
- %AddComponent()
- %AddImportedComponents()
- %AddToSaveSet()
- %ApplyURLParms()
- %Attr()
- %BindExport()
- %ClassIsLatestVersion()
- %ClassName()
- %ConstructClone()
- %DispatchClassMethod()
- %DispatchGetModified()
- %DispatchGetProperty()
- %DispatchMethod()
- %DispatchSetModified()
- %DispatchSetMultidimProperty()
- %DispatchSetProperty()
- %DrawAutoLogout()
- %DrawClassDefinitions()
- %DrawComponentHTML()
- %DrawHTML()
- %DrawHTMLPage()
- %DrawJSStrings()
- %DrawObjectDefinitions()
- %EnclosingDivId()
- %EndBackgroundMethod()
- %EndScript()
- %Eval()
- %EvalC()
- %Extends()
- %ForceClientRender()
- %GetChildIndex()
- %GetComponent()
- %GetComponentById()
- %GetComponentByName()
- %GetEventHandlers()
- %GetLinks()
- %GetPageName()
- %GetParameter()
- %GetValueById()
- %GetValueByName()
- %GetXMLName()
- %IsA()
- %IsModified()
- %Link()
- %LinkCSS()
- %LinkScript()
- %MakeId()
- %New()
- %NormalizeObject()
- %ObjectModified()
- %OnAddToPageAfter()
- %OnAddToPageBefore()
- %OnAfterCreatePage()
- %OnBeforeCreatePage()
- %OnCreateApplication()
- %OnCreatePage()
- %OnDetermineCSSLevel()
- %OnDrawEnclosingDiv()
- %OnDrawHTMLBody()
- %OnDrawHTMLHead()
- %OnDrawHTMLMeta()
- %OnDrawObjectProperties()
- %OnFinishBackgroundTask()
- %OnMonitorBackgroundTask()
- %OnMutateChildren()
- %OnObjectSynch()
- %OnPreHTTP()
- %OnSubmit()
- %OnZENDeserialize()
- %OriginalNamespace()
- %PackageName()
- %QuoteValue()
- %QuoteValueL10N()
- %RemoveChild()
- %RemoveChildren()
- %RemoveComponent()
- %RemoveFromSaveSet()
- %RunBackgroundMethod()
- %Self()
- %SerializeObject()
- %SetBackgroundMethodStatus()
- %SetErrorById()
- %SetErrorByName()
- %SetModified()
- %SetValueById()
- %SetValueByName()
- %SetValuesByName()
- %StartScript()
- %ValidateObject()
- %ZENVersion()
- ConvertParameter()
- Decrypt()
- Encrypt()
- EscapeHTML()
- EscapeURL()
- HyperEventCall()
- HyperEventHead()
- Include()
- InsertHiddenField()
- InsertHiddenFields()
- IsPrivate()
- Link()
- OnHTTPHeader()
- OnPage()
- OnPageError()
- OnPostHTTP()
- OnPostHyperEvent()
- OnPreHTTP()
- OnPreHyperEvent()
- Page()
- QuoteJS()
- RewriteURL()
- ShowError()
- StartTimer()
- StopTimer()
- ThrowError()
- UnescapeHTML()
- UnescapeURL()
- XMLDTD()
- XMLExport()
- XMLExportToStream()
- XMLExportToString()
- XMLNew()
- XMLSchema()
- XMLSchemaNamespace()
- XMLSchemaType()
- addChild()
- addChildAfter()
- addChildBefore()
- cancelPopup()
- childrenMutated()
- correctIELayering()
- createComponent()
- createComponentNS()
- deleteComponent()
- dragFinishHandler()
- dragHandler()
- dragNotifyHandler()
- dragStartHandler()
- dropHandler()
- dropStartHandler()
- endModal()
- exposeComponent()
- findElement()
- fireOnResizeEvent()
- fireOnUnloadEvent()
- fireOnUpdateEvent()
- firePopupAction()
- getChildIndex()
- getComponent()
- getComponentById()
- getEnclosingDiv()
- getHidden()
- getHintElement()
- getLabelElement()
- getOpener()
- getProperty()
- getSettings()
- getType()
- gotoPage()
- invokeSuper()
- isOfType()
- launchPopupWindow()
- makeId()
- onCreate()
- onDelete()
- onDisplayHandler()
- onEndModalHandler()
- onPopupAction()
- onRefreshContents()
- onSerialize()
- onServerMethodCall()
- onServerMethodError()
- onServerMethodReturn()
- onStartModalHandler()
- ondisabledHandler()
- onkeydownHandler()
- onkeyupHandler()
- onloadHandler()
- onlogoutHandler()
- onoverlayHandler()
- onresizeHandler()
- onunloadHandler()
- onupdateHandler()
- popupActionHandler()
- refreshContents()
- removeChild()
- render()
- renderContents()
- renderSVG()
- setComponentId()
- setHidden()
- setOverlayMode()
- setProperty()
- setPropertyAll()
- setTraceOption()
- startModal()
- startProgressBar()
- stopProgressBar()
Subclasses
- %CSP.Portal.SourceControl.Dialog.ServerOutput
- %CSP.Portal.standardDialog
- %DeepSee.Report.UI.NewReportWizard
- %DeepSee.Report.UI.PageSetUpDialog
- %DeepSee.UI.Dialog.standardDialog
- %ZEN.Dialog.classSelect
- %ZEN.Dialog.colorSelect
- %ZEN.Dialog.componentValueEditor
- %ZEN.Dialog.confirmationDialog
- %ZEN.Dialog.cssDeclarationEditor
- %ZEN.Dialog.cssValueEditor
- %ZEN.Dialog.errorDialog
- %ZEN.Dialog.fileSelect
- %ZEN.Dialog.finderDialog
- %ZEN.Dialog.namespaceSelect
- %ZEN.Dialog.qualifierSelect
- %ZEN.Dialog.routineSelect
- %ZEN.Dialog.searchDialog
- %iKnow.UI.Dialog.buildDomain
- %iKnow.UI.Dialog.compileDomain