Class sap.m.DialogModule: sap/m/Dialog

extends Control
implements PopupInterface
known direct subclasses: HierarchicalSelectDialog, P13nDialog, TransportDialog, ValueHelpDialog

The Dialog control is used to interrupt the current processing of an application to prompt the user for information or a response.

Constructor Summary
new sap.m.Dialog(sId?, mSettings?)Constructor for a new Dialog.
Event Summary
afterClose(oControlEvent)This event will be fired after the dialog is closed.
afterOpen(oControlEvent)This event will be fired after the dialog is opened.
beforeClose(oControlEvent)This event will be fired before the dialog is closed.
beforeOpen(oControlEvent)This event will be fired before the dialog is opened.
Events borrowed from class sap.ui.core.Control
validateFieldGroup
Events borrowed from class sap.ui.base.ManagedObject
formatError, modelContextChange, parseError, validationError, validationSuccess
Method Summary
sap.m.Dialog.extend(sClassName, oClassInfo?, FNMetaImpl?)Creates a new subclass of class sap.m.Dialog with name sClassName and enriches it with the information contained in oClassInfo.
sap.m.Dialog.getMetadata()Returns a metadata object for class sap.m.Dialog.
_getAnyHeader()Returns the custom header instance when the customHeader aggregation is set.
addAriaDescribedBy(vAriaDescribedBy)Adds some ariaDescribedBy into the association ariaDescribedBy.
addAriaLabelledBy(vAriaLabelledBy)Adds some ariaLabelledBy into the association ariaLabelledBy.
addButton(oButton)Adds some button to the aggregation buttons.
addContent(oContent)Adds some content to the aggregation content.
attachAfterClose(oData?, fnFunction, oListener?)Attaches event handler fnFunction to the afterClose event of this sap.m.Dialog.
attachAfterOpen(oData?, fnFunction, oListener?)Attaches event handler fnFunction to the afterOpen event of this sap.m.Dialog.
attachBeforeClose(oData?, fnFunction, oListener?)Attaches event handler fnFunction to the beforeClose event of this sap.m.Dialog.
attachBeforeOpen(oData?, fnFunction, oListener?)Attaches event handler fnFunction to the beforeOpen event of this sap.m.Dialog.
close()Close the dialog.
destroyBeginButton()Destroys the beginButton in the aggregation beginButton.
destroyButtons()Destroys all the buttons in the aggregation buttons.
destroyContent()Destroys all the content in the aggregation content.
destroyCustomHeader()Destroys the customHeader in the aggregation customHeader.
destroyEndButton()Destroys the endButton in the aggregation endButton.
destroySubHeader()Destroys the subHeader in the aggregation subHeader.
detachAfterClose(fnFunction, oListener)Detaches event handler fnFunction from the afterClose event of this sap.m.Dialog.
detachAfterOpen(fnFunction, oListener)Detaches event handler fnFunction from the afterOpen event of this sap.m.Dialog.
detachBeforeClose(fnFunction, oListener)Detaches event handler fnFunction from the beforeClose event of this sap.m.Dialog.
detachBeforeOpen(fnFunction, oListener)Detaches event handler fnFunction from the beforeOpen event of this sap.m.Dialog.
fireAfterClose(mArguments?)Fires event afterClose to attached listeners.
fireAfterOpen(mArguments?)Fires event afterOpen to attached listeners.
fireBeforeClose(mArguments?)Fires event beforeClose to attached listeners.
fireBeforeOpen(mArguments?)Fires event beforeOpen to attached listeners.
getAriaDescribedBy()Returns array of IDs of the elements which are the current targets of the association ariaDescribedBy.
getAriaLabelledBy()Returns array of IDs of the elements which are the current targets of the association ariaLabelledBy.
getBeginButton()Gets content of aggregation beginButton.
getButtons()Gets content of aggregation buttons.
getContent()Gets content of aggregation content.
getContentHeight()Gets current value of property contentHeight.
getContentWidth()Gets current value of property contentWidth.
getCustomHeader()Gets content of aggregation customHeader.
getDraggable()Gets current value of property draggable.
getEndButton()Gets content of aggregation endButton.
getHorizontalScrolling()Gets current value of property horizontalScrolling.
getIcon()Gets current value of property icon.
getInitialFocus()ID of the element which is the current target of the association initialFocus, or null.
getResizable()Gets current value of property resizable.
getShowHeader()Gets current value of property showHeader.
getState()Gets current value of property state.
getStretch()Gets current value of property stretch.
getSubHeader()Gets content of aggregation subHeader.
getTitle()Gets current value of property title.
getType()Gets current value of property type.
getVerticalScrolling()Gets current value of property verticalScrolling.
indexOfButton(oButton)Checks for the provided sap.m.Button in the aggregation buttons.
indexOfContent(oContent)Checks for the provided sap.ui.core.Control in the aggregation content.
insertButton(oButton, iIndex)Inserts a button into the aggregation buttons.
insertContent(oContent, iIndex)Inserts a content into the aggregation content.
isOpen()The method checks if the Dialog is open.
open()Open the dialog.
removeAllAriaDescribedBy()Removes all the controls in the association named ariaDescribedBy.
removeAllAriaLabelledBy()Removes all the controls in the association named ariaLabelledBy.
removeAllButtons()Removes all the controls from the aggregation buttons.
removeAllContent()Removes all the controls from the aggregation content.
removeAriaDescribedBy(vAriaDescribedBy)Removes an ariaDescribedBy from the association named ariaDescribedBy.
removeAriaLabelledBy(vAriaLabelledBy)Removes an ariaLabelledBy from the association named ariaLabelledBy.
removeButton(vButton)Removes a button from the aggregation buttons.
removeContent(vContent)Removes a content from the aggregation content.
setBeginButton(oBeginButton)Sets the aggregated beginButton.
setContentHeight(sContentHeight)Sets a new value for property contentHeight.
setContentWidth(sContentWidth)Sets a new value for property contentWidth.
setCustomHeader(oCustomHeader)Sets the aggregated customHeader.
setDraggable(bDraggable)Sets a new value for property draggable.
setEndButton(oEndButton)Sets the aggregated endButton.
setHorizontalScrolling(bHorizontalScrolling)Sets a new value for property horizontalScrolling.
setIcon(sIcon)Sets a new value for property icon.
setInitialFocus(oInitialFocus)Sets the associated initialFocus.
setResizable(bResizable)Sets a new value for property resizable.
setShowHeader(bShowHeader)Sets a new value for property showHeader.
setState(sState)Sets a new value for property state.
setStretch(bStretch)Sets a new value for property stretch.
setSubHeader(oSubHeader)Sets the aggregated subHeader.
setTitle(sTitle)Sets a new value for property title.
setType(sType)Sets a new value for property type.
setVerticalScrolling(bVerticalScrolling)Sets a new value for property verticalScrolling.
getLeftButton()ID of the element which is the current target of the association leftButton, or null.
getRightButton()ID of the element which is the current target of the association rightButton, or null.
getStretchOnPhone()Gets current value of property stretchOnPhone.
setLeftButton(oLeftButton)Sets the associated leftButton.
setRightButton(oRightButton)Sets the associated rightButton.
setStretchOnPhone(bStretchOnPhone)Sets a new value for property stretchOnPhone.
Methods borrowed from class sap.ui.core.Control
addStyleClass, allowTextSelection, attachBrowserEvent, attachValidateFieldGroup, checkFieldGroupIds, clone, detachBrowserEvent, detachValidateFieldGroup, fireValidateFieldGroup, getAccessibilityInfo, getBusy, getBusyIndicatorDelay, getControlsByFieldGroupId, getFieldGroupIds, getIdForLabel, getRenderer, getVisible, hasStyleClass, invalidate, isBusy, onAfterRendering, onBeforeRendering, placeAt, removeStyleClass, rerender, setBusy, setBusyIndicatorDelay, setFieldGroupIds, setVisible, toggleStyleClass, triggerValidateFieldGroup
Methods borrowed from class sap.ui.core.Element
$, addCustomData, addDependent, addEventDelegate, applyFocusInfo, bindElement, data, destroy, destroyCustomData, destroyDependents, destroyLayoutData, destroyTooltip, enhanceAccessibilityState, exit, findElements, fireEvent, focus, getCustomData, getDependents, getDomRef, getElementBinding, getFocusDomRef, getFocusInfo, getInterface, getLayoutData, getMetadata, getTooltip, getTooltip_AsString, getTooltip_Text, indexOfCustomData, indexOfDependent, init, insertCustomData, insertDependent, prop, removeAllCustomData, removeAllDependents, removeCustomData, removeDependent, removeEventDelegate, setLayoutData, setTooltip, toString, unbindElement
Methods borrowed from class sap.ui.base.ManagedObject
addAggregation, addAssociation, applySettings, attachFormatError, attachModelContextChange, attachParseError, attachValidationError, attachValidationSuccess, bindAggregation, bindContext, bindObject, bindProperty, destroyAggregation, detachFormatError, detachModelContextChange, detachParseError, detachValidationError, detachValidationSuccess, findAggregatedObjects, fireFormatError, fireModelContextChange, fireParseError, fireValidationError, fireValidationSuccess, getAggregation, getAssociation, getBinding, getBindingContext, getBindingInfo, getBindingPath, getEventingParent, getId, getModel, getObjectBinding, getOriginInfo, getParent, getProperty, hasModel, indexOfAggregation, insertAggregation, isBound, isInvalidateSuppressed, isTreeBinding, propagateMessages, removeAggregation, removeAllAggregation, removeAllAssociation, removeAssociation, setAggregation, setAssociation, setBindingContext, setModel, setProperty, unbindAggregation, unbindContext, unbindObject, unbindProperty, validateAggregation, validateProperty
Methods borrowed from class sap.ui.base.EventProvider
attachEvent, attachEventOnce, detachEvent, hasListeners
Constructor Detail
new sap.m.Dialog(sId?, mSettings?)
Constructor for a new Dialog.

