<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<!-- /home/espenr/tmp/qt - 3.3.8 - espenr - 2499/qt - x11 - free - 3.3.8/src/kernel/qevent.cpp:244 -->
< html >
< head >
< meta http-equiv = "Content-Type" content = "text/html; charset=ISO-8859-1" >
< title > TQMouseEvent Class< / title >
< style type = "text/css" > < ! - -
fn { margin-left: 1cm; text-indent: -1cm; }
a:link { color: #004faf; text-decoration: none }
a:visited { color: #672967; text-decoration: none }
body { background: #ffffff; color: black; }
-->< / style >
< / head >
< body >
< table border = "0" cellpadding = "0" cellspacing = "0" width = "100%" >
< tr bgcolor = "#E5E5E5" >
< td valign = center >
< a href = "index.html" >
< font color = "#004faf" > Home< / font > < / a >
| < a href = "classes.html" >
< font color = "#004faf" > All Classes< / font > < / a >
| < a href = "mainclasses.html" >
< font color = "#004faf" > Main Classes< / font > < / a >
| < a href = "annotated.html" >
< font color = "#004faf" > Annotated< / font > < / a >
| < a href = "groups.html" >
< font color = "#004faf" > Grouped Classes< / font > < / a >
| < a href = "functions.html" >
< font color = "#004faf" > Functions< / font > < / a >
< / td >
< td align = "right" valign = "center" > < img src = "logo32.png" align = "right" width = "64" height = "32" border = "0" > < / td > < / tr > < / table > < h1 align = center > TQMouseEvent Class Reference< / h1 >
< p > The TQMouseEvent class contains parameters that describe a mouse event.
< a href = "#details" > More...< / a >
< p > < tt > #include < < a href = "qevent-h.html" > ntqevent.h< / a > > < / tt >
< p > Inherits < a href = "ntqevent.html" > TQEvent< / a > .
< p > < a href = "qmouseevent-members.html" > List of all member functions.< / a >
< h2 > Public Members< / h2 >
< ul >
< li class = fn > < a href = "#TQMouseEvent" > < b > TQMouseEvent< / b > < / a > ( Type type, const TQPoint & pos, int button, int state )< / li >
< li class = fn > < a href = "#TQMouseEvent-2" > < b > TQMouseEvent< / b > < / a > ( Type type, const TQPoint & pos, const TQPoint & globalPos, int button, int state )< / li >
< li class = fn > const TQPoint & < a href = "#pos" > < b > pos< / b > < / a > () const< / li >
< li class = fn > const TQPoint & < a href = "#globalPos" > < b > globalPos< / b > < / a > () const< / li >
< li class = fn > int < a href = "#x" > < b > x< / b > < / a > () const< / li >
< li class = fn > int < a href = "#y" > < b > y< / b > < / a > () const< / li >
< li class = fn > int < a href = "#globalX" > < b > globalX< / b > < / a > () const< / li >
< li class = fn > int < a href = "#globalY" > < b > globalY< / b > < / a > () const< / li >
< li class = fn > ButtonState < a href = "#button" > < b > button< / b > < / a > () const< / li >
< li class = fn > ButtonState < a href = "#state" > < b > state< / b > < / a > () const< / li >
< li class = fn > ButtonState < a href = "#stateAfter" > < b > stateAfter< / b > < / a > () const< / li >
< li class = fn > bool < a href = "#isAccepted" > < b > isAccepted< / b > < / a > () const< / li >
< li class = fn > void < a href = "#accept" > < b > accept< / b > < / a > ()< / li >
< li class = fn > void < a href = "#ignore" > < b > ignore< / b > < / a > ()< / li >
< / ul >
< hr > < a name = "details" > < / a > < h2 > Detailed Description< / h2 >
< p > The TQMouseEvent class contains parameters that describe a mouse event.
< p > Mouse events occur when a mouse button is pressed or released
inside a widget or when the mouse cursor is moved.
< p > Mouse move events will occur only when a mouse button is pressed
down, unless mouse tracking has been enabled with
< a href = "ntqwidget.html#setMouseTracking" > TQWidget::setMouseTracking< / a > ().
< p > TQt automatically grabs the mouse when a mouse button is pressed
inside a widget; the widget will continue to receive mouse events
until the last mouse button is released.
< p > A mouse event contains a special accept flag that indicates
whether the receiver wants the event. You should call
< a href = "#ignore" > TQMouseEvent::ignore< / a > () if the mouse event is not handled by your
widget. A mouse event is propagated up the parent widget chain
until a widget accepts it with < a href = "#accept" > TQMouseEvent::accept< / a > () or an event
filter consumes it.
< p > The functions < a href = "#pos" > pos< / a > (), < a href = "#x" > x< / a > () and < a href = "#y" > y< / a > () give the cursor position relative
to the widget that receives the mouse event. If you move the
widget as a result of the mouse event, use the global position
returned by < a href = "#globalPos" > globalPos< / a > () to avoid a shaking motion.
< p > The < a href = "ntqwidget.html#setEnabled" > TQWidget::setEnabled< / a > () function can be used to enable or
disable mouse and keyboard events for a widget.
< p > The event handlers < a href = "ntqwidget.html#mousePressEvent" > TQWidget::mousePressEvent< / a > (),
< a href = "ntqwidget.html#mouseReleaseEvent" > TQWidget::mouseReleaseEvent< / a > (), < a href = "ntqwidget.html#mouseDoubleClickEvent" > TQWidget::mouseDoubleClickEvent< / a > () and
< a href = "ntqwidget.html#mouseMoveEvent" > TQWidget::mouseMoveEvent< / a > () receive mouse events.
< p > < p > See also < a href = "ntqwidget.html#mouseTracking-prop" > TQWidget::mouseTracking< / a > , < a href = "ntqwidget.html#grabMouse" > TQWidget::grabMouse< / a > (), < a href = "ntqcursor.html#pos" > TQCursor::pos< / a > (), and < a href = "events.html" > Event Classes< / a > .
< hr > < h2 > Member Function Documentation< / h2 >
< h3 class = fn > < a name = "TQMouseEvent" > < / a > TQMouseEvent::TQMouseEvent ( < a href = "ntqevent.html#Type-enum" > Type< / a > type, const < a href = "ntqpoint.html" > TQPoint< / a > & pos, int button, int state )
< / h3 >
< p > Constructs a mouse event object.
< p > The < em > type< / em > parameter must be one of < a href = "ntqevent.html#Type-enum" > TQEvent::MouseButtonPress< / a > ,
< a href = "ntqevent.html#Type-enum" > TQEvent::MouseButtonRelease< / a > , < a href = "ntqevent.html#Type-enum" > TQEvent::MouseButtonDblClick< / a > or
< a href = "ntqevent.html#Type-enum" > TQEvent::MouseMove< / a > .
< p > The < em > pos< / em > parameter specifies the position relative to the
receiving widget. < em > button< / em > specifies the < a href = "ntqt.html#ButtonState-enum" > button< / a > that caused the event, which should be < a href = "ntqt.html#ButtonState-enum" > TQt::NoButton< / a > (0), if < em > type< / em > is < a href = "ntqevent.html#Type-enum" > MouseMove< / a > . < em > state< / em > is the
< a href = "ntqt.html#ButtonState-enum" > ButtonState< / a > at the time of the
event.
< p > The < a href = "#globalPos" > globalPos< / a > () is initialized to < a href = "ntqcursor.html#pos" > TQCursor::pos< / a > (), which may not be
appropriate. Use the other constructor to specify the global
position explicitly.
< h3 class = fn > < a name = "TQMouseEvent-2" > < / a > TQMouseEvent::TQMouseEvent ( < a href = "ntqevent.html#Type-enum" > Type< / a > type, const < a href = "ntqpoint.html" > TQPoint< / a > & pos, const < a href = "ntqpoint.html" > TQPoint< / a > & globalPos, int button, int state )
< / h3 >
< p > Constructs a mouse event object.
< p > The < em > type< / em > parameter must be < a href = "ntqevent.html#Type-enum" > TQEvent::MouseButtonPress< / a > , < a href = "ntqevent.html#Type-enum" > TQEvent::MouseButtonRelease< / a > , < a href = "ntqevent.html#Type-enum" > TQEvent::MouseButtonDblClick< / a > or < a href = "ntqevent.html#Type-enum" > TQEvent::MouseMove< / a > .
< p > The < em > pos< / em > parameter specifies the position relative to the
receiving widget. < em > globalPos< / em > is the position in absolute
coordinates. < em > button< / em > specifies the < a href = "ntqt.html#ButtonState-enum" > button< / a > that caused the event, which should be < a href = "ntqt.html#ButtonState-enum" > TQt::NoButton< / a > (0), if < em > type< / em > is < a href = "ntqevent.html#Type-enum" > MouseMove< / a > . < em > state< / em > is the
< a href = "ntqt.html#ButtonState-enum" > ButtonState< / a > at the time of the
event.
< p >
< h3 class = fn > void < a name = "accept" > < / a > TQMouseEvent::accept ()
< / h3 >
< p > Sets the accept flag of the mouse event object.
< p > Setting the accept parameter indicates that the receiver of the
event wants the mouse event. Unwanted mouse events are sent to the
parent widget.
< p > The accept flag is set by default.
< p > < p > See also < a href = "#ignore" > ignore< / a > ().
< h3 class = fn > < a href = "ntqt.html#ButtonState-enum" > ButtonState< / a > < a name = "button" > < / a > TQMouseEvent::button () const
< / h3 >
< p > Returns the button that caused the event.
< p > Possible return values are < a href = "ntqt.html#ButtonState-enum" > LeftButton< / a > , < a href = "ntqt.html#ButtonState-enum" > RightButton< / a > , < a href = "ntqt.html#ButtonState-enum" > MidButton< / a > and < a href = "ntqt.html#ButtonState-enum" > NoButton< / a > .
< p > Note that the returned value is always < a href = "ntqt.html#ButtonState-enum" > NoButton< / a > for mouse move
events.
< p > < p > See also < a href = "#state" > state< / a > () and < a href = "ntqt.html#ButtonState-enum" > TQt::ButtonState< / a > .
< p > Examples: < a href = "dclock-example.html#x1101" > dclock/dclock.cpp< / a > , < a href = "life-example.html#x1890" > life/life.cpp< / a > , and < a href = "tutorial1-14.html#x2417" > t14/cannon.cpp< / a > .
< h3 class = fn > const < a href = "ntqpoint.html" > TQPoint< / a > & < a name = "globalPos" > < / a > TQMouseEvent::globalPos () const
< / h3 >
< p > Returns the global position of the mouse pointer < em > at the time of the event< / em > . This is important on asynchronous window systems
like X11. Whenever you move your widgets around in response to
mouse events, < a href = "#globalPos" > globalPos< / a > () may differ a lot from the current
pointer position < a href = "ntqcursor.html#pos" > TQCursor::pos< / a > (), and from < a href = "ntqwidget.html#mapToGlobal" > TQWidget::mapToGlobal< / a > (
< a href = "#pos" > pos< / a > () ).
< p > < p > See also < a href = "#globalX" > globalX< / a > () and < a href = "#globalY" > globalY< / a > ().
< p > Example: < a href = "aclock-example.html#x1181" > aclock/aclock.cpp< / a > .
< h3 class = fn > int < a name = "globalX" > < / a > TQMouseEvent::globalX () const
< / h3 >
< p > Returns the global x-position of the mouse pointer at the time of
the event.
< p > < p > See also < a href = "#globalY" > globalY< / a > () and < a href = "#globalPos" > globalPos< / a > ().
< h3 class = fn > int < a name = "globalY" > < / a > TQMouseEvent::globalY () const
< / h3 >
< p > Returns the global y-position of the mouse pointer at the time of
the event.
< p > < p > See also < a href = "#globalX" > globalX< / a > () and < a href = "#globalPos" > globalPos< / a > ().
< h3 class = fn > void < a name = "ignore" > < / a > TQMouseEvent::ignore ()
< / h3 >
< p > Clears the accept flag parameter of the mouse event object.
< p > Clearing the accept parameter indicates that the event receiver
does not want the mouse event. Unwanted mouse events are sent to
the parent widget.
< p > The accept flag is set by default.
< p > < p > See also < a href = "#accept" > accept< / a > ().
< h3 class = fn > bool < a name = "isAccepted" > < / a > TQMouseEvent::isAccepted () const
< / h3 >
< p > Returns TRUE if the receiver of the event wants to keep the key;
otherwise returns FALSE.
< h3 class = fn > const < a href = "ntqpoint.html" > TQPoint< / a > & < a name = "pos" > < / a > TQMouseEvent::pos () const
< / h3 >
< p > Returns the position of the mouse pointer relative to the widget
that received the event.
< p > If you move the widget as a result of the mouse event, use the
global position returned by < a href = "#globalPos" > globalPos< / a > () to avoid a shaking motion.
< p > < p > See also < a href = "#x" > x< / a > (), < a href = "#y" > y< / a > (), and < a href = "#globalPos" > globalPos< / a > ().
< p > Examples: < a href = "tutorial2-06.html#x2580" > chart/canvasview.cpp< / a > , < a href = "drawlines-example.html#x1654" > drawlines/connect.cpp< / a > , < a href = "life-example.html#x1891" > life/life.cpp< / a > , < a href = "popup-example.html#x1611" > popup/popup.cpp< / a > , < a href = "qmag-example.html#x1780" > qmag/qmag.cpp< / a > , < a href = "tutorial1-14.html#x2418" > t14/cannon.cpp< / a > , and < a href = "tooltip-example.html#x443" > tooltip/tooltip.cpp< / a > .
< h3 class = fn > < a href = "ntqt.html#ButtonState-enum" > ButtonState< / a > < a name = "state" > < / a > TQMouseEvent::state () const
< / h3 >
< p > Returns the button state (a combination of mouse buttons and
keyboard modifiers), i.e. what buttons and keys were being pressed
immediately before the event was generated.
< p > This means that if you have a < a href = "ntqevent.html#Type-enum" > TQEvent::MouseButtonPress< / a > or a < a href = "ntqevent.html#Type-enum" > TQEvent::MouseButtonDblClick< / a > < a href = "#state" > state< / a > () will < em > not< / em > include the mouse
button that's pressed. But once the mouse button has been
released, the < a href = "ntqevent.html#Type-enum" > TQEvent::MouseButtonRelease< / a > event will have the
< a href = "#button" > button< / a > () that was pressed.
< p > This value is mainly interesting for < a href = "ntqevent.html#Type-enum" > TQEvent::MouseMove< / a > ; for the
other cases, button() is more useful.
< p > The returned value is < a href = "ntqt.html#ButtonState-enum" > LeftButton< / a > , < a href = "ntqt.html#ButtonState-enum" > RightButton< / a > , < a href = "ntqt.html#ButtonState-enum" > MidButton< / a > ,
< a href = "ntqt.html#ButtonState-enum" > ShiftButton< / a > , < a href = "ntqt.html#ButtonState-enum" > ControlButton< / a > and < a href = "ntqt.html#ButtonState-enum" > AltButton< / a > OR'ed together.
< p > < p > See also < a href = "#button" > button< / a > (), < a href = "#stateAfter" > stateAfter< / a > (), and < a href = "ntqt.html#ButtonState-enum" > TQt::ButtonState< / a > .
< p > Examples: < a href = "popup-example.html#x1612" > popup/popup.cpp< / a > and < a href = "showimg-example.html#x1334" > showimg/showimg.cpp< / a > .
< h3 class = fn > < a href = "ntqt.html#ButtonState-enum" > ButtonState< / a > < a name = "stateAfter" > < / a > TQMouseEvent::stateAfter () const
< / h3 >
< p > Returns the state of buttons after the event.
< p > < p > See also < a href = "#state" > state< / a > () and < a href = "ntqt.html#ButtonState-enum" > TQt::ButtonState< / a > .
< h3 class = fn > int < a name = "x" > < / a > TQMouseEvent::x () const
< / h3 >
< p > Returns the x-position of the mouse pointer, relative to the
widget that received the event.
< p > < p > See also < a href = "#y" > y< / a > () and < a href = "#pos" > pos< / a > ().
< p > Example: < a href = "showimg-example.html#x1335" > showimg/showimg.cpp< / a > .
< h3 class = fn > int < a name = "y" > < / a > TQMouseEvent::y () const
< / h3 >
< p > Returns the y-position of the mouse pointer, relative to the
widget that received the event.
< p > < p > See also < a href = "#x" > x< / a > () and < a href = "#pos" > pos< / a > ().
< p > Example: < a href = "showimg-example.html#x1336" > showimg/showimg.cpp< / a > .
<!-- eof -->
< hr > < p >
This file is part of the < a href = "index.html" > TQt toolkit< / a > .
Copyright © 1995-2007
< a href = "http://www.trolltech.com/" > Trolltech< / a > . All Rights Reserved.< p > < address > < hr > < div align = center >
< table width = 100% cellspacing = 0 border = 0 > < tr >
< td > Copyright © 2007
< a href = "troll.html" > Trolltech< / a > < td align = center > < a href = "trademarks.html" > Trademarks< / a >
< td align = right > < div align = right > TQt 3.3.8< / div >
< / table > < / div > < / address > < / body >
< / html >
