<vizact>.onbuttondown

Vizard 7 » Command Index » Vizard modules » vizact » <vizact>.onbuttondown

7.6

<vizact>.onbuttondown

Registers a function to handle button down events

<vizact>.onbuttondown(
button
func
*args
)

button

The GUI object to handle

func

The function to call when the GUI object is pressed

*args

The arguments to pass to the function

Remarks

When the specified GUI object is pressed the given function will be called.

Return Value

A vizact.EventFunction object with the following methods:

Method	Description
<event>.setEnabled(val)	Enable/Disable the event function. The associated function will not be called while the event function is disabled. viz.TOGGLE can be used to toggle the state. Event functions are initially enabled.
<event>.getEnabled()	Get the enabled state of the event function.
<event>.remove()	Permanently unregister the event function.

Example

check = viz.add(viz.CHECKBOX)

#The checkbox will control if collision is enabled
vizact.onbuttondown(check,viz.collision,viz.ON)
vizact.onbuttonup(check,viz.collision,viz.OFF)