Accepts an object literal mSettings that defines initial property values, aggregated and associated objects as well as event handlers. See sap.ui.base.ManagedObject for a general description of the syntax of the settings object.

The supported settings are:

  • Properties
  • Aggregations
  • Events
    • beforeOpen : fnListenerFunction or [fnListenerFunction, oListenerObject] or [oData, fnListenerFunction, oListenerObject]
    • afterOpen : fnListenerFunction or [fnListenerFunction, oListenerObject] or [oData, fnListenerFunction, oListenerObject]
    • beforeClose : fnListenerFunction or [fnListenerFunction, oListenerObject] or [oData, fnListenerFunction, oListenerObject]
    • afterClose : fnListenerFunction or [fnListenerFunction, oListenerObject] or [oData, fnListenerFunction, oListenerObject]

In addition, all settings applicable to the base type sap.ui.core.Control can be used as well.

Parameters:
{string}sId? ID for the new control, generated automatically if no ID is given
{object}mSettings? Initial settings for the new control
Event Detail
afterClose(oControlEvent)
This event will be fired after the dialog is closed.
Parameters:
{sap.ui.base.Event}oControlEvent
{sap.ui.base.EventProvider}oControlEvent.getSource
{object}oControlEvent.getParameters
{sap.m.Button}oControlEvent.getParameters.origin This indicates the trigger of closing the dialog. If dialog is closed by either leftButton or rightButton, the button that closes the dialog is set to this parameter. Otherwise this parameter is set to null.
afterOpen(oControlEvent)
This event will be fired after the dialog is opened.
Parameters:
{sap.ui.base.Event}oControlEvent
{sap.ui.base.EventProvider}oControlEvent.getSource
{object}oControlEvent.getParameters
beforeClose(oControlEvent)
This event will be fired before the dialog is closed.
Parameters:
{sap.ui.base.Event}oControlEvent
{sap.ui.base.EventProvider}oControlEvent.getSource
{object}oControlEvent.getParameters
{sap.m.Button}oControlEvent.getParameters.origin This indicates the trigger of closing the dialog. If dialog is closed by either leftButton or rightButton, the button that closes the dialog is set to this parameter. Otherwise this parameter is set to null.
beforeOpen(oControlEvent)
This event will be fired before the dialog is opened.
Parameters:
{sap.ui.base.Event}oControlEvent
{sap.ui.base.EventProvider}oControlEvent.getSource
{object}oControlEvent.getParameters
Method Detail
sap.m.Dialog.extend(sClassName, oClassInfo?, FNMetaImpl?): function
Creates a new subclass of class sap.m.Dialog with name sClassName and enriches it with the information contained in oClassInfo.

