Class sap.ui.commons.DialogModule: sap/ui/commons/Dialog

extends Control
implements PopupInterface

An interactive window appearing on request displaying information to the user. The API supports features such as popups with fixed sizes, popups with unlimited width, scrolling bars for large windows, and control nesting (for example, a drop-down list can be included in the window).
Deprecated API:
Since version 1.38. Instead, use the sap.m.Dialog control.
Constructor Summary
new sap.ui.commons.Dialog(sId?, mSettings?)Constructor for a new Dialog.
Event Summary
closed(oControlEvent)Event is fired when the dialog has been closed (after closing-animation etc.
Events borrowed from class sap.ui.core.Control
Method Summary
sap.ui.commons.Dialog.extend(sClassName, oClassInfo?, FNMetaImpl?)Creates a new subclass of class sap.ui.commons.Dialog with name sClassName and enriches it with the information contained in oClassInfo.
sap.ui.commons.Dialog.getMetadata()Returns a metadata object for class sap.ui.commons.Dialog.
addButton(oButton)Adds some button to the aggregation buttons.
addContent(oContent)Adds some content to the aggregation content.
attachClosed(oData?, fnFunction, oListener?)Attaches event handler fnFunction to the closed event of this sap.ui.commons.Dialog.
close()Closes the dialog control instance.
destroyButtons()Destroys all the buttons in the aggregation buttons.
destroyContent()Destroys all the content in the aggregation content.
detachClosed(fnFunction, oListener)Detaches event handler fnFunction from the closed event of this sap.ui.commons.Dialog.
fireClosed(mParameters?)Fires event closed to attached listeners.
getAccessibleRole()Gets current value of property accessibleRole.
getApplyContentPadding()Gets current value of property applyContentPadding.
getAutoClose()Gets current value of property autoClose.
getButtons()Gets content of aggregation buttons.
getContent()Gets content of aggregation content.
getContentBorderDesign()Gets current value of property contentBorderDesign.
getDefaultButton()ID of the element which is the current target of the association defaultButton, or null.
getEnabled()Determines whether the dialog is currently enabled or not.
getHeight()Gets current value of property height.
getInitialFocus()ID of the element which is the current target of the association initialFocus, or null.
getKeepInWindow()Gets current value of property keepInWindow.
getMaxHeight()Gets current value of property maxHeight.
getMaxWidth()Gets current value of property maxWidth.
getMinHeight()Gets current value of property minHeight.
getMinWidth()Gets current value of property minWidth.
getModal()Gets current value of property modal.
getOpenState()Indicates whether the Dialog is currently open, closed, or transitioning between these states.
getResizable()Gets current value of property resizable.
getScrollLeft()Gets current value of property scrollLeft.
getScrollTop()Gets current value of property scrollTop.
getShowCloseButton()Gets current value of property showCloseButton.
getTitle()Gets current value of property title.
getWidth()Gets current value of property width.
indexOfButton(oButton)Checks for the provided sap.ui.core.Control 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()Indicates whether the Dialog is open (this includes opening and closing animations).
open()Opens the dialog control instance.
removeAllButtons()Removes all the controls from the aggregation buttons.
removeAllContent()Removes all the controls from the aggregation content.
removeButton(vButton)Removes a button from the aggregation buttons.
removeContent(vContent)Removes a content from the aggregation content.
setAccessibleRole(sAccessibleRole)Sets a new value for property accessibleRole.
setApplyContentPadding(bApplyContentPadding)Sets a new value for property applyContentPadding.
setAutoClose(bAutoClose)Sets a new value for property autoClose.
setContentBorderDesign(sContentBorderDesign)Sets a new value for property contentBorderDesign.
setDefaultButton(oDefaultButton)Sets the associated defaultButton.
setHeight(sHeight)Sets a new value for property height.
setInitialFocus(oInitialFocus)Sets the associated initialFocus.
setKeepInWindow(bKeepInWindow)Sets a new value for property keepInWindow.
setMaxHeight(sMaxHeight)Sets a new value for property maxHeight.
setMaxWidth(sMaxWidth)Sets a new value for property maxWidth.
setMinHeight(sMinHeight)Sets a new value for property minHeight.
setMinWidth(sMinWidth)Sets a new value for property minWidth.
setModal(bModal)Sets a new value for property modal.
setResizable(bResizable)Sets a new value for property resizable.
setScrollLeft(iScrollLeft)Sets a new value for property scrollLeft.
setScrollTop(iScrollTop)Sets a new value for property scrollTop.
setShowCloseButton(bShowCloseButton)Sets a new value for property showCloseButton.
setTitle(sTitle)Sets a new value for property title.
setWidth(sWidth)Sets a new value for property width.
Constructor Detail
new sap.ui.commons.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:

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

Parameters:
stringsId?ID for the new control, generated automatically if no ID is given
objectmSettings?Initial settings for the new control
Event Detail
closed(oControlEvent)
Event is fired when the dialog has been closed (after closing-animation etc.). Event parameters provide information about last position and last size.
Parameters:
sap.ui.base.EventoControlEvent
sap.ui.base.EventProvideroControlEvent.getSource
objectoControlEvent.getParameters
intoControlEvent.getParameters.widthThe width of the dialog when closed
intoControlEvent.getParameters.heightThe height of the dialog when closed
intoControlEvent.getParameters.topThe top position of the dialog when closed
intoControlEvent.getParameters.leftThe left position of the dialog when closed
Method Detail
sap.ui.commons.Dialog.extend(sClassName, oClassInfo?, FNMetaImpl?): function

Creates a new subclass of class sap.ui.commons.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:
stringsClassNameName of the class being created
objectoClassInfo?Object literal with information about the class
functionFNMetaImpl?Constructor function for the metadata object; if not given, it defaults to sap.ui.core.ElementMetadata
Returns:
functionCreated class / constructor function
sap.ui.commons.Dialog.getMetadata(): sap.ui.base.Metadata
Returns a metadata object for class sap.ui.commons.Dialog.
Returns:
sap.ui.base.MetadataMetadata object describing this class
addButton(oButton): sap.ui.commons.Dialog
Adds some button to the aggregation buttons.
Parameters:
sap.ui.core.ControloButtonthe button to add; if empty, nothing is inserted
Returns:
sap.ui.commons.DialogReference to this in order to allow method chaining
addContent(oContent): sap.ui.commons.Dialog
Adds some content to the aggregation content.
Parameters:
sap.ui.core.ControloContentthe content to add; if empty, nothing is inserted
Returns:
sap.ui.commons.DialogReference to this in order to allow method chaining
attachClosed(oData?, fnFunction, oListener?): sap.ui.commons.Dialog

Attaches event handler fnFunction to the closed event of this sap.ui.commons.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.ui.commons.Dialog itself.

Event is fired when the dialog has been closed (after closing-animation etc.). Event parameters provide information about last position and last size.

Parameters:
objectoData?An application-specific payload object that will be passed to the event handler along with the event object when firing the event
functionfnFunctionThe function to be called when the event occurs
objectoListener?Context object to call the event handler with. Defaults to this sap.ui.commons.Dialog itself
Returns:
sap.ui.commons.DialogReference to this in order to allow method chaining
close()
Closes the dialog control instance.
destroyButtons(): sap.ui.commons.Dialog
Destroys all the buttons in the aggregation buttons.
Returns:
sap.ui.commons.DialogReference to this in order to allow method chaining
destroyContent(): sap.ui.commons.Dialog
Destroys all the content in the aggregation content.
Returns:
sap.ui.commons.DialogReference to this in order to allow method chaining
detachClosed(fnFunction, oListener): sap.ui.commons.Dialog

Detaches event handler fnFunction from the closed event of this sap.ui.commons.Dialog.

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

Parameters:
functionfnFunctionThe function to be called, when the event occurs
objectoListenerContext object on which the given function had to be called
Returns:
sap.ui.commons.DialogReference to this in order to allow method chaining
fireClosed(mParameters?): sap.ui.commons.Dialog
Fires event closed to attached listeners.
Parameters:
objectmParameters?Parameters to pass along with the event
intmParameters.width?The width of the dialog when closed
intmParameters.height?The height of the dialog when closed
intmParameters.top?The top position of the dialog when closed
intmParameters.left?The left position of the dialog when closed
Returns:
sap.ui.commons.DialogReference to this in order to allow method chaining
getAccessibleRole(): sap.ui.core.AccessibleRole

Gets current value of property accessibleRole.

The ARIA role for the control. E.g. for alert-style Dialogs this can be set to "AlertDialog".

Default value is Dialog.

Returns:
sap.ui.core.AccessibleRoleValue of property accessibleRole
getApplyContentPadding(): boolean

Gets current value of property applyContentPadding.

Padding is theme-dependent. When set to "false", the content extends to the dialog borders.

Default value is true.

Returns:
booleanValue of property applyContentPadding
getAutoClose(): boolean

Gets current value of property autoClose.

If this property is set to true the Dialog will close if the Dialog loses its focus

Default value is false.

Returns:
booleanValue of property autoClose
Since:
1.10
getButtons(): sap.ui.core.Control[]

Gets content of aggregation buttons.

Aggregation of the buttons to display at the bottom of the dialog, for example OK and Cancel. Association defaultButton can be used for one of the defined buttons.

Returns:
sap.ui.core.Control[]
getContent(): sap.ui.core.Control[]

Gets content of aggregation content.

Aggregation of the content of the dialog (one or more controls).

Warning: when content is added with width given as a percentage, the Dialog itself should have a width set.

Returns:
sap.ui.core.Control[]
getContentBorderDesign(): sap.ui.commons.enums.BorderDesign

Gets current value of property contentBorderDesign.

Specifies the border design. Border design is theme dependent.

Default value is None.

Returns:
sap.ui.commons.enums.BorderDesignValue of property contentBorderDesign
getDefaultButton(): sap.ui.core.ID
ID of the element which is the current target of the association defaultButton, or null.
Returns:
sap.ui.core.ID
getEnabled(): boolean

Determines whether the dialog is currently enabled or not.

Applications can't control the enabled state via a property. A dialog is implicitly enabled depending on its openState. Descendant controls that honor the enabled state of their ancestors will appear disabled after the dialog is closed.

Returns:
booleanindicates whether the dialog is currently enabled or not.
Experimental API:
Whether a dialog is regarded as "enabled" during the state transitions (OPENING, CLOSING) is not fully decided. Currently, it is enabled during the OPENING phase and disabled during the CLOSING phase. The only potential change would be to treat the OPENING phase as disabled as well. Applications should be prepared to receive events from "enabled" controls after they called open() on the dialog until close() is called on it. If the mentioned potential change should happen, the dialog will become enabled only after the transition to OPEN. Events from "enabled" children then can still only arrive between open() and close(), so applications that obey the previous rule should continue to work. Only end users or code that explicitly triggers pseudo user events will notice a difference.
A second aspect that might change is the visual behavior of the content: during the CLOSING phase it 'looks' enabled but in fact it is already disabled. This avoids unnecessary redraws for content that becomes hidden soon. Should this show to be confusing for end users, it might be changed.
getHeight(): sap.ui.core.CSSSize

Gets current value of property height.

Outer height of dialog window. When not set and not constrained by one of the height parameters (minHeight/maxHeight), the window size is automatically adapted to the content.

Returns:
sap.ui.core.CSSSizeValue of property height
getInitialFocus(): sap.ui.core.ID
ID of the element which is the current target of the association initialFocus, or null.
Returns:
sap.ui.core.ID
getKeepInWindow(): boolean

Gets current value of property keepInWindow.

Specifies whether Dialog movement should be restricted to the visible area of the window. This only affects drag&drop movements by the user. This doesn't affect modal dialogs -> modal dialogs always stay in the window.

Default value is false.

Returns:
booleanValue of property keepInWindow
Since:
1.9.0
getMaxHeight(): sap.ui.core.CSSSize

Gets current value of property maxHeight.

Maximum outer height of the dialog window. If set, neither the user nor some layout settings can make the window larger.

Returns:
sap.ui.core.CSSSizeValue of property maxHeight
getMaxWidth(): sap.ui.core.CSSSize

Gets current value of property maxWidth.

Maximum outer width of the dialog window. If set, neither the user nor some layout settings can make the window larger.

Returns:
sap.ui.core.CSSSizeValue of property maxWidth
getMinHeight(): sap.ui.core.CSSSize

Gets current value of property minHeight.

Minimum outer height of the dialog window. When set, neither the user nor some layout settings can make the window smaller.

Returns:
sap.ui.core.CSSSizeValue of property minHeight
getMinWidth(): sap.ui.core.CSSSize

Gets current value of property minWidth.

Minimum outer width of the dialog window. When set, neither the user nor some layout settings can make the window smaller.

Returns:
sap.ui.core.CSSSizeValue of property minWidth
getModal(): boolean

Gets current value of property modal.

Specifies whether the dialog should be modal, or not. In case of true the focus is kept inside the dialog.

Default value is false.

Returns:
booleanValue of property modal
getOpenState(): sap.ui.core.OpenState
Indicates whether the Dialog is currently open, closed, or transitioning between these states.
Returns:
sap.ui.core.OpenState
getResizable(): boolean

Gets current value of property resizable.

Specifies whether the dialog window can be resized by the user. The dialog frame contains the visual symbol.

Default value is true.

Returns:
booleanValue of property resizable
getScrollLeft(): int

Gets current value of property scrollLeft.

Scroll position from left to right. "0" means leftmost position.

Default value is 0.

Returns:
intValue of property scrollLeft
getScrollTop(): int

Gets current value of property scrollTop.

Scroll position from top to bottom. "0" means topmost position.

Default value is 0.

Returns:
intValue of property scrollTop
getShowCloseButton(): boolean

Gets current value of property showCloseButton.

Displays a close button in the title bar.

Default value is true.

Returns:
booleanValue of property showCloseButton
getTitle(): string

Gets current value of property title.

Dialog title displayed in the header.

Default value is .

Returns:
stringValue of property title
getWidth(): sap.ui.core.CSSSize

Gets current value of property width.

Outer width of dialog window. When not set and not constrained by one of the width parameters (minWidth/maxWidth), the window size is automatically adapted to the content.

Returns:
sap.ui.core.CSSSizeValue of property width
indexOfButton(oButton): int
Checks for the provided sap.ui.core.Control in the aggregation buttons. and returns its index if found or -1 otherwise.
Parameters:
sap.ui.core.ControloButtonThe button whose index is looked for
Returns:
intThe 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.ControloContentThe content whose index is looked for
Returns:
intThe index of the provided control in the aggregation if found, or -1 otherwise
insertButton(oButton, iIndex): sap.ui.commons.Dialog
Inserts a button into the aggregation buttons.
Parameters:
sap.ui.core.ControloButtonthe button to insert; if empty, nothing is inserted
intiIndexthe 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
Returns:
sap.ui.commons.DialogReference to this in order to allow method chaining
insertContent(oContent, iIndex): sap.ui.commons.Dialog
Inserts a content into the aggregation content.
Parameters:
sap.ui.core.ControloContentthe content to insert; if empty, nothing is inserted
intiIndexthe 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.ui.commons.DialogReference to this in order to allow method chaining
isOpen(): boolean
Indicates whether the Dialog is open (this includes opening and closing animations). For more detailed information about the current state check Dialog.getOpenState().
Returns:
boolean
open()
Opens the dialog control instance.
removeAllButtons(): sap.ui.core.Control[]

Removes all the controls from the aggregation buttons.

Additionally, it unregisters them from the hosting UIArea.

Returns:
sap.ui.core.Control[]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)
removeButton(vButton): sap.ui.core.Control
Removes a button from the aggregation buttons.
Parameters:
int|string|sap.ui.core.ControlvButtonThe button to remove or its index or id
Returns:
sap.ui.core.ControlThe removed button or null
removeContent(vContent): sap.ui.core.Control
Removes a content from the aggregation content.
Parameters:
int|string|sap.ui.core.ControlvContentThe content to remove or its index or id
Returns:
sap.ui.core.ControlThe removed content or null
setAccessibleRole(sAccessibleRole): sap.ui.commons.Dialog

