Script wrapper for QScrollArea.

More...

Inherits :

• QObject
  • DzWidget

Provides a scrolling view of another widget.

Since:

• 4.6.2.51

DzWidget::AlignmentFlags : alignment

Holds the alignment of the widget.

Size : maximumViewportSize

Holds the size of the viewport as if the scroll bars had no valid scrolling range. (Read Only)

Since:

• 4.9.3.93

Boolean : widgetResizable

Holds whether the scroll area should resize the view widget.

DzScrollArea( DzWidget parent )

Creates a scroll area as a child of the given parent widget.

Parameter(s):

• parent - The widget parent for the scroll area.

void : ensureVisible( Number x, Number y, Number xmargin=50, Number ymargin=50 )

Scrolls the contents of the scroll area so that childWidget is visible inside the viewport with margins specified in pixels by xmargin and ymargin. If the specified point cannot be reached, the contents are scrolled to the nearest valid position.

Parameter(s):

• x - The x coordinate.
• y - The y coordinate.
• xmargin - The margin in the horizontal direction.
• ymargin - The margin in the vertical direction.

void : ensureWidgetVisible( DzWidget childWidget, Number xmargin=50, Number ymargin=50 )

Scrolls the contents of the scroll area so that childWidget is visible inside the viewport with margins specified in pixels by xmargin and ymargin. If the specified point cannot be reached, the contents are scrolled to the nearest valid position.

Parameter(s):

• childWidget - The child to scroll to.
• xmargin - The margin in the horizontal direction.
• ymargin - The margin in the vertical direction.

void : hideFrame()

Hides the frame around the scroll area.

void : setHorizontalScrollbarDisplay( Boolean onOff )

Sets whether to display the horizontal scrollbar.

Parameter(s):

• onOff - If true, the horizontal scrollbar is always displayed. If false, the horizontal scrollbar is never displayed.

void : setVerticalScrollbarDisplay( Boolean onOff )

Sets whether to display the vertical scrollbar.

Parameter(s):

• onOff - If true, the vertical scrollbar is always displayed. If false, the vertical scrollbar is never displayed.

void : setWidget( DzWidget widget )

Sets the contents of the scroll area to a widget.

Parameter(s):

• widget - The widget to set as a child of the scroll area; this widget will be destroyed when the scroll area is deleted or when a new widget is set.