API reference - Class ButtonState

Notation used in Ruby API documentation

Description: The namespace for the button state flags in the mouse events of the Plugin class.

This class defines the constants for the button state. In the event handler, the button state is indicated by a bitwise combination of these constants. See Plugin for further details. This class has been introduced in version 0.22.

Public constructors

ButtonStatenewCreates a new object of this class

Public methods

[const]voidassign(const ButtonState other)Assign the contents of another object to self
voidcreateEnsures the C++ object is created
voiddestroyExplicitly destroy the object
[const]booldestroyed?Returns a value indicating whether the object was already destroyed
[const]ButtonStatedupCreates a copy of self
[const]boolis_const_object?Returns a value indicating whether the reference is a const reference

Public static methods and constants

intAltKeyIndicates that the Alt key is pressed
intControlKeyIndicates that the Control key is pressed
intLeftButtonIndicates that the left mouse button is pressed
intMidButtonIndicates that the middle mouse button is pressed
intRightButtonIndicates that the right mouse button is pressed
intShiftKeyIndicates that the Shift key is pressed

Detailed description

[static] int AltKey

Description: Indicates that the Alt key is pressed

This constant is combined with other constants within ButtonState

[static] int ControlKey

Description: Indicates that the Control key is pressed

This constant is combined with other constants within ButtonState

[static] int LeftButton

Description: Indicates that the left mouse button is pressed

This constant is combined with other constants within ButtonState

[static] int MidButton

Description: Indicates that the middle mouse button is pressed

This constant is combined with other constants within ButtonState

[static] int RightButton

Description: Indicates that the right mouse button is pressed

This constant is combined with other constants within ButtonState

[static] int ShiftKey

Description: Indicates that the Shift key is pressed

This constant is combined with other constants within ButtonState

[const] void assign(const ButtonState other)

Description: Assign the contents of another object to self

This method assigns the contents of another object to self. This is a deep copy that does not only copy the reference but the actual content.

void create

Description: Ensures the C++ object is created

Use this method to ensure the C++ object is created, for example to ensure that resources are allocated. Usually C++ objects are created on demand and not necessarily when the script object is created.

void destroy

Description: Explicitly destroy the object

Explicitly destroy the object on C++ side if it was owned by the Ruby interpreter. Subsequent access to this object will throw an exception. If the object is not owned by Ruby, this method will do nothing.

[const] bool destroyed?

Description: Returns a value indicating whether the object was already destroyed

This method returns true, if the object was destroyed, either explicitly or by the C++ side. The latter may happen, if the object is owned by a C++ object which got destroyed itself.

[const] ButtonState dup

Description: Creates a copy of self

[const] bool is_const_object?

Description: Returns a value indicating whether the reference is a const reference

This method returns true, if self is a const reference. In that case, only const methods may be called on self.

[static] ButtonState new

Description: Creates a new object of this class