oClassInfo might contain the same kind of information as described in sap.ui.core.Control.extend.

Parameters:
{string}sClassName Name of the class being created
{object}oClassInfo? Object literal with information about the class
{function}FNMetaImpl? Constructor function for the metadata object; if not given, it defaults to sap.ui.core.ElementMetadata
Returns:
{function} Created class / constructor function
sap.m.Dialog.getMetadata(): sap.ui.base.Metadata
Returns a metadata object for class sap.m.Dialog.
Returns:
{sap.ui.base.Metadata} Metadata object describing this class
_getAnyHeader()
Returns the custom header instance when the customHeader aggregation is set. Otherwise it returns the internal managed header instance. This method can be called within composite controls which use sap.m.Dialog inside.
addAriaDescribedBy(vAriaDescribedBy): sap.m.Dialog
Adds some ariaDescribedBy into the association ariaDescribedBy.
Parameters:
{string|sap.ui.core.Control}vAriaDescribedBy the ariaDescribedBy to add; if empty, nothing is inserted
Returns:
{sap.m.Dialog} Reference to this in order to allow method chaining
addAriaLabelledBy(vAriaLabelledBy): sap.m.Dialog
Adds some ariaLabelledBy into the association ariaLabelledBy.
Parameters:
{string|sap.ui.core.Control}vAriaLabelledBy the ariaLabelledBy to add; if empty, nothing is inserted
Returns:
{sap.m.Dialog} Reference to this in order to allow method chaining
addButton(oButton): sap.m.Dialog
Adds some button to the aggregation buttons.
Parameters:
{sap.m.Button}oButton the button to add; if empty, nothing is inserted
Since:
1.21.1
Returns:
{sap.m.Dialog} Reference to this in order to allow method chaining
addContent(oContent): sap.m.Dialog
Adds some content to the aggregation content.
Parameters:
{sap.ui.core.Control}oContent the content to add; if empty, nothing is inserted
Returns:
{sap.m.Dialog} Reference to this in order to allow method chaining
attachAfterClose(oData?, fnFunction, oListener?): sap.m.Dialog
Attaches event handler fnFunction to the afterClose event of this sap.m.Dialog.

When called, the context of the event handler (its this) will be bound to oListener if specified, otherwise it will be bound to this sap.m.Dialog itself.

This event will be fired after the dialog is closed.

Parameters:
{object}oData? An application-specific payload object that will be passed to the event handler along with the event object when firing the event
{function}fnFunction The function to be called when the event occurs
{object}oListener? Context object to call the event handler with. Defaults to this sap.m.Dialog itself
Returns:
{sap.m.Dialog} Reference to this in order to allow method chaining
attachAfterOpen(oData?, fnFunction, oListener?): sap.m.Dialog
Attaches event handler fnFunction to the afterOpen event of this sap.m.Dialog.

When called, the context of the event handler (its this) will be bound to oListener if specified, otherwise it will be bound to this sap.m.Dialog itself.

This event will be fired after the dialog is opened.

Parameters:
{object}oData? An application-specific payload object that will be passed to the event handler along with the event object when firing the event
{function}fnFunction The function to be called when the event occurs
{object}oListener? Context object to call the event handler with. Defaults to this sap.m.Dialog itself
Returns:
{sap.m.Dialog} Reference to this in order to allow method chaining
attachBeforeClose(oData?, fnFunction, oListener?): sap.m.Dialog
Attaches event handler fnFunction to the beforeClose event of this sap.m.Dialog.

