widgets-to-move

Arguments: split-bar

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

This property specifies which widgets and panes on the split-bar's parent window should automatically be moved 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-move initarg to make-instance, or any time later by call (setf widgets-to-move).

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 moved as needed so that they maintain the same distance from the split-bar. For widgets that should be resized instead, use widgets-to-resize.

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.