View Source wxJoystickEvent (wx v2.4.2)

Functions for wxJoystickEvent class

This event class contains information about joystick events, particularly events received by windows.

See: wxJoystick (not implemented in wx)

This class is derived (and can use functions) from: wxEvent

wxWidgets docs: wxJoystickEvent

Events

Use wxEvtHandler:connect/3 with wxJoystickEventType to subscribe to events of this type.

Summary

Functions

Returns true if the event was a down event from the specified button (or any button).

Returns true if the specified button (or any button) was in a down state.

Returns true if the event was an up event from the specified button (or any button).

Returns the identifier of the button changing state.

Returns the down state of the buttons.

Returns the identifier of the joystick generating the event - one of wxJOYSTICK1 and wxJOYSTICK2.

Returns the x, y position of the joystick event.

Returns the z position of the joystick event.

Returns true if this was a button up or down event (not 'is any button down?').

Returns true if this was an x, y move event.

Returns true if this was a z move event.

Types

-type wxJoystick() ::
          #wxJoystick{type :: wxJoystickEvent:wxJoystickEventType(),
                      pos :: {X :: integer(), Y :: integer()},
                      zPosition :: integer(),
                      buttonChange :: integer(),
                      buttonState :: integer(),
                      joyStick :: integer()}.
-type wxJoystickEvent() :: wx:wx_object().
-type wxJoystickEventType() :: joy_button_down | joy_button_up | joy_move | joy_zmove.

Functions

-spec buttonDown(This) -> boolean() when This :: wxJoystickEvent().
-spec buttonDown(This, [Option]) -> boolean() when This :: wxJoystickEvent(), Option :: {but, integer()}.

Returns true if the event was a down event from the specified button (or any button).

-spec buttonIsDown(This) -> boolean() when This :: wxJoystickEvent().
-spec buttonIsDown(This, [Option]) -> boolean()
                      when This :: wxJoystickEvent(), Option :: {but, integer()}.

Returns true if the specified button (or any button) was in a down state.

-spec buttonUp(This) -> boolean() when This :: wxJoystickEvent().
-spec buttonUp(This, [Option]) -> boolean() when This :: wxJoystickEvent(), Option :: {but, integer()}.

Returns true if the event was an up event from the specified button (or any button).

-spec getButtonChange(This) -> integer() when This :: wxJoystickEvent().

Returns the identifier of the button changing state.

The return value is where n is the index of the button changing state, which can also be retrieved using GetButtonOrdinal() (not implemented in wx).

Note that for n equal to 1, 2, 3 or 4 there are predefined wxJOY_BUTTONn constants which can be used for more clarity, however these constants are not defined for the buttons beyond the first four.

-spec getButtonState(This) -> integer() when This :: wxJoystickEvent().

Returns the down state of the buttons.

This is a wxJOY_BUTTONn identifier, where n is one of 1, 2, 3, 4.

-spec getJoystick(This) -> integer() when This :: wxJoystickEvent().

Returns the identifier of the joystick generating the event - one of wxJOYSTICK1 and wxJOYSTICK2.

-spec getPosition(This) -> {X :: integer(), Y :: integer()} when This :: wxJoystickEvent().

Returns the x, y position of the joystick event.

These coordinates are valid for all the events except wxEVT_JOY_ZMOVE.

-spec getZPosition(This) -> integer() when This :: wxJoystickEvent().

Returns the z position of the joystick event.

This method can only be used for wxEVT_JOY_ZMOVE events.

-spec isButton(This) -> boolean() when This :: wxJoystickEvent().

Returns true if this was a button up or down event (not 'is any button down?').

-spec isMove(This) -> boolean() when This :: wxJoystickEvent().

Returns true if this was an x, y move event.

-spec isZMove(This) -> boolean() when This :: wxJoystickEvent().

Returns true if this was a z move event.