8.11 DUIM-Gadgets Module

scrolling

Statement macro

Summary

Places scroll bars around the specified DUIM panes, if required.

Macro call

scrolling ([options]) {pane} end

Arguments

options: Dylan arguments_bnf.
pane: A Dylan expression_bnf.

Values

None.

Library

duim-gadgets

Module

duim-gadgets

Description

Places scroll bars around the DUIM panes created by pane, if required. It is useful to use this macro if you are unsure that the panes created can be displayed on the screen successfully without scroll bars: this macro only adds scroll bars when it is necessary.

Creates pane with scroll bars attached to it, taking into account any of the specified options.

The pane is an expression whose return value is the sheet to which the scroll bars should be attached.

The options can be used to specify the properties of the scroll bars. As well as all the properties of <gadget>, these include a scroll-bars: init-keyword, which may take one of the following values: #f, #"none", #"horizontal", #"vertical", #"both", #"dynamic". If no options are specified, then both vertical and horizontal scroll bars are used.

The pane is a body of code whose return value is the sheet to which the label should be assigned.

Example

scrolling (scroll-bars: #"vertical")
  make(<radio-box>,
  orientation: #"vertical",
  items: range(from: 1, to: 50))
end