SubRollout Class

User Interface Controls > Common Properties > Layout > Types > SubRollout

Creating User Interfaces - Quick Navigation

SubRollout is a Subclass of RolloutControl. All Rollout User-Interface Controls Common Properties and Rollout User-Interface Controls Common Layout Parameters should apply.

Description

A UI item which you can place rollouts into. No caption is displayed for the UI item. On right side of the UI item, a scrollbar is displayed if the height of the rollout(s) in the item is greater than the height of the item.

Properties

.rollouts

The rollouts installed in the SubRollout control using AddSubRollout (see notes below). Read-only. The names of the installed rollouts are exposed as read-only properties.

Notes on common UI item properties:

.caption

None displayed. Read/write.

.text

None displayed. Read/write.

.enabled

Setting has no effect. Always set to true. Read/Write.

.pos

The position of the UI item in the rollout. Read/write.

.align

UI item alignment. Creation only property.

.offset

UI item offset. Creation only property.

.width

Sets the width of the subrollout. Accessible as a property of the UI item.

.height

Sets the height of the subrollout. Accessible as a property of the UI item.

.across

Number of UI items across. Creation only parameter.

Associated Methods

addSubRollout <subrollout> <rollout> [rolledUp:<boolean>]

Adds the rollout to the subrollout. Always returns ok.

removeSubRollout <subrollout> <rollout>

Removes the rollout from the subrollout. Always returns ok.

EXAMPLE

rollout test "test" height:200
(
  subrollout test1 "test1"
  subrollout test2 "test2"
)
rollout test1a "test1a"
(
  spinner test1as "test1as"
)
rollout test1b "test1b"
(
  spinner test1bs "test1bs"
)
createdialog test
AddSubRollout test.test1 test1a
AddSubRollout test.test1 test1b
test.test1.height += 100
test.test2.pos += [0,100]
rollout test2a "test2a"
(
  spinner test2as "test2as"
)
AddSubRollout test.test2 test2a
test.test2.height += 50

NOTE:

Changing the height of a subRollout does not change the position of any UI items below it.

SubRollout Class

Notes on common UI item properties:

See Also