Sets a new value for property accessibleRole.

The ARIA role for the control. E.g. for alert-style Dialogs this can be set to "AlertDialog".

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

Default value is Dialog.

Parameters:
sap.ui.core.AccessibleRolesAccessibleRoleNew value for property accessibleRole
Returns:
sap.ui.commons.DialogReference to this in order to allow method chaining
setApplyContentPadding(bApplyContentPadding): sap.ui.commons.Dialog

Sets a new value for property applyContentPadding.

Padding is theme-dependent. When set to "false", the content extends to the dialog borders.

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

Default value is true.

Parameters:
booleanbApplyContentPaddingNew value for property applyContentPadding
Returns:
sap.ui.commons.DialogReference to this in order to allow method chaining
setAutoClose(bAutoClose): sap.ui.commons.Dialog

Sets a new value for property autoClose.

If this property is set to true the Dialog will close if the Dialog loses its focus

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

Default value is false.

Parameters:
booleanbAutoCloseNew value for property autoClose
Returns:
sap.ui.commons.DialogReference to this in order to allow method chaining
Since:
1.10
setContentBorderDesign(sContentBorderDesign): sap.ui.commons.Dialog

Sets a new value for property contentBorderDesign.

Specifies the border design. Border design is theme dependent.

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.commons.enums.BorderDesignsContentBorderDesignNew value for property contentBorderDesign
Returns:
sap.ui.commons.DialogReference to this in order to allow method chaining
setDefaultButton(oDefaultButton): sap.ui.commons.Dialog
Sets the associated defaultButton.
Parameters:
sap.ui.core.ID|sap.ui.commons.ButtonoDefaultButtonID of an element which becomes the new target of this defaultButton association; alternatively, an element instance may be given
Returns:
sap.ui.commons.DialogReference to this in order to allow method chaining
setHeight(sHeight): sap.ui.commons.Dialog

