click-off

Arguments: standard-object

Returns the value of the click-off property for its argument. This property determines whether a button can be un-pressed by clicking it when it looks pressed in.

This property applies to button controls that remain depressed after clicking them. Sometimes it is desirable to allow your users to un-press the button by clicking a second time, while other times it is desirable to require some other action such as clicking another button in the same cluster or within the same multi-picture-button.

Here are the possible values and their effects:

• nil: users can only deselect the button by clicking on another button in the same cluster (or by setting the value programmatically).
• t: users can deselect the button by clicking on it again once it has been selected, i.e., the control will toggle on and off.

click-off is a property of the multi-picture-button, picture-button, and radio-button classes.

GTK Note

This property will have no effect on GTK for radio-buttons, since you can never turn a radio-button off by clicking it.

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.