When called, the context of the event handler (its this) will be bound to oListener if specified, otherwise it will be bound to this sap.m.Dialog itself.

This event will be fired before the dialog is closed.

Parameters:
{object}oData? An application-specific payload object that will be passed to the event handler along with the event object when firing the event
{function}fnFunction The function to be called when the event occurs
{object}oListener? Context object to call the event handler with. Defaults to this sap.m.Dialog itself
Returns:
{sap.m.Dialog} Reference to this in order to allow method chaining
attachBeforeOpen(oData?, fnFunction, oListener?): sap.m.Dialog
Attaches event handler fnFunction to the beforeOpen event of this sap.m.Dialog.

When called, the context of the event handler (its this) will be bound to oListener if specified, otherwise it will be bound to this sap.m.Dialog itself.

This event will be fired before the dialog is opened.

Parameters:
{object}oData? An application-specific payload object that will be passed to the event handler along with the event object when firing the event
{function}fnFunction The function to be called when the event occurs
{object}oListener? Context object to call the event handler with. Defaults to this sap.m.Dialog itself
Returns:
{sap.m.Dialog} Reference to this in order to allow method chaining
close()
Close the dialog.
destroyBeginButton(): sap.m.Dialog
Destroys the beginButton in the aggregation beginButton.
Since:
1.15.1
Returns:
{sap.m.Dialog} Reference to this in order to allow method chaining
destroyButtons(): sap.m.Dialog
Destroys all the buttons in the aggregation buttons.
Since:
1.21.1
Returns:
{sap.m.Dialog} Reference to this in order to allow method chaining
destroyContent(): sap.m.Dialog
Destroys all the content in the aggregation content.
Returns:
{sap.m.Dialog} Reference to this in order to allow method chaining
destroyCustomHeader(): sap.m.Dialog
Destroys the customHeader in the aggregation customHeader.
Since:
1.15.1
Returns:
{sap.m.Dialog} Reference to this in order to allow method chaining
destroyEndButton(): sap.m.Dialog
Destroys the endButton in the aggregation endButton.
Since:
1.15.1
Returns:
{sap.m.Dialog} Reference to this in order to allow method chaining
destroySubHeader(): sap.m.Dialog
Destroys the subHeader in the aggregation subHeader.
Since:
1.12.2
Returns:
{sap.m.Dialog} Reference to this in order to allow method chaining
detachAfterClose(fnFunction, oListener): sap.m.Dialog
Detaches event handler fnFunction from the afterClose event of this sap.m.Dialog.

The passed function and listener object must match the ones used for event registration.

Parameters:
{function}fnFunction The function to be called, when the event occurs
{object}oListener Context object on which the given function had to be called
Returns:
{sap.m.Dialog} Reference to this in order to allow method chaining
detachAfterOpen(fnFunction, oListener): sap.m.Dialog
Detaches event handler fnFunction from the afterOpen event of this sap.m.Dialog.

The passed function and listener object must match the ones used for event registration.

Parameters:
{function}fnFunction The function to be called, when the event occurs
{object}oListener Context object on which the given function had to be called
Returns:
{sap.m.Dialog} Reference to this in order to allow method chaining
detachBeforeClose(fnFunction, oListener): sap.m.Dialog
Detaches event handler fnFunction from the beforeClose event of this sap.m.Dialog.

The passed function and listener object must match the ones used for event registration.

Parameters:
{function}fnFunction The function to be called, when the event occurs
{object}oListener Context object on which the given function had to be called
Returns:
{sap.m.Dialog} Reference to this in order to allow method chaining
detachBeforeOpen(fnFunction, oListener): sap.m.Dialog
Detaches event handler fnFunction from the beforeOpen event of this sap.m.Dialog.

The passed function and listener object must match the ones used for event registration.

Parameters:
{function}fnFunction The function to be called, when the event occurs
{object}oListener Context object on which the given function had to be called
Returns:
{sap.m.Dialog} Reference to this in order to allow method chaining
fireAfterClose(mArguments?): sap.m.Dialog
Fires event afterClose to attached listeners.

Expects the following event parameters:

  • origin of type sap.m.ButtonThis indicates the trigger of closing the dialog. If dialog is closed by either leftButton or rightButton, the button that closes the dialog is set to this parameter. Otherwise this parameter is set to null.
Parameters:
{Map}mArguments? The arguments to pass along with the event
Returns:
{sap.m.Dialog} Reference to this in order to allow method chaining
fireAfterOpen(mArguments?): sap.m.Dialog
Fires event afterOpen to attached listeners.
Parameters:
{Map}mArguments? The arguments to pass along with the event
Returns:
{sap.m.Dialog} Reference to this in order to allow method chaining
fireBeforeClose(mArguments?): sap.m.Dialog
Fires event beforeClose to attached listeners.

Expects the following event parameters:

  • origin of type sap.m.ButtonThis indicates the trigger of closing the dialog. If dialog is closed by either leftButton or rightButton, the button that closes the dialog is set to this parameter. Otherwise this parameter is set to null.
