MAXScript Tools and Interaction with 3ds Max > Creating MAXScript Tools > Scripted Utilities and Rollouts >

# 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 via 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 property of the UI item.

    .height

Sets the height of the subrollout. Accessible as 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"
    )
    rollouttest1b "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 doesn't change the position of any UI items below it.

#### See Also

- Rollout User-Interface Items Common Properties

- Rollout User-Interface Items Common Layout Parameters