Sets a new value for property height.

Outer height of dialog window. When not set and not constrained by one of the height parameters (minHeight/maxHeight), the window size is automatically adapted to the content.

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

Parameters:
sap.ui.core.CSSSizesHeightNew value for property height
Returns:
sap.ui.commons.DialogReference to this in order to allow method chaining
setInitialFocus(oInitialFocus): sap.ui.commons.Dialog
Sets the associated initialFocus.
Parameters:
sap.ui.core.ID|sap.ui.core.ControloInitialFocusID of an element which becomes the new target of this initialFocus association; alternatively, an element instance may be given
Returns:
sap.ui.commons.DialogReference to this in order to allow method chaining
setKeepInWindow(bKeepInWindow): sap.ui.commons.Dialog

Sets a new value for property keepInWindow.

Specifies whether Dialog movement should be restricted to the visible area of the window. This only affects drag&drop movements by the user. This doesn't affect modal dialogs -> modal dialogs always stay in the window.

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

Default value is false.

Parameters:
booleanbKeepInWindowNew value for property keepInWindow
Returns:
sap.ui.commons.DialogReference to this in order to allow method chaining
Since:
1.9.0
setMaxHeight(sMaxHeight): sap.ui.commons.Dialog

Sets a new value for property maxHeight.

Maximum outer height of the dialog window. If set, neither the user nor some layout settings can make the window larger.

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

