scrollbars

Generic Function

Package: common-graphics

Arguments: standard-object

Returns the value of the scrollbars property of the argument. This property is unrelated to the scrolbar controls (horizontal-scroll-bar and vertical-scroll-bar) but instead refers to system-provided scrollbars for certain windows and controls. The value can be nil (no scrollbars), :horizontal and :vertical, scrollbar in the indicated direction only, and t, scrollbars in both directions. For windows other than controls, the page-height and page-width properties control the range of the scrollbars; for controls, the range is determined by the control's contents. Some controls (single-item-list, multi-item-list, and combo-box) cannot have a horizontal scrollbar, so the valid choices are :vertical and nil for those controls. If a horizontal scrollbar is needed on an item-list, an outline control could be used instead, using only top-level items in the range and turning off the draw-icons property to simulate an item-list.

This function is not setfable. The scrollbars of a window or dialog-item must be established with the :scrollbars initarg when it is created, or using the inspector when designing a window or widget on a form.

Note: incompatible change in release 6.0: in releases prior to 6.0, when a frame-with-single-child instance was passed to this operator, the operator was actually applied to the child (the result of applying frame-child to the frame-with-single-child instance). In release 6.0, this redirection no longer occurs. If you intend this operator to apply to the frame-child, pass that to this operator rather than the parent. This is a non-backward-compatible-change. See the release notes for more information.

Common Graphics and IDE documentation is described in About Common Graphics and IDE documentation in cgide.htm.

The documentation is described in introduction.htm and the index is in index.htm.

Copyright (c) 1998-2000, Franz Inc. Berkeley, CA., USA. All rights reserved.

Created 2000.10.5.