Vizard 8 » Command Index » Vizard modules » vizact » <vizact>.onbuttonup
8.0

<vizact>.onbuttonup

Registers a function to handle button up events

<vizact>.onbuttonup(  
button  
func  
*args  
)  
button
The GUI object to handle
func
The function to call when the GUI object is released
*args
The arguments to pass to the function

Remarks

When the specified GUI object is released 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)
ball = viz.add('ball.wrl')

#The checkbox will control the visibility of the ball
vizact.onbuttondown(check,ball.visible,viz.ON)
vizact.onbuttonup(check,ball.visible,viz.OFF)

See also

<vizact>.onbuttondown
<vizact>.onlist
<vizact>.onslider
<vizact>.ontextbox