Parameters:
sap.ui.core.CSSSizesMaxHeightNew value for property maxHeight
Returns:
sap.ui.commons.DialogReference to this in order to allow method chaining
setMaxWidth(sMaxWidth): sap.ui.commons.Dialog

Sets a new value for property maxWidth.

Maximum outer width of the dialog window. If set, neither the user nor some layout settings can make the window larger.

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

Parameters:
sap.ui.core.CSSSizesMaxWidthNew value for property maxWidth
Returns:
sap.ui.commons.DialogReference to this in order to allow method chaining
setMinHeight(sMinHeight): sap.ui.commons.Dialog

Sets a new value for property minHeight.

Minimum outer height of the dialog window. When set, neither the user nor some layout settings can make the window smaller.

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

Parameters:
sap.ui.core.CSSSizesMinHeightNew value for property minHeight
Returns:
sap.ui.commons.DialogReference to this in order to allow method chaining
setMinWidth(sMinWidth): sap.ui.commons.Dialog

Sets a new value for property minWidth.

Minimum outer width of the dialog window. When set, neither the user nor some layout settings can make the window smaller.

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

Parameters:
sap.ui.core.CSSSizesMinWidthNew value for property minWidth
Returns:
sap.ui.commons.DialogReference to this in order to allow method chaining
setModal(bModal): sap.ui.commons.Dialog