Parameters:
{Map}mArguments? The arguments to pass along with the event
Returns:
{sap.m.Dialog} Reference to this in order to allow method chaining
fireBeforeOpen(mArguments?): sap.m.Dialog
Fires event beforeOpen to attached listeners.
Parameters:
{Map}mArguments? The arguments to pass along with the event
Returns:
{sap.m.Dialog} Reference to this in order to allow method chaining
getAriaDescribedBy(): sap.ui.core.Control[]
Returns array of IDs of the elements which are the current targets of the association ariaDescribedBy.
Returns:
{sap.ui.core.Control[]}
getAriaLabelledBy(): sap.ui.core.Control[]
Returns array of IDs of the elements which are the current targets of the association ariaLabelledBy.
Returns:
{sap.ui.core.Control[]}
getBeginButton(): sap.m.Button
Gets content of aggregation beginButton.

The button which is rendered to the left side (right side in RTL mode) of the endButton in the footer area inside the dialog. From UI5 version 1.21.1, there's a new aggregation "buttons" created with which more than 2 buttons can be added to the footer area of dialog. If the new "buttons" aggregation is set, any change made to this aggregation has no effect anymore. When runs on the phone, this button (and the endButton together when set) is (are) rendered at the center of the footer area. When runs on the other platforms, this button (and the endButton together when set) is (are) rendered at the right side (left side in RTL mode) of the footer area.

Since:
1.15.1
Returns:
{sap.m.Button}
getButtons(): sap.m.Button[]
Gets content of aggregation buttons.

Buttons can be added to the footer area of dialog through this aggregation. When this aggregation is set, any change to beginButton and endButton has no effect anymore. Buttons which are inside this aggregation are aligned at the right side (left side in RTL mode) of the footer instead of in the middle of the footer.

Since:
1.21.1
Returns:
{sap.m.Button[]}
getContent(): sap.ui.core.Control[]
Gets content of aggregation content.

The content inside the dialog.
Note: When the content of the Dialog is comprised of controls that use position: absolute, such as SplitContainer, the dialog has to have either stretch: true or contentHeight set.

Returns:
{sap.ui.core.Control[]}
getContentHeight(): sap.ui.core.CSSSize
Gets current value of property contentHeight.

Preferred height of content in Dialog. If the preferred height is bigger than the available space on screen, it will be overwritten by the maximum available height on screen in order to make sure that dialog isn't cut off.

Since:
1.12.1
Returns:
{sap.ui.core.CSSSize} Value of property contentHeight
getContentWidth(): sap.ui.core.CSSSize
Gets current value of property contentWidth.

Preferred width of content in Dialog. This property affects the width of dialog on phone in landscape mode, tablet or desktop, because the dialog has a fixed width on phone in portrait mode. If the preferred width is less than the minimum width of dilaog or more than the available width of the screen, it will be overwritten by the min or max value. The current mininum value of dialog width on tablet is 400px.

Since:
1.12.1
Returns:
{sap.ui.core.CSSSize} Value of property contentWidth
getCustomHeader(): sap.m.IBar
Gets content of aggregation customHeader.

CustomHeader is only supported in theme sap_bluecrystal. When it's set, the icon, title and showHeader are properties ignored. Only the customHeader is shown as the header of the dialog.

Since:
1.15.1
Returns:
{sap.m.IBar}
getDraggable(): boolean
Gets current value of property draggable.

Indicates whether the dialog is draggable. If this property is set to true, the dialog will be draggable by it's header. This property has a default value false. The Dialog can be draggable only in desktop mode.

Default value is false.

Since:
1.30
Returns:
{boolean} Value of property draggable
getEndButton(): sap.m.Button
Gets content of aggregation endButton.

The button which is rendered to the right side (left side in RTL mode) of the beginButton in the footer area inside the dialog. From UI5 version 1.21.1, there's a new aggregation "buttons" created with which more than 2 buttons can be added to the footer area of dialog. If the new "buttons" aggregation is set, any change made to this aggregation has no effect anymore. When runs on the phone, this button (and the beginButton together when set) is (are) rendered at the center of the footer area. When runs on the other platforms, this button (and the beginButton together when set) is (are) rendered at the right side (left side in RTL mode) of the footer area.

Since:
1.15.1
Returns:
{sap.m.Button}
getHorizontalScrolling(): boolean
Gets current value of property horizontalScrolling.

Indicates if user can scroll horizontally inside dialog when the content is bigger than the content area. Dialog detects if there's sap.m.NavContainer, sap.m.Page, sap.m.ScrollContainer or sap.m.SplitContainer as direct child added to dialog. If there is, dialog will turn off scrolling by setting this property to false automatically ignoring the existing value of this property.

Default value is true.

Since:
1.15.1
Returns:
{boolean} Value of property horizontalScrolling
getIcon(): sap.ui.core.URI
Gets current value of property icon.

Icon displayed in the dialog's header. This icon is invisible on the iOS platform and it's density aware. You can use the density convention (@2, @1.5, etc.) to provide higher resolution image for higher density screen.

Returns:
{sap.ui.core.URI} Value of property icon
getInitialFocus(): sap.ui.core.Control
ID of the element which is the current target of the association initialFocus, or null.
Since:
1.15.0
Returns:
{sap.ui.core.Control}
getResizable(): boolean
Gets current value of property resizable.

Indicates whether the dialog is resizable. the dialog is resizable. If this property is set to true, the dialog will have a resize handler in it's bottom right corner. This property has a default value false. The Dialog can be resizable only in desktop mode.

Default value is false.

Since:
1.30
Returns:
{boolean} Value of property resizable
getShowHeader(): boolean
Gets current value of property showHeader.

Determines whether the header is shown inside the dialog. If this property is set to true, the text and icon property are ignored. This property has a default value true.

