This element specifies when a scrollbar shall be visible for the contents of the current frame. When this element is set, the val attribute determines exactly when the scrollbar shall be visible. This property is analogous to the scrolling attribute on the frame element in HTML.

If this element is omitted, the scrollbar shall only be displayed when the contents of the frame exceed the visible space for the frame (i.e. when the scrollbar is needed to display all of the content).

[Example: Consider a WordprocessingML document which serves as the frameset container for a frameset consisting of the following three frames:

The frameset properties for this document are specified by the following WordprocessingML within the web page settings:

<w:frameset>

…

<w:frameset>

…
<w:frame>
<w:name w:val="Frame 2" />
<w:scrollbar w:val="auto" />
</w:frame>
…

</w:frameset>

The scrollbar element has a val attribute of auto, which specifies that the frame shall only display a scrollbar when it is needed to display all of its content. end example]

Parent Elements

frame (§2.15.2.16)

Attributes

Description

val (Scrollbar Display Option Value)

Specifies the criteria under which a scrollbar shall be displayed along with the contents of this frameset, as defined by the simple type referenced below.

[Example: Consider a frameset definition within a WordprocessingML document which defines the following scrollbar visibility setting:

<w:frame>
<w:scrollbar w:val="on" />
…
</w:frame>

The val attribute value of on specifies that the scrollbar shall always be displayed, even when it is not needed (i.e. when it would be displayed disabled). end example]

The possible values for this attribute are defined by the ST_FrameScrollbar simple type (§2.18.36).

The following XML Schema fragment defines the contents of this element:

</complexType>