Sets a new value for property modal.

Specifies whether the dialog should be modal, or not. In case of true the focus is kept inside the dialog.

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

Default value is false.

Parameters:
booleanbModalNew value for property modal
Returns:
sap.ui.commons.DialogReference to this in order to allow method chaining
setResizable(bResizable): sap.ui.commons.Dialog

Sets a new value for property resizable.

Specifies whether the dialog window can be resized by the user. The dialog frame contains the visual symbol.

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

Default value is true.

Parameters:
booleanbResizableNew value for property resizable
Returns:
sap.ui.commons.DialogReference to this in order to allow method chaining
setScrollLeft(iScrollLeft): sap.ui.commons.Dialog

Sets a new value for property scrollLeft.

Scroll position from left to right. "0" means leftmost position.

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

Default value is 0.

Parameters:
intiScrollLeftNew value for property scrollLeft
Returns:
sap.ui.commons.DialogReference to this in order to allow method chaining
setScrollTop(iScrollTop): sap.ui.commons.Dialog

Sets a new value for property scrollTop.

Scroll position from top to bottom. "0" means topmost position.

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

Default value is 0.

Parameters:
intiScrollTopNew value for property scrollTop
Returns:
sap.ui.commons.DialogReference to this in order to allow method chaining
setShowCloseButton(bShowCloseButton): sap.ui.commons.Dialog

Sets a new value for property showCloseButton.

Displays a close button in the title bar.

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

Default value is true.

Parameters:
booleanbShowCloseButtonNew value for property showCloseButton
Returns:
sap.ui.commons.DialogReference to this in order to allow method chaining
setTitle(sTitle): sap.ui.commons.Dialog

Sets a new value for property title.

Dialog title displayed in the header.

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

Default value is .

Parameters:
stringsTitleNew value for property title
Returns:
sap.ui.commons.DialogReference to this in order to allow method chaining
setWidth(sWidth): sap.ui.commons.Dialog

Sets a new value for property width.

Outer width of dialog window. When not set and not constrained by one of the width parameters (minWidth/maxWidth), the window size is automatically adapted to the content.

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

Parameters:
sap.ui.core.CSSSizesWidthNew value for property width
Returns:
sap.ui.commons.DialogReference to this in order to allow method chaining