Default value is true.

Since:
1.15.1
Returns:
{boolean} Value of property showHeader
getState(): sap.ui.core.ValueState
Gets current value of property state.

The state affects the icon and the title color. If other than "None" is set, a predefined icon will be added to the dialog. Setting icon property will overwrite the predefined icon. The default value is "None" which doesn't add any icon to the Dialog control. This property is by now only supported by blue crystal theme.

Default value is None.

Since:
1.11.2
Returns:
{sap.ui.core.ValueState} Value of property state
getStretch(): boolean
Gets current value of property stretch.

Determines if the dialog will be stretched to full screen. This property is only applicable to standard dialog and message type dialog ignores this property.

Default value is false.

Since:
1.13.1
Returns:
{boolean} Value of property stretch
getSubHeader(): sap.m.IBar
Gets content of aggregation subHeader.

When subHeader is assigned to Dialog, it's rendered directly after the main header in Dialog. SubHeader is out of the content area and won't be scrolled when content's size is bigger than the content area's size.

Since:
1.12.2
Returns:
{sap.m.IBar}
getTitle(): string
Gets current value of property title.

Title text appears in the dialog header.

Returns:
{string} Value of property title
getType(): sap.m.DialogType
Gets current value of property type.

The type of the dialog. In theme sap_bluecrystal, the type "message" will limit the dialog's width within 480px on tablet and desktop.

Default value is Standard.

Returns:
{sap.m.DialogType} Value of property type
getVerticalScrolling(): boolean
Gets current value of property verticalScrolling.

Indicates if user can scroll vertically inside dialog when the content is bigger than the content area. Dialog detects if there's sap.m.NavContainer, sap.m.Page, sap.m.ScrollContainer or sap.m.SplitContainer as direct child added to dialog. If there is, dialog will turn off scrolling by setting this property to false automatically ignoring the existing value of this property.

Default value is true.

Since:
1.15.1
Returns:
{boolean} Value of property verticalScrolling
indexOfButton(oButton): int
Checks for the provided sap.m.Button in the aggregation buttons. and returns its index if found or -1 otherwise.
Parameters:
{sap.m.Button}oButton The button whose index is looked for
Since:
1.21.1
Returns:
{int} The index of the provided control in the aggregation if found, or -1 otherwise
indexOfContent(oContent): int
Checks for the provided sap.ui.core.Control in the aggregation content. and returns its index if found or -1 otherwise.
Parameters:
{sap.ui.core.Control}oContent The content whose index is looked for
Returns:
{int} The index of the provided control in the aggregation if found, or -1 otherwise
insertButton(oButton, iIndex): sap.m.Dialog
Inserts a button into the aggregation buttons.
Parameters:
{sap.m.Button}oButton the button to insert; if empty, nothing is inserted
{int}iIndex the 0-based index the button should be inserted at; for a negative value of iIndex, the button is inserted at position 0; for a value greater than the current size of the aggregation, the button is inserted at the last position
Since:
1.21.1
Returns:
{sap.m.Dialog} Reference to this in order to allow method chaining
insertContent(oContent, iIndex): sap.m.Dialog
Inserts a content into the aggregation content.
Parameters:
{sap.ui.core.Control}oContent the content to insert; if empty, nothing is inserted
{int}iIndex the 0-based index the content should be inserted at; for a negative value of iIndex, the content is inserted at position 0; for a value greater than the current size of the aggregation, the content is inserted at the last position
Returns:
{sap.m.Dialog} Reference to this in order to allow method chaining
isOpen()
The method checks if the Dialog is open. It returns true when the Dialog is currently open (this includes opening and closing animations), otherwise it returns false.
Since:
1.9.1
open()
Open the dialog.
removeAllAriaDescribedBy(): sap.ui.core.Control[]
Removes all the controls in the association named ariaDescribedBy.
Returns:
{sap.ui.core.Control[]} An array of the removed elements (might be empty)
removeAllAriaLabelledBy(): sap.ui.core.Control[]
Removes all the controls in the association named ariaLabelledBy.
Returns:
{sap.ui.core.Control[]} An array of the removed elements (might be empty)
removeAllButtons(): sap.m.Button[]
Removes all the controls from the aggregation buttons.

Additionally, it unregisters them from the hosting UIArea.

Since:
1.21.1
Returns:
{sap.m.Button[]} An array of the removed elements (might be empty)
removeAllContent(): sap.ui.core.Control[]
Removes all the controls from the aggregation content.

Additionally, it unregisters them from the hosting UIArea.

Returns:
{sap.ui.core.Control[]} An array of the removed elements (might be empty)
removeAriaDescribedBy(vAriaDescribedBy): sap.ui.core.Control
Removes an ariaDescribedBy from the association named ariaDescribedBy.
Parameters:
{int|string|sap.ui.core.Control}vAriaDescribedBy The ariaDescribedByto be removed or its index or ID
Returns:
{sap.ui.core.Control} the removed ariaDescribedBy or null
removeAriaLabelledBy(vAriaLabelledBy): sap.ui.core.Control
Removes an ariaLabelledBy from the association named ariaLabelledBy.
Parameters:
{int|string|sap.ui.core.Control}vAriaLabelledBy The ariaLabelledByto be removed or its index or ID
Returns:
{sap.ui.core.Control} the removed ariaLabelledBy or null
removeButton(vButton): sap.m.Button
Removes a button from the aggregation buttons.
Parameters:
{int|string|sap.m.Button}vButton The buttonto remove or its index or id
Since:
1.21.1
Returns:
{sap.m.Button} The removed button or null
removeContent(vContent): sap.ui.core.Control
Removes a content from the aggregation content.
Parameters:
{int|string|sap.ui.core.Control}vContent The contentto remove or its index or id
Returns:
{sap.ui.core.Control} The removed content or null
setBeginButton(oBeginButton): sap.m.Dialog
Sets the aggregated beginButton.
Parameters:
{sap.m.Button}oBeginButton The beginButton to set
Since:
1.15.1
Returns:
{sap.m.Dialog} Reference to this in order to allow method chaining
setContentHeight(sContentHeight): sap.m.Dialog
Sets a new value for property contentHeight.

