.. wxPython Phoenix documentation
This file was generated by Phoenix's sphinx generator and associated
tools, do not edit by hand.
Copyright: (c) 2011-2020 by Total Control Software
License: wxWindows License
.. include:: headings.inc
.. _wx.MouseState:
==========================================================================================================================================
|phoenix_title| **wx.MouseState**
==========================================================================================================================================
Represents the mouse state.
This class is used as a base class by :ref:`wx.MouseEvent` and so its methods may be used to obtain information about the mouse state for the mouse events. It also inherits from :ref:`wx.KeyboardState` and so carries information about the keyboard state and not only the mouse one.
This class is implemented entirely inline in <`/mousestate.h` > and thus has no linking requirements.
.. seealso:: `wx.GetMouseState` , :ref:`wx.MouseEvent`
|
|class_hierarchy| Class Hierarchy
=================================
.. raw:: html

Inheritance diagram for class
MouseState:
|
|sub_classes| Known Subclasses
==============================
:ref:`wx.MouseEvent`
|
|method_summary| Methods Summary
================================
================================================================================ ================================================================================
:meth:`~wx.MouseState.__init__` Default constructor.
:meth:`~wx.MouseState.Aux1IsDown` Returns ``True`` if the first extra button mouse button is currently down.
:meth:`~wx.MouseState.Aux2IsDown` Returns ``True`` if the second extra button mouse button is currently down.
:meth:`~wx.MouseState.GetPosition` Returns the physical mouse position.
:meth:`~wx.MouseState.GetX` Returns X coordinate of the physical mouse event position.
:meth:`~wx.MouseState.GetY` Returns Y coordinate of the physical mouse event position.
:meth:`~wx.MouseState.LeftIsDown` Returns ``True`` if the left mouse button is currently down.
:meth:`~wx.MouseState.MiddleIsDown` Returns ``True`` if the middle mouse button is currently down.
:meth:`~wx.MouseState.RightIsDown` Returns ``True`` if the right mouse button is currently down.
:meth:`~wx.MouseState.SetAux1Down`
:meth:`~wx.MouseState.SetAux2Down`
:meth:`~wx.MouseState.SetLeftDown`
:meth:`~wx.MouseState.SetMiddleDown`
:meth:`~wx.MouseState.SetPosition`
:meth:`~wx.MouseState.SetRightDown`
:meth:`~wx.MouseState.SetState`
:meth:`~wx.MouseState.SetX`
:meth:`~wx.MouseState.SetY`
================================================================================ ================================================================================
|
|property_summary| Properties Summary
=====================================
================================================================================ ================================================================================
:attr:`~wx.MouseState.Position` See :meth:`~wx.MouseState.GetPosition` and :meth:`~wx.MouseState.SetPosition`
:attr:`~wx.MouseState.X` See :meth:`~wx.MouseState.GetX` and :meth:`~wx.MouseState.SetX`
:attr:`~wx.MouseState.Y` See :meth:`~wx.MouseState.GetY` and :meth:`~wx.MouseState.SetY`
:attr:`~wx.MouseState.aux1IsDown` See :meth:`~wx.MouseState.Aux1IsDown` and :meth:`~wx.MouseState.SetAux1Down`
:attr:`~wx.MouseState.aux2IsDown` See :meth:`~wx.MouseState.Aux2IsDown` and :meth:`~wx.MouseState.SetAux2Down`
:attr:`~wx.MouseState.leftIsDown` See :meth:`~wx.MouseState.LeftIsDown` and :meth:`~wx.MouseState.SetLeftDown`
:attr:`~wx.MouseState.middleIsDown` See :meth:`~wx.MouseState.MiddleIsDown` and :meth:`~wx.MouseState.SetMiddleDown`
:attr:`~wx.MouseState.rightIsDown` See :meth:`~wx.MouseState.RightIsDown` and :meth:`~wx.MouseState.SetRightDown`
:attr:`~wx.MouseState.x` See :meth:`~wx.MouseState.GetX` and :meth:`~wx.MouseState.SetX`
:attr:`~wx.MouseState.y` See :meth:`~wx.MouseState.GetY` and :meth:`~wx.MouseState.SetY`
================================================================================ ================================================================================
|
|api| Class API
===============
.. class:: wx.MouseState(KeyboardState)
**Possible constructors**::
MouseState() -> None
Represents the mouse state.
.. method:: __init__(self)
Default constructor.
:rtype: `None`
.. method:: Aux1IsDown(self)
Returns ``True`` if the first extra button mouse button is currently down.
:rtype: `bool`
.. method:: Aux2IsDown(self)
Returns ``True`` if the second extra button mouse button is currently down.
:rtype: `bool`
.. method:: GetPosition(self)
Returns the physical mouse position.
:rtype: :ref:`wx.Point`
.. method:: GetX(self)
Returns X coordinate of the physical mouse event position.
:rtype: `int`
.. method:: GetY(self)
Returns Y coordinate of the physical mouse event position.
:rtype: `int`
.. method:: LeftIsDown(self)
Returns ``True`` if the left mouse button is currently down.
:rtype: `bool`
.. method:: MiddleIsDown(self)
Returns ``True`` if the middle mouse button is currently down.
:rtype: `bool`
.. method:: RightIsDown(self)
Returns ``True`` if the right mouse button is currently down.
:rtype: `bool`
.. method:: SetAux1Down(self, down : bool)
:param `down`:
:type `down`: bool
:rtype: `None`
.. method:: SetAux2Down(self, down : bool)
:param `down`:
:type `down`: bool
:rtype: `None`
.. method:: SetLeftDown(self, down : bool)
:param `down`:
:type `down`: bool
:rtype: `None`
.. method:: SetMiddleDown(self, down : bool)
:param `down`:
:type `down`: bool
:rtype: `None`
.. method:: SetPosition(self, pos : Point)
:param `pos`:
:type `pos`: wx.Point
:rtype: `None`
.. method:: SetRightDown(self, down : bool)
:param `down`:
:type `down`: bool
:rtype: `None`
.. method:: SetState(self, state : MouseState)
:param `state`:
:type `state`: wx.MouseState
:rtype: `None`
.. method:: SetX(self, x : int)
:param `x`:
:type `x`: int
:rtype: `None`
.. method:: SetY(self, y : int)
:param `y`:
:type `y`: int
:rtype: `None`
.. attribute:: Position
See :meth:`~wx.MouseState.GetPosition` and :meth:`~wx.MouseState.SetPosition`
.. attribute:: X
See :meth:`~wx.MouseState.GetX` and :meth:`~wx.MouseState.SetX`
.. attribute:: Y
See :meth:`~wx.MouseState.GetY` and :meth:`~wx.MouseState.SetY`
.. attribute:: aux1IsDown
See :meth:`~wx.MouseState.Aux1IsDown` and :meth:`~wx.MouseState.SetAux1Down`
.. attribute:: aux2IsDown
See :meth:`~wx.MouseState.Aux2IsDown` and :meth:`~wx.MouseState.SetAux2Down`
.. attribute:: leftIsDown
See :meth:`~wx.MouseState.LeftIsDown` and :meth:`~wx.MouseState.SetLeftDown`
.. attribute:: middleIsDown
See :meth:`~wx.MouseState.MiddleIsDown` and :meth:`~wx.MouseState.SetMiddleDown`
.. attribute:: rightIsDown
See :meth:`~wx.MouseState.RightIsDown` and :meth:`~wx.MouseState.SetRightDown`
.. attribute:: x
See :meth:`~wx.MouseState.GetX` and :meth:`~wx.MouseState.SetX`
.. attribute:: y
See :meth:`~wx.MouseState.GetY` and :meth:`~wx.MouseState.SetY`