buddy-widget

Arguments: up-down-control

Returns the name of the control to which the argument up-down-control, which must be an up-down-control, is attached. That control is called the buddy-widget. A typical buddy widget is an editable-text control with a numeric value. The value can be increased or decreased with the up-down control (as well as typing directly into the text control).

See also the generic function up-down-control.

When designing a form with the IDE, a buddy-widget is connected to an up-down control by clicking on the up-down-control, dragging it over the desired buddy, and dropping it over either the left or the right side of the buddy. A buddy control may be programmatically connected by passing the name of the desired editable-text control as the value of the :buddy-widget initarg when creating the up-down-control, and by passing the name of the up-down-control as the value of the :up-down-control initarg when creating the editable-text control.

Here are the possible values and their effects:

• nil: the up-down-control is not connected to another control.
• another-control-name (some editable-text-box): for any editable-text control with a companion up-down-control, the value of the buddy-widget property for that up-down-control is the name of that editable-text control.

buddy-widget is a property of the up-down-control class.

Copyright (c) 1998-2016, Franz Inc. Oakland, CA., USA. All rights reserved.
This page was not revised from the 8.1 page.
Created 2010.1.21.