Preferred height of content in Dialog. If the preferred height is bigger than the available space on screen, it will be overwritten by the maximum available height on screen in order to make sure that dialog isn't cut off.

When called with a value of null or undefined, the default value of the property will be restored.

Parameters:
{sap.ui.core.CSSSize}sContentHeight New value for property contentHeight
Since:
1.12.1
Returns:
{sap.m.Dialog} Reference to this in order to allow method chaining
setContentWidth(sContentWidth): sap.m.Dialog
Sets a new value for property contentWidth.

Preferred width of content in Dialog. This property affects the width of dialog on phone in landscape mode, tablet or desktop, because the dialog has a fixed width on phone in portrait mode. If the preferred width is less than the minimum width of dilaog or more than the available width of the screen, it will be overwritten by the min or max value. The current mininum value of dialog width on tablet is 400px.

When called with a value of null or undefined, the default value of the property will be restored.

Parameters:
{sap.ui.core.CSSSize}sContentWidth New value for property contentWidth
Since:
1.12.1
Returns:
{sap.m.Dialog} Reference to this in order to allow method chaining
setCustomHeader(oCustomHeader): sap.m.Dialog
Sets the aggregated customHeader.
Parameters:
{sap.m.IBar}oCustomHeader The customHeader to set
Since:
1.15.1
Returns:
{sap.m.Dialog} Reference to this in order to allow method chaining
setDraggable(bDraggable): sap.m.Dialog
Sets a new value for property draggable.

Indicates whether the dialog is draggable. If this property is set to true, the dialog will be draggable by it's header. This property has a default value false. The Dialog can be draggable only in desktop mode.

When called with a value of null or undefined, the default value of the property will be restored.

Default value is false.

Parameters:
{boolean}bDraggable New value for property draggable
Since:
1.30
Returns:
{sap.m.Dialog} Reference to this in order to allow method chaining
setEndButton(oEndButton): sap.m.Dialog
Sets the aggregated endButton.
Parameters:
{sap.m.Button}oEndButton The endButton to set
Since:
1.15.1
Returns:
{sap.m.Dialog} Reference to this in order to allow method chaining
setHorizontalScrolling(bHorizontalScrolling): sap.m.Dialog
Sets a new value for property horizontalScrolling.

Indicates if user can scroll horizontally inside dialog when the content is bigger than the content area. Dialog detects if there's sap.m.NavContainer, sap.m.Page, sap.m.ScrollContainer or sap.m.SplitContainer as direct child added to dialog. If there is, dialog will turn off scrolling by setting this property to false automatically ignoring the existing value of this property.

When called with a value of null or undefined, the default value of the property will be restored.

Default value is true.

Parameters:
{boolean}bHorizontalScrolling New value for property horizontalScrolling
Since:
1.15.1
Returns:
{sap.m.Dialog} Reference to this in order to allow method chaining
setIcon(sIcon): sap.m.Dialog
Sets a new value for property icon.

Icon displayed in the dialog's header. This icon is invisible on the iOS platform and it's density aware. You can use the density convention (@2, @1.5, etc.) to provide higher resolution image for higher density screen.

When called with a value of null or undefined, the default value of the property will be restored.

Parameters:
{sap.ui.core.URI}sIcon New value for property icon
Returns:
{sap.m.Dialog} Reference to this in order to allow method chaining
setInitialFocus(oInitialFocus): sap.m.Dialog
Sets the associated initialFocus.
Parameters:
{sap.ui.core.Control}oInitialFocus Id of an element which becomes the new target of this initialFocus association; alternatively, an element instance may be given
Since:
1.15.0
Returns:
{sap.m.Dialog} Reference to this in order to allow method chaining
setResizable(bResizable): sap.m.Dialog
Sets a new value for property resizable.

Indicates whether the dialog is resizable. the dialog is resizable. If this property is set to true, the dialog will have a resize handler in it's bottom right corner. This property has a default value false. The Dialog can be resizable only in desktop mode.

When called with a value of null or undefined, the default value of the property will be restored.

Default value is false.

Parameters:
{boolean}bResizable New value for property resizable
Since:
1.30
Returns:
{sap.m.Dialog} Reference to this in order to allow method chaining
setShowHeader(bShowHeader): sap.m.Dialog
Sets a new value for property showHeader.

Determines whether the header is shown inside the dialog. If this property is set to true, the text and icon property are ignored. This property has a default value true.

When called with a value of null or undefined, the default value of the property will be restored.

Default value is true.

