Vizard 7 » Command Index » Vizard modules » vizact » <vizact>.whilekeydown
7.6

<vizact>.whilekeydown

Registers a function to handle a key being held down

<vizact>.whilekeydown(  
key  
func  
args  
)  
key
The key to handle
func
The function to call while the key is down
args
The arguments to pass to the function

Remarks

While the specified key is down 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

#Move the viewpoint forward while the up arrow is held down
vizact.whilekeydown(viz.KEY_UP,viz.move,0,0,0.1)

See also

<vizact>.onkeychar
<vizact>.onkeydown
<vizact>.onkeyup