widgets-to-resize

Arguments: split-bar

Returns the widgets-to-resize property of a split-bar widget. The value may be set at creation time by passing the :widgets-to-resize initarg to make-instance, or any time later by call (setf widgets-to-resize).

This property specifies which widgets and panes on the split-bar's parent window should automatically be resized when the split-bar is moved.

The value should be a list of the names of zero or more of the other widgets (see dialog-item) and/or panes (see basic-pane) that are on the same parent window as the split-bar. The default value is nil. The value may be set at creation time by passing the :widgets-to-resize initarg to make-instance, or any time later by call (setf widgets-to-resize).

When the user drags the split-bar (or the bar is moved programmatically by calling (setf value)), the widgets and panes in this list will be resized as needed so that their edges that are nearest the split-bar will maintain the same distance from the split-bar. It is a good idea to set the split-bar's min-space-before and/or min-space-after properties to avoid resizing widgets and panes too small.

For widgets that should be moved instead, use widgets-to-move.

If this behavior is not adequate, customized effects of dragging a split-bar can be effected by giving the split-bar an on-change function that performs arbitrary side effects.

Copyright (c) 1998-2016, Franz Inc. Oakland, CA., USA. All rights reserved.
This page is new in the 8.2 release.
Created 2016.6.21.