Parameters:
{boolean}bShowHeader New value for property showHeader
Since:
1.15.1
Returns:
{sap.m.Dialog} Reference to this in order to allow method chaining
setState(sState): sap.m.Dialog
Sets a new value for property state.

The state affects the icon and the title color. If other than "None" is set, a predefined icon will be added to the dialog. Setting icon property will overwrite the predefined icon. The default value is "None" which doesn't add any icon to the Dialog control. This property is by now only supported by blue crystal theme.

When called with a value of null or undefined, the default value of the property will be restored.

Default value is None.

Parameters:
{sap.ui.core.ValueState}sState New value for property state
Since:
1.11.2
Returns:
{sap.m.Dialog} Reference to this in order to allow method chaining
setStretch(bStretch): sap.m.Dialog
Sets a new value for property stretch.

Determines if the dialog will be stretched to full screen. This property is only applicable to standard dialog and message type dialog ignores this property.

When called with a value of null or undefined, the default value of the property will be restored.

Default value is false.

Parameters:
{boolean}bStretch New value for property stretch
Since:
1.13.1
Returns:
{sap.m.Dialog} Reference to this in order to allow method chaining
setSubHeader(oSubHeader): sap.m.Dialog
Sets the aggregated subHeader.
Parameters:
{sap.m.IBar}oSubHeader The subHeader to set
Since:
1.12.2
Returns:
{sap.m.Dialog} Reference to this in order to allow method chaining
setTitle(sTitle): sap.m.Dialog
Sets a new value for property title.

Title text appears in the dialog header.

When called with a value of null or undefined, the default value of the property will be restored.

Parameters:
{string}sTitle New value for property title
Returns:
{sap.m.Dialog} Reference to this in order to allow method chaining
setType(sType): sap.m.Dialog
Sets a new value for property type.

The type of the dialog. In theme sap_bluecrystal, the type "message" will limit the dialog's width within 480px on tablet and desktop.

When called with a value of null or undefined, the default value of the property will be restored.

Default value is Standard.

Parameters:
{sap.m.DialogType}sType New value for property type
Returns:
{sap.m.Dialog} Reference to this in order to allow method chaining
setVerticalScrolling(bVerticalScrolling): sap.m.Dialog
Sets a new value for property verticalScrolling.

Indicates if user can scroll vertically inside dialog when the content is bigger than the content area. Dialog detects if there's sap.m.NavContainer, sap.m.Page, sap.m.ScrollContainer or sap.m.SplitContainer as direct child added to dialog. If there is, dialog will turn off scrolling by setting this property to false automatically ignoring the existing value of this property.

When called with a value of null or undefined, the default value of the property will be restored.

Default value is true.

Parameters:
{boolean}bVerticalScrolling New value for property verticalScrolling
Since:
1.15.1
Returns:
{sap.m.Dialog} Reference to this in order to allow method chaining
getLeftButton(): sap.m.Button
ID of the element which is the current target of the association leftButton, or null.
Deprecated:
Since version 1.15.1.

LeftButton has been deprecated since 1.15.1. Please use the beginButton instead which is more RTL friendly.

Returns:
{sap.m.Button}
getRightButton(): sap.m.Button
ID of the element which is the current target of the association rightButton, or null.
Deprecated:
Since version 1.15.1.

RightButton has been deprecated since 1.15.1. Please use the endButton instead which is more RTL friendly.

Returns:
{sap.m.Button}
getStretchOnPhone(): boolean
Gets current value of property stretchOnPhone.

Determines whether the dialog will displayed on full screen on a phone.

Default value is false.

Deprecated:
Since version 1.13.1. Please use the new stretch property instead. This enables a stretched dialog even on tablet and desktop. If you want to achieve the same effect as stretchOnPhone, please set the stretch with jQuery.device.is.phone, then dialog is only stretched when runs on phone.
Since:
1.11.2
Returns:
{boolean} Value of property stretchOnPhone
setLeftButton(oLeftButton): sap.m.Dialog
Sets the associated leftButton.
Parameters:
{sap.m.Button}oLeftButton Id of an element which becomes the new target of this leftButton association; alternatively, an element instance may be given
Deprecated:
Since version 1.15.1.

LeftButton has been deprecated since 1.15.1. Please use the beginButton instead which is more RTL friendly.

Returns:
{sap.m.Dialog} Reference to this in order to allow method chaining
setRightButton(oRightButton): sap.m.Dialog
Sets the associated rightButton.
Parameters:
{sap.m.Button}oRightButton Id of an element which becomes the new target of this rightButton association; alternatively, an element instance may be given
Deprecated:
Since version 1.15.1.

RightButton has been deprecated since 1.15.1. Please use the endButton instead which is more RTL friendly.

Returns:
{sap.m.Dialog} Reference to this in order to allow method chaining
setStretchOnPhone(bStretchOnPhone): sap.m.Dialog
Sets a new value for property stretchOnPhone.

Determines whether the dialog will displayed on full screen on a phone.

When called with a value of null or undefined, the default value of the property will be restored.

Default value is false.

Parameters:
{boolean}bStretchOnPhone New value for property stretchOnPhone
Deprecated:
Since version 1.13.1. Please use the new stretch property instead. This enables a stretched dialog even on tablet and desktop. If you want to achieve the same effect as stretchOnPhone, please set the stretch with jQuery.device.is.phone, then dialog is only stretched when runs on phone.
Since:
1.11.2
Returns:
{sap.m.Dialog} Reference to this in order to allow method chaining