From d796c9dd933ab96ec83b9a634feedd5d32e1ba3f Mon Sep 17 00:00:00 2001 From: Timothy Pearson Date: Tue, 8 Nov 2011 12:31:36 -0600 Subject: Test conversion to TQt3 from Qt3 8c6fc1f8e35fd264dd01c582ca5e7549b32ab731 --- doc/html/qtabletevent.html | 251 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 251 insertions(+) create mode 100644 doc/html/qtabletevent.html (limited to 'doc/html/qtabletevent.html') diff --git a/doc/html/qtabletevent.html b/doc/html/qtabletevent.html new file mode 100644 index 000000000..2eff7b1ba --- /dev/null +++ b/doc/html/qtabletevent.html @@ -0,0 +1,251 @@ + + + + + +TQTabletEvent Class + + + + + + + +
+ +Home + | +All Classes + | +Main Classes + | +Annotated + | +Grouped Classes + | +Functions +

TQTabletEvent Class Reference

+ +

The TQTabletEvent class contains parameters that describe a Tablet +event. +More... +

#include <qevent.h> +

Inherits TQEvent. +

List of all member functions. +

Public Members

+ +

Detailed Description

+ + +The TQTabletEvent class contains parameters that describe a Tablet +event. +

+

Tablet Events are generated from a Wacom© tablet. Most of +the time you will want to deal with events from the tablet as if +they were events from a mouse, for example retrieving the position +with x(), y(), pos(), globalX(), globalY() and globalPos(). In +some situations you may wish to retrieve the extra information +provided by the tablet device driver, for example, you might want +to adjust color brightness based on pressure. TQTabletEvent allows +you to get the pressure(), the xTilt() and yTilt(), as well as the +type of device being used with device() (see TabletDevice). +

A tablet event contains a special accept flag that indicates +whether the receiver wants the event. You should call +TQTabletEvent::accept() if you handle the tablet event; otherwise +it will be sent to the parent widget. +

The TQWidget::setEnabled() function can be used to enable or +disable mouse and keyboard events for a widget. +

The event handler TQWidget::tabletEvent() receives all three types of tablet +events. TQt will first send a tabletEvent and then, if it is not accepted, +it will send a mouse event. This allows applications that don't utilize +tablets to use a tablet like a mouse while also enabling those who want to +use both tablets and mouses differently. +

See also Event Classes. + +

Member Type Documentation

+

TQTabletEvent::TabletDevice

+ +

This enum defines what type of device is generating the event. +

+

Member Function Documentation

+

TQTabletEvent::TQTabletEvent ( Type t, const TQPoint & pos, const TQPoint & globalPos, int device, int pressure, int xTilt, int yTilt, const TQPair<int, int> & uId ) +

+ +Construct a tablet event of type t. The position of when the event occurred is given +int pos and globalPos. device contains the device type, +pressure contains the pressure exerted on the device, xTilt and yTilt contain +device's degree of tilt from the X and Y axis respectively. The uId contains an +event id. +

On Irix, globalPos will contain the high-resolution coordinates received from the +tablet device driver, instead of from the windowing system. +

See also pos(), globalPos(), device(), pressure(), xTilt(), and yTilt(). + +

TQTabletEvent::TQTabletEvent ( const TQPoint & pos, const TQPoint & globalPos, int device, int pressure, int xTilt, int yTilt, const TQPair<int, int> & uId ) +

+This function is obsolete. It is provided to keep old source working. We strongly advise against using it in new code. +

+

Constructs a tablet event object. The position when the event +occurred is is given in pos and globalPos. device +contains the device type, pressure +contains the pressure exerted on the device, xTilt and yTilt contain the device's degrees of tilt from the X and Y +axis respectively. The uId contains an event id. +

On Irix, globalPos will contain the high-resolution coordinates +received from the tablet device driver, instead of from the +windowing system. +

See also pos(), globalPos(), device(), pressure(), xTilt(), and yTilt(). + +

void TQTabletEvent::accept () +

+ +

Sets the accept flag of the tablet event object. +

Setting the accept flag indicates that the receiver of the event +wants the tablet event. Unwanted tablet events are sent to the +parent widget. +

The accept flag is set by default. +

See also ignore(). + +

TabletDevice TQTabletEvent::device () const +

+ +

Returns the type of device that generated the event. Useful if you +want one end of the pen to do something different than the other. +

See also TabletDevice. + +

const TQPoint & TQTabletEvent::globalPos () const +

+ +

Returns the global position of the device at the time of the event. This is important on asynchronous windows systems like X11; +whenever you move your widgets around in response to mouse events, +globalPos() can differ significantly from the current position +TQCursor::pos(). +

See also globalX() and globalY(). + +

int TQTabletEvent::globalX () const +

+ +

Returns the global x-position of the mouse pointer at the time of +the event. +

See also globalY() and globalPos(). + +

int TQTabletEvent::globalY () const +

+ +

Returns the global y-position of the mouse pointer at the time of +the event. +

See also globalX() and globalPos(). + +

void TQTabletEvent::ignore () +

+ +

Clears the accept flag parameter of the tablet event object. +

Clearing the accept flag indicates that the event receiver does +not want the tablet event. Unwanted tablet events are sent to the +parent widget. +

The accept flag is set by default. +

See also accept(). + +

int TQTabletEvent::isAccepted () const +

+ +

Returns TRUE if the receiver of the event handles the tablet +event; otherwise returns FALSE. + +

const TQPoint & TQTabletEvent::pos () const +

+ +

Returns the position of the device, relative to the widget that +received the event. +

If you move widgets around in response to mouse events, use +globalPos() instead of this function. +

See also x(), y(), and globalPos(). + +

int TQTabletEvent::pressure () const +

+ +

Returns the pressure that is exerted on the device. This number is +a value from 0 (no pressure) to 255 (maximum pressure). The +pressure is always scaled to be within this range no matter how +many pressure levels the underlying hardware supports. + +

TQPair<int, int> TQTabletEvent::uniqueId () +

+ +

Returns a unique ID for the current device. It is possible to +generate a unique ID for any Wacom© device. This makes it +possible to differentiate between multiple devices being used at +the same time on the tablet. The first member contains a value +for the type, the second member contains a physical ID obtained +from the device. Each combination of these values is unique. Note: +for different platforms, the first value is different due to +different driver implementations. + +

int TQTabletEvent::x () const +

+ +

Returns the x-position of the device, relative to the widget that +received the event. +

See also y() and pos(). + +

int TQTabletEvent::xTilt () const +

+ +

Returns the difference from the perpendicular in the X Axis. +Positive values are towards the tablet's physical right. The angle +is in the range -60 to +60 degrees. +

See also yTilt(). + +

int TQTabletEvent::y () const +

+ +

Returns the y-position of the device, relative to the widget that +received the event. +

See also x() and pos(). + +

int TQTabletEvent::yTilt () const +

+ +

Returns the difference from the perpendicular in the Y Axis. +Positive values are towards the bottom of the tablet. The angle is +within the range -60 to +60 degrees. +

See also xTilt(). + + +

+This file is part of the TQt toolkit. +Copyright © 1995-2007 +Trolltech. All Rights Reserved.

+ +
Copyright © 2007 +TrolltechTrademarks +
TQt 3.3.8
+
+ -- cgit v1.2.1