| 1 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
|---|
| 2 | <!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/src/kernel/qpaintdevice_x11.cpp:47 -->
|
|---|
| 3 | <html>
|
|---|
| 4 | <head>
|
|---|
| 5 | <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
|---|
| 6 | <title>QPaintDevice Class</title>
|
|---|
| 7 | <style type="text/css"><!--
|
|---|
| 8 | fn { margin-left: 1cm; text-indent: -1cm; }
|
|---|
| 9 | a:link { color: #004faf; text-decoration: none }
|
|---|
| 10 | a:visited { color: #672967; text-decoration: none }
|
|---|
| 11 | body { background: #ffffff; color: black; }
|
|---|
| 12 | --></style>
|
|---|
| 13 | </head>
|
|---|
| 14 | <body>
|
|---|
| 15 |
|
|---|
| 16 | <table border="0" cellpadding="0" cellspacing="0" width="100%">
|
|---|
| 17 | <tr bgcolor="#E5E5E5">
|
|---|
| 18 | <td valign=center>
|
|---|
| 19 | <a href="index.html">
|
|---|
| 20 | <font color="#004faf">Home</font></a>
|
|---|
| 21 | | <a href="classes.html">
|
|---|
| 22 | <font color="#004faf">All Classes</font></a>
|
|---|
| 23 | | <a href="mainclasses.html">
|
|---|
| 24 | <font color="#004faf">Main Classes</font></a>
|
|---|
| 25 | | <a href="annotated.html">
|
|---|
| 26 | <font color="#004faf">Annotated</font></a>
|
|---|
| 27 | | <a href="groups.html">
|
|---|
| 28 | <font color="#004faf">Grouped Classes</font></a>
|
|---|
| 29 | | <a href="functions.html">
|
|---|
| 30 | <font color="#004faf">Functions</font></a>
|
|---|
| 31 | </td>
|
|---|
| 32 | <td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>QPaintDevice Class Reference</h1>
|
|---|
| 33 |
|
|---|
| 34 | <p>The QPaintDevice class is the base class of objects that
|
|---|
| 35 | can be painted.
|
|---|
| 36 | <a href="#details">More...</a>
|
|---|
| 37 | <p><tt>#include <<a href="qpaintdevice-h.html">qpaintdevice.h</a>></tt>
|
|---|
| 38 | <p>Inherited by <a href="qwidget.html">QWidget</a>, <a href="qpixmap.html">QPixmap</a>, <a href="qpicture.html">QPicture</a>, and <a href="qprinter.html">QPrinter</a>.
|
|---|
| 39 | <p><a href="qpaintdevice-members.html">List of all member functions.</a>
|
|---|
| 40 | <h2>Public Members</h2>
|
|---|
| 41 | <ul>
|
|---|
| 42 | <li class=fn>virtual <a href="#~QPaintDevice"><b>~QPaintDevice</b></a> ()</li>
|
|---|
| 43 | <li class=fn>bool <a href="#isExtDev"><b>isExtDev</b></a> () const</li>
|
|---|
| 44 | <li class=fn>bool <a href="#paintingActive"><b>paintingActive</b></a> () const</li>
|
|---|
| 45 | <li class=fn>virtual HDC <b>handle</b> () const</li>
|
|---|
| 46 | <li class=fn>virtual Qt::HANDLE <a href="#handle"><b>handle</b></a> () const</li>
|
|---|
| 47 | <li class=fn>Display * <a href="#x11Display"><b>x11Display</b></a> () const</li>
|
|---|
| 48 | <li class=fn>int <a href="#x11Screen"><b>x11Screen</b></a> () const</li>
|
|---|
| 49 | <li class=fn>int <a href="#x11Depth"><b>x11Depth</b></a> () const</li>
|
|---|
| 50 | <li class=fn>int <a href="#x11Cells"><b>x11Cells</b></a> () const</li>
|
|---|
| 51 | <li class=fn>Qt::HANDLE <a href="#x11Colormap"><b>x11Colormap</b></a> () const</li>
|
|---|
| 52 | <li class=fn>bool <a href="#x11DefaultColormap"><b>x11DefaultColormap</b></a> () const</li>
|
|---|
| 53 | <li class=fn>void * <a href="#x11Visual"><b>x11Visual</b></a> () const</li>
|
|---|
| 54 | <li class=fn>bool <a href="#x11DefaultVisual"><b>x11DefaultVisual</b></a> () const</li>
|
|---|
| 55 | </ul>
|
|---|
| 56 | <h2>Static Public Members</h2>
|
|---|
| 57 | <ul>
|
|---|
| 58 | <li class=fn>Display * <a href="#x11AppDisplay"><b>x11AppDisplay</b></a> ()</li>
|
|---|
| 59 | <li class=fn>int <a href="#x11AppScreen"><b>x11AppScreen</b></a> ()</li>
|
|---|
| 60 | <li class=fn>int <a href="#x11AppDpiX-2"><b>x11AppDpiX</b></a> ()</li>
|
|---|
| 61 | <li class=fn>int <a href="#x11AppDpiY-2"><b>x11AppDpiY</b></a> ()</li>
|
|---|
| 62 | <li class=fn>void <a href="#x11SetAppDpiX-2"><b>x11SetAppDpiX</b></a> ( int dpi )</li>
|
|---|
| 63 | <li class=fn>void <a href="#x11SetAppDpiY-2"><b>x11SetAppDpiY</b></a> ( int dpi )</li>
|
|---|
| 64 | <li class=fn>int <a href="#x11AppDepth-2"><b>x11AppDepth</b></a> ()</li>
|
|---|
| 65 | <li class=fn>int <a href="#x11AppCells"><b>x11AppCells</b></a> ()</li>
|
|---|
| 66 | <li class=fn>Qt::HANDLE <a href="#x11AppRootWindow"><b>x11AppRootWindow</b></a> ()</li>
|
|---|
| 67 | <li class=fn>Qt::HANDLE <a href="#x11AppColormap"><b>x11AppColormap</b></a> ()</li>
|
|---|
| 68 | <li class=fn>bool <a href="#x11AppDefaultColormap"><b>x11AppDefaultColormap</b></a> ()</li>
|
|---|
| 69 | <li class=fn>void * <a href="#x11AppVisual"><b>x11AppVisual</b></a> ()</li>
|
|---|
| 70 | <li class=fn>bool <a href="#x11AppDefaultVisual"><b>x11AppDefaultVisual</b></a> ()</li>
|
|---|
| 71 | <li class=fn>int <a href="#x11AppDepth"><b>x11AppDepth</b></a> ( int screen )</li>
|
|---|
| 72 | <li class=fn>int <a href="#x11AppCells-2"><b>x11AppCells</b></a> ( int screen )</li>
|
|---|
| 73 | <li class=fn>Qt::HANDLE <a href="#x11AppRootWindow-2"><b>x11AppRootWindow</b></a> ( int screen )</li>
|
|---|
| 74 | <li class=fn>Qt::HANDLE <a href="#x11AppColormap-2"><b>x11AppColormap</b></a> ( int screen )</li>
|
|---|
| 75 | <li class=fn>void * <a href="#x11AppVisual-2"><b>x11AppVisual</b></a> ( int screen )</li>
|
|---|
| 76 | <li class=fn>bool <a href="#x11AppDefaultColormap-2"><b>x11AppDefaultColormap</b></a> ( int screen )</li>
|
|---|
| 77 | <li class=fn>bool <a href="#x11AppDefaultVisual-2"><b>x11AppDefaultVisual</b></a> ( int screen )</li>
|
|---|
| 78 | <li class=fn>int <a href="#x11AppDpiX"><b>x11AppDpiX</b></a> ( int screen )</li>
|
|---|
| 79 | <li class=fn>int <a href="#x11AppDpiY"><b>x11AppDpiY</b></a> ( int screen )</li>
|
|---|
| 80 | <li class=fn>void <a href="#x11SetAppDpiX"><b>x11SetAppDpiX</b></a> ( int dpi, int screen )</li>
|
|---|
| 81 | <li class=fn>void <a href="#x11SetAppDpiY"><b>x11SetAppDpiY</b></a> ( int dpi, int screen )</li>
|
|---|
| 82 | </ul>
|
|---|
| 83 | <h2>Protected Members</h2>
|
|---|
| 84 | <ul>
|
|---|
| 85 | <li class=fn><a href="#QPaintDevice"><b>QPaintDevice</b></a> ( uint devflags )</li>
|
|---|
| 86 | <li class=fn>virtual bool <a href="#cmd"><b>cmd</b></a> ( int, QPainter *, QPDevCmdParam * )</li>
|
|---|
| 87 | </ul>
|
|---|
| 88 | <h2>Related Functions</h2>
|
|---|
| 89 | <ul>
|
|---|
| 90 | <li class=fn>void <a href="#bitBlt"><b>bitBlt</b></a> ( QPaintDevice * dst, int dx, int dy, const QPaintDevice * src, int sx, int sy, int sw, int sh, Qt::RasterOp rop, bool ignoreMask )</li>
|
|---|
| 91 | <li class=fn>void <a href="#bitBlt-2"><b>bitBlt</b></a> ( QPaintDevice * dst, const QPoint & dp, const QPaintDevice * src, const QRect & sr, RasterOp rop )</li>
|
|---|
| 92 | </ul>
|
|---|
| 93 | <hr><a name="details"></a><h2>Detailed Description</h2>
|
|---|
| 94 |
|
|---|
| 95 |
|
|---|
| 96 | The QPaintDevice class is the base class of objects that
|
|---|
| 97 | can be painted.
|
|---|
| 98 | <p>
|
|---|
| 99 |
|
|---|
| 100 | <p> A paint device is an abstraction of a two-dimensional space that
|
|---|
| 101 | can be drawn using a <a href="qpainter.html">QPainter</a>. The drawing capabilities are
|
|---|
| 102 | implemented by the subclasses <a href="qwidget.html">QWidget</a>, <a href="qpixmap.html">QPixmap</a>, <a href="qpicture.html">QPicture</a> and
|
|---|
| 103 | <a href="qprinter.html">QPrinter</a>.
|
|---|
| 104 | <p> The default coordinate system of a paint device has its origin
|
|---|
| 105 | located at the top-left position. X increases to the right and Y
|
|---|
| 106 | increases downward. The unit is one pixel. There are several ways
|
|---|
| 107 | to set up a user-defined coordinate system using the painter, for
|
|---|
| 108 | example, using <a href="qpainter.html#setWorldMatrix">QPainter::setWorldMatrix</a>().
|
|---|
| 109 | <p> Example (draw on a paint device):
|
|---|
| 110 | <pre>
|
|---|
| 111 | void MyWidget::paintEvent( <a href="qpaintevent.html">QPaintEvent</a> * )
|
|---|
| 112 | {
|
|---|
| 113 | <a href="qpainter.html">QPainter</a> p; // our painter
|
|---|
| 114 | p.<a href="qpainter.html#begin">begin</a>( this ); // start painting the widget
|
|---|
| 115 | p.<a href="qpainter.html#setPen">setPen</a>( red ); // red outline
|
|---|
| 116 | p.<a href="qpainter.html#setBrush">setBrush</a>( yellow ); // yellow fill
|
|---|
| 117 | p.<a href="qpainter.html#drawEllipse">drawEllipse</a>( 10, 20, 100,100 ); // 100x100 ellipse at position (10, 20)
|
|---|
| 118 | p.<a href="qpainter.html#end">end</a>(); // painting done
|
|---|
| 119 | }
|
|---|
| 120 | </pre>
|
|---|
| 121 |
|
|---|
| 122 | <p> The bit block transfer is an extremely useful operation for
|
|---|
| 123 | copying pixels from one paint device to another (or to itself). It
|
|---|
| 124 | is implemented as the global function <a href="#bitBlt">bitBlt</a>().
|
|---|
| 125 | <p> Example (scroll widget contents 10 pixels to the right):
|
|---|
| 126 | <pre>
|
|---|
| 127 | <a href="#bitBlt">bitBlt</a>( myWidget, 10, 0, myWidget );
|
|---|
| 128 | </pre>
|
|---|
| 129 |
|
|---|
| 130 | <p> <b>Warning:</b> Qt requires that a <a href="qapplication.html">QApplication</a> object exists before
|
|---|
| 131 | any paint devices can be created. Paint devices access window
|
|---|
| 132 | system resources, and these resources are not initialized before
|
|---|
| 133 | an application object is created.
|
|---|
| 134 | <p>See also <a href="graphics.html">Graphics Classes</a> and <a href="images.html">Image Processing Classes</a>.
|
|---|
| 135 |
|
|---|
| 136 | <hr><h2>Member Function Documentation</h2>
|
|---|
| 137 | <h3 class=fn><a name="QPaintDevice"></a>QPaintDevice::QPaintDevice ( uint devflags )<tt> [protected]</tt>
|
|---|
| 138 | </h3>
|
|---|
| 139 | Constructs a paint device with internal flags <em>devflags</em>. This
|
|---|
| 140 | constructor can be invoked only from QPaintDevice subclasses.
|
|---|
| 141 |
|
|---|
| 142 | <h3 class=fn><a name="~QPaintDevice"></a>QPaintDevice::~QPaintDevice ()<tt> [virtual]</tt>
|
|---|
| 143 | </h3>
|
|---|
| 144 | Destroys the paint device and frees window system resources.
|
|---|
| 145 |
|
|---|
| 146 | <h3 class=fn>bool <a name="cmd"></a>QPaintDevice::cmd ( int, <a href="qpainter.html">QPainter</a> *, QPDevCmdParam * )<tt> [virtual protected]</tt>
|
|---|
| 147 | </h3>
|
|---|
| 148 | Internal virtual function that interprets drawing commands from
|
|---|
| 149 | the painter.
|
|---|
| 150 | <p> Implemented by subclasses that have no direct support for drawing
|
|---|
| 151 | graphics (external paint devices, for example, <a href="qpicture.html">QPicture</a>).
|
|---|
| 152 |
|
|---|
| 153 | <h3 class=fn>Qt::HANDLE <a name="handle"></a>QPaintDevice::handle () const<tt> [virtual]</tt>
|
|---|
| 154 | </h3>
|
|---|
| 155 | Returns the window system handle of the paint device, for
|
|---|
| 156 | low-level access. Using this function is not portable.
|
|---|
| 157 | <p> The HANDLE type varies with platform; see <a href="qpaintdevice-h.html">qpaintdevice.h</a> and
|
|---|
| 158 | <a href="qwindowdefs-h.html">qwindowdefs.h</a> for details.
|
|---|
| 159 | <p> <p>See also <a href="#x11Display">x11Display</a>().
|
|---|
| 160 |
|
|---|
| 161 | <h3 class=fn>bool <a name="isExtDev"></a>QPaintDevice::isExtDev () const
|
|---|
| 162 | </h3>
|
|---|
| 163 |
|
|---|
| 164 | <p> Returns TRUE if the device is an external paint device; otherwise
|
|---|
| 165 | returns FALSE.
|
|---|
| 166 | <p> External paint devices cannot be <a href="#bitBlt">bitBlt</a>()'ed from. <a href="qpicture.html">QPicture</a> and
|
|---|
| 167 | <a href="qprinter.html">QPrinter</a> are external paint devices.
|
|---|
| 168 |
|
|---|
| 169 | <h3 class=fn>bool <a name="paintingActive"></a>QPaintDevice::paintingActive () const
|
|---|
| 170 | </h3>
|
|---|
| 171 |
|
|---|
| 172 | <p> Returns TRUE if the device is being painted, i.e. someone has
|
|---|
| 173 | called <a href="qpainter.html#begin">QPainter::begin</a>() but not yet called <a href="qpainter.html#end">QPainter::end</a>() for
|
|---|
| 174 | this device; otherwise returns FALSE.
|
|---|
| 175 | <p> <p>See also <a href="qpainter.html#isActive">QPainter::isActive</a>().
|
|---|
| 176 |
|
|---|
| 177 | <h3 class=fn>int <a name="x11AppCells"></a>QPaintDevice::x11AppCells ()<tt> [static]</tt>
|
|---|
| 178 | </h3>
|
|---|
| 179 |
|
|---|
| 180 | <p> Returns the number of entries in the colormap for the default
|
|---|
| 181 | screen of the X display global to the application (X11
|
|---|
| 182 | only). Using this function is not portable.
|
|---|
| 183 | <p> <p>See also <a href="#x11Colormap">x11Colormap</a>().
|
|---|
| 184 |
|
|---|
| 185 | <h3 class=fn>int <a name="x11AppCells-2"></a>QPaintDevice::x11AppCells ( int screen )<tt> [static]</tt>
|
|---|
| 186 | </h3>
|
|---|
| 187 | This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
|
|---|
| 188 | <p>
|
|---|
| 189 | <p> Returns the number of entries in the colormap for screen <em>screen</em>
|
|---|
| 190 | of the X display global to the application (X11 only). Using this
|
|---|
| 191 | function is not portable.
|
|---|
| 192 | <p> <p>See also <a href="#x11Colormap">x11Colormap</a>().
|
|---|
| 193 |
|
|---|
| 194 | <h3 class=fn>Qt::HANDLE <a name="x11AppColormap"></a>QPaintDevice::x11AppColormap ()<tt> [static]</tt>
|
|---|
| 195 | </h3>
|
|---|
| 196 |
|
|---|
| 197 | <p> Returns the colormap for the default screen of the X display
|
|---|
| 198 | global to the application (X11 only). Using this function is not
|
|---|
| 199 | portable.
|
|---|
| 200 | <p> <p>See also <a href="#x11Cells">x11Cells</a>().
|
|---|
| 201 |
|
|---|
| 202 | <h3 class=fn>Qt::HANDLE <a name="x11AppColormap-2"></a>QPaintDevice::x11AppColormap ( int screen )<tt> [static]</tt>
|
|---|
| 203 | </h3>
|
|---|
| 204 | This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
|
|---|
| 205 | <p>
|
|---|
| 206 | <p> Returns the colormap for screen <em>screen</em> of the X display global
|
|---|
| 207 | to the application (X11 only). Using this function is not
|
|---|
| 208 | portable.
|
|---|
| 209 | <p> <p>See also <a href="#x11Cells">x11Cells</a>().
|
|---|
| 210 |
|
|---|
| 211 | <h3 class=fn>bool <a name="x11AppDefaultColormap"></a>QPaintDevice::x11AppDefaultColormap ()<tt> [static]</tt>
|
|---|
| 212 | </h3>
|
|---|
| 213 |
|
|---|
| 214 | <p> Returns the default colormap for the default screen of the X
|
|---|
| 215 | display global to the application (X11 only). Using this function
|
|---|
| 216 | is not portable.
|
|---|
| 217 | <p> <p>See also <a href="#x11Cells">x11Cells</a>().
|
|---|
| 218 |
|
|---|
| 219 | <h3 class=fn>bool <a name="x11AppDefaultColormap-2"></a>QPaintDevice::x11AppDefaultColormap ( int screen )<tt> [static]</tt>
|
|---|
| 220 | </h3>
|
|---|
| 221 | This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
|
|---|
| 222 | <p>
|
|---|
| 223 | <p> Returns the default colormap for screen <em>screen</em> of the X display
|
|---|
| 224 | global to the application (X11 only). Using this function is not
|
|---|
| 225 | portable.
|
|---|
| 226 | <p> <p>See also <a href="#x11Cells">x11Cells</a>().
|
|---|
| 227 |
|
|---|
| 228 | <h3 class=fn>bool <a name="x11AppDefaultVisual"></a>QPaintDevice::x11AppDefaultVisual ()<tt> [static]</tt>
|
|---|
| 229 | </h3>
|
|---|
| 230 |
|
|---|
| 231 | <p> Returns TRUE if the Visual used is the default for the default
|
|---|
| 232 | screen of the X display global to the application (X11 only);
|
|---|
| 233 | otherwise returns FALSE. Using this function is not portable.
|
|---|
| 234 |
|
|---|
| 235 | <h3 class=fn>bool <a name="x11AppDefaultVisual-2"></a>QPaintDevice::x11AppDefaultVisual ( int screen )<tt> [static]</tt>
|
|---|
| 236 | </h3>
|
|---|
| 237 | This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
|
|---|
| 238 | <p>
|
|---|
| 239 | <p> Returns TRUE if the Visual used is the default for screen
|
|---|
| 240 | <em>screen</em> of the X display global to the application (X11 only);
|
|---|
| 241 | otherwise returns FALSE. Using this function is not portable.
|
|---|
| 242 |
|
|---|
| 243 | <h3 class=fn>int <a name="x11AppDepth"></a>QPaintDevice::x11AppDepth ( int screen )<tt> [static]</tt>
|
|---|
| 244 | </h3>
|
|---|
| 245 |
|
|---|
| 246 | <p> Returns the depth for screen <em>screen</em> of the X display global to
|
|---|
| 247 | the application (X11 only). Using this function is not portable.
|
|---|
| 248 | <p> <p>See also <a href="qpixmap.html#defaultDepth">QPixmap::defaultDepth</a>().
|
|---|
| 249 |
|
|---|
| 250 | <h3 class=fn>int <a name="x11AppDepth-2"></a>QPaintDevice::x11AppDepth ()<tt> [static]</tt>
|
|---|
| 251 | </h3>
|
|---|
| 252 | This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
|
|---|
| 253 | <p>
|
|---|
| 254 | <p> Returns the depth for the default screen of the X display global
|
|---|
| 255 | to the application (X11 only). Using this function is not
|
|---|
| 256 | portable.
|
|---|
| 257 | <p> <p>See also <a href="qpixmap.html#defaultDepth">QPixmap::defaultDepth</a>().
|
|---|
| 258 |
|
|---|
| 259 | <h3 class=fn>Display * <a name="x11AppDisplay"></a>QPaintDevice::x11AppDisplay ()<tt> [static]</tt>
|
|---|
| 260 | </h3>
|
|---|
| 261 |
|
|---|
| 262 | <p> Returns a pointer to the X display global to the application (X11
|
|---|
| 263 | only). Using this function is not portable.
|
|---|
| 264 | <p> <p>See also <a href="#handle">handle</a>().
|
|---|
| 265 |
|
|---|
| 266 | <h3 class=fn>int <a name="x11AppDpiX"></a>QPaintDevice::x11AppDpiX ( int screen )<tt> [static]</tt>
|
|---|
| 267 | </h3>
|
|---|
| 268 | Returns the horizontal DPI of the X display (X11 only) for screen
|
|---|
| 269 | <em>screen</em>. Using this function is not portable. See
|
|---|
| 270 | <a href="qpaintdevicemetrics.html">QPaintDeviceMetrics</a> for portable access to related information.
|
|---|
| 271 | Using this function is not portable.
|
|---|
| 272 | <p> <p>See also <a href="#x11AppDpiY">x11AppDpiY</a>(), <a href="#x11SetAppDpiX">x11SetAppDpiX</a>(), and <a href="qpaintdevicemetrics.html#logicalDpiX">QPaintDeviceMetrics::logicalDpiX</a>().
|
|---|
| 273 |
|
|---|
| 274 | <h3 class=fn>int <a name="x11AppDpiX-2"></a>QPaintDevice::x11AppDpiX ()<tt> [static]</tt>
|
|---|
| 275 | </h3>
|
|---|
| 276 | This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
|
|---|
| 277 | <p> Returns the horizontal DPI of the X display (X11 only) for the
|
|---|
| 278 | default screen. Using this function is not portable. See
|
|---|
| 279 | <a href="qpaintdevicemetrics.html">QPaintDeviceMetrics</a> for portable access to related information.
|
|---|
| 280 | Using this function is not portable.
|
|---|
| 281 |
|
|---|
| 282 | <h3 class=fn>int <a name="x11AppDpiY"></a>QPaintDevice::x11AppDpiY ( int screen )<tt> [static]</tt>
|
|---|
| 283 | </h3>
|
|---|
| 284 | Returns the vertical DPI of the X11 display (X11 only) for screen
|
|---|
| 285 | <em>screen</em>. Using this function is not portable. See
|
|---|
| 286 | <a href="qpaintdevicemetrics.html">QPaintDeviceMetrics</a> for portable access to related information.
|
|---|
| 287 | Using this function is not portable.
|
|---|
| 288 | <p> <p>See also <a href="#x11AppDpiX">x11AppDpiX</a>(), <a href="#x11SetAppDpiY">x11SetAppDpiY</a>(), and <a href="qpaintdevicemetrics.html#logicalDpiY">QPaintDeviceMetrics::logicalDpiY</a>().
|
|---|
| 289 |
|
|---|
| 290 | <h3 class=fn>int <a name="x11AppDpiY-2"></a>QPaintDevice::x11AppDpiY ()<tt> [static]</tt>
|
|---|
| 291 | </h3>
|
|---|
| 292 | This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
|
|---|
| 293 | <p> Returns the vertical DPI of the X11 display (X11 only) for the
|
|---|
| 294 | default screen. Using this function is not portable. See
|
|---|
| 295 | <a href="qpaintdevicemetrics.html">QPaintDeviceMetrics</a> for portable access to related information.
|
|---|
| 296 | Using this function is not portable.
|
|---|
| 297 | <p> <p>See also <a href="#x11AppDpiX">x11AppDpiX</a>(), <a href="#x11SetAppDpiY">x11SetAppDpiY</a>(), and <a href="qpaintdevicemetrics.html#logicalDpiY">QPaintDeviceMetrics::logicalDpiY</a>().
|
|---|
| 298 |
|
|---|
| 299 | <h3 class=fn>Qt::HANDLE <a name="x11AppRootWindow"></a>QPaintDevice::x11AppRootWindow ()<tt> [static]</tt>
|
|---|
| 300 | </h3>
|
|---|
| 301 |
|
|---|
| 302 | <p> Returns the root window for the default screen of the X display
|
|---|
| 303 | global to the applicatoin (X11 only). Using this function is not
|
|---|
| 304 | portable.
|
|---|
| 305 |
|
|---|
| 306 | <h3 class=fn>Qt::HANDLE <a name="x11AppRootWindow-2"></a>QPaintDevice::x11AppRootWindow ( int screen )<tt> [static]</tt>
|
|---|
| 307 | </h3>
|
|---|
| 308 | This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
|
|---|
| 309 | <p>
|
|---|
| 310 | <p> Returns the root window for screen <em>screen</em> of the X display
|
|---|
| 311 | global to the applicatoin (X11 only). Using this function is not
|
|---|
| 312 | portable.
|
|---|
| 313 |
|
|---|
| 314 | <h3 class=fn>int <a name="x11AppScreen"></a>QPaintDevice::x11AppScreen ()<tt> [static]</tt>
|
|---|
| 315 | </h3>
|
|---|
| 316 |
|
|---|
| 317 | <p> Returns the screen number on the X display global to the
|
|---|
| 318 | application (X11 only). Using this function is not portable.
|
|---|
| 319 |
|
|---|
| 320 | <h3 class=fn>void * <a name="x11AppVisual"></a>QPaintDevice::x11AppVisual ()<tt> [static]</tt>
|
|---|
| 321 | </h3>
|
|---|
| 322 |
|
|---|
| 323 | <p> Returns the Visual for the default screen of the X display global
|
|---|
| 324 | to the application (X11 only). Using this function is not
|
|---|
| 325 | portable.
|
|---|
| 326 |
|
|---|
| 327 | <h3 class=fn>void * <a name="x11AppVisual-2"></a>QPaintDevice::x11AppVisual ( int screen )<tt> [static]</tt>
|
|---|
| 328 | </h3>
|
|---|
| 329 | This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
|
|---|
| 330 | <p>
|
|---|
| 331 | <p> Returns the Visual for screen <em>screen</em> of the X display global to
|
|---|
| 332 | the application (X11 only). Using this function is not portable.
|
|---|
| 333 |
|
|---|
| 334 | <h3 class=fn>int <a name="x11Cells"></a>QPaintDevice::x11Cells () const
|
|---|
| 335 | </h3>
|
|---|
| 336 |
|
|---|
| 337 | <p> Returns the number of entries in the colormap of the X display for
|
|---|
| 338 | the paint device (X11 only). Using this function is not portable.
|
|---|
| 339 | <p> <p>See also <a href="#x11Colormap">x11Colormap</a>().
|
|---|
| 340 |
|
|---|
| 341 | <h3 class=fn>Qt::HANDLE <a name="x11Colormap"></a>QPaintDevice::x11Colormap () const
|
|---|
| 342 | </h3>
|
|---|
| 343 |
|
|---|
| 344 | <p> Returns the colormap of the X display for the paint device (X11
|
|---|
| 345 | only). Using this function is not portable.
|
|---|
| 346 | <p> <p>See also <a href="#x11Cells">x11Cells</a>().
|
|---|
| 347 |
|
|---|
| 348 | <h3 class=fn>bool <a name="x11DefaultColormap"></a>QPaintDevice::x11DefaultColormap () const
|
|---|
| 349 | </h3>
|
|---|
| 350 |
|
|---|
| 351 | <p> Returns the default colormap of the X display for the paint device
|
|---|
| 352 | (X11 only). Using this function is not portable.
|
|---|
| 353 | <p> <p>See also <a href="#x11Cells">x11Cells</a>().
|
|---|
| 354 |
|
|---|
| 355 | <h3 class=fn>bool <a name="x11DefaultVisual"></a>QPaintDevice::x11DefaultVisual () const
|
|---|
| 356 | </h3>
|
|---|
| 357 |
|
|---|
| 358 | <p> Returns the default Visual of the X display for the paint device
|
|---|
| 359 | (X11 only). Using this function is not portable.
|
|---|
| 360 |
|
|---|
| 361 | <h3 class=fn>int <a name="x11Depth"></a>QPaintDevice::x11Depth () const
|
|---|
| 362 | </h3>
|
|---|
| 363 |
|
|---|
| 364 | <p> Returns the depth of the X display for the paint device (X11
|
|---|
| 365 | only). Using this function is not portable.
|
|---|
| 366 | <p> <p>See also <a href="qpixmap.html#defaultDepth">QPixmap::defaultDepth</a>().
|
|---|
| 367 |
|
|---|
| 368 | <h3 class=fn>Display * <a name="x11Display"></a>QPaintDevice::x11Display () const
|
|---|
| 369 | </h3>
|
|---|
| 370 |
|
|---|
| 371 | <p> Returns a pointer to the X display for the paint device (X11
|
|---|
| 372 | only). Using this function is not portable.
|
|---|
| 373 | <p> <p>See also <a href="#handle">handle</a>().
|
|---|
| 374 |
|
|---|
| 375 | <h3 class=fn>int <a name="x11Screen"></a>QPaintDevice::x11Screen () const
|
|---|
| 376 | </h3>
|
|---|
| 377 |
|
|---|
| 378 | <p> Returns the screen number on the X display for the paint device
|
|---|
| 379 | (X11 only). Using this function is not portable.
|
|---|
| 380 |
|
|---|
| 381 | <h3 class=fn>void <a name="x11SetAppDpiX"></a>QPaintDevice::x11SetAppDpiX ( int dpi, int screen )<tt> [static]</tt>
|
|---|
| 382 | </h3>
|
|---|
| 383 | Sets the value returned by <a href="#x11AppDpiX">x11AppDpiX</a>() to <em>dpi</em> for screen
|
|---|
| 384 | <em>screen</em>. The default is determined by the display configuration.
|
|---|
| 385 | Changing this value will alter the scaling of fonts and many other
|
|---|
| 386 | metrics and is not recommended. Using this function is not
|
|---|
| 387 | portable.
|
|---|
| 388 | <p> <p>See also <a href="#x11SetAppDpiY">x11SetAppDpiY</a>().
|
|---|
| 389 |
|
|---|
| 390 | <h3 class=fn>void <a name="x11SetAppDpiX-2"></a>QPaintDevice::x11SetAppDpiX ( int dpi )<tt> [static]</tt>
|
|---|
| 391 | </h3>
|
|---|
| 392 | This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
|
|---|
| 393 | <p> Sets the value returned by <a href="#x11AppDpiX">x11AppDpiX</a>() to <em>dpi</em> for the default
|
|---|
| 394 | screen. The default is determined by the display configuration.
|
|---|
| 395 | Changing this value will alter the scaling of fonts and many other
|
|---|
| 396 | metrics and is not recommended. Using this function is not
|
|---|
| 397 | portable.
|
|---|
| 398 | <p>
|
|---|
| 399 | <h3 class=fn>void <a name="x11SetAppDpiY"></a>QPaintDevice::x11SetAppDpiY ( int dpi, int screen )<tt> [static]</tt>
|
|---|
| 400 | </h3>
|
|---|
| 401 | Sets the value returned by <a href="#x11AppDpiY">x11AppDpiY</a>() to <em>dpi</em> for screen
|
|---|
| 402 | <em>screen</em>. The default is determined by the display configuration.
|
|---|
| 403 | Changing this value will alter the scaling of fonts and many other
|
|---|
| 404 | metrics and is not recommended. Using this function is not
|
|---|
| 405 | portable.
|
|---|
| 406 | <p> <p>See also <a href="#x11SetAppDpiX">x11SetAppDpiX</a>().
|
|---|
| 407 |
|
|---|
| 408 | <h3 class=fn>void <a name="x11SetAppDpiY-2"></a>QPaintDevice::x11SetAppDpiY ( int dpi )<tt> [static]</tt>
|
|---|
| 409 | </h3>
|
|---|
| 410 | This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
|
|---|
| 411 | <p> Sets the value returned by <a href="#x11AppDpiY">x11AppDpiY</a>() to <em>dpi</em> for the default
|
|---|
| 412 | screen. The default is determined by the display configuration.
|
|---|
| 413 | Changing this value will alter the scaling of fonts and many other
|
|---|
| 414 | metrics and is not recommended. Using this function is not
|
|---|
| 415 | portable.
|
|---|
| 416 |
|
|---|
| 417 | <h3 class=fn>void * <a name="x11Visual"></a>QPaintDevice::x11Visual () const
|
|---|
| 418 | </h3>
|
|---|
| 419 |
|
|---|
| 420 | <p> Returns the Visual of the X display for the paint device (X11
|
|---|
| 421 | only). Using this function is not portable.
|
|---|
| 422 |
|
|---|
| 423 | <hr><h2>Related Functions</h2>
|
|---|
| 424 | <h3 class=fn>void <a name="bitBlt"></a>bitBlt ( <a href="qpaintdevice.html">QPaintDevice</a> * dst, int dx, int dy, const <a href="qpaintdevice.html">QPaintDevice</a> * src, int sx, int sy, int sw, int sh, <a href="qt.html#RasterOp-enum">Qt::RasterOp</a> rop, bool ignoreMask )
|
|---|
| 425 | </h3>
|
|---|
| 426 |
|
|---|
| 427 | <p> Copies a block of pixels from <em>src</em> to <em>dst</em>, perhaps merging
|
|---|
| 428 | each pixel according to the <a href="qt.html#RasterOp-enum">raster operation</a>
|
|---|
| 429 | <em>rop</em>. <em>sx</em>, <em>sy</em>
|
|---|
| 430 | is the top-left pixel in <em>src</em> (0, 0) by default, <em>dx</em>, <em>dy</em> is
|
|---|
| 431 | the top-left position in <em>dst</em> and <em>sw</em>, <em>sh</em> is the size of
|
|---|
| 432 | the copied block (all of <em>src</em> by default).
|
|---|
| 433 | <p> The most common values for <em>rop</em> are CopyROP and XorROP; the <a href="qt.html#RasterOp-enum">Qt::RasterOp</a> documentation defines all the possible values.
|
|---|
| 434 | <p> If <em>ignoreMask</em> is FALSE (the default) and <em>src</em> is a
|
|---|
| 435 | masked <a href="qpixmap.html">QPixmap</a>, the entire blit is masked by <em>src</em>->mask().
|
|---|
| 436 | <p> If <em>src</em>, <em>dst</em>, <em>sw</em> or <em>sh</em> is 0, <a href="#bitBlt">bitBlt</a>() does nothing. If
|
|---|
| 437 | <em>sw</em> or <em>sh</em> is negative bitBlt() copies starting at <em>sx</em> (and
|
|---|
| 438 | respectively, <em>sy</em>) and ending at the right end (respectively,
|
|---|
| 439 | bottom) of <em>src</em>.
|
|---|
| 440 | <p> <em>src</em> must be a <a href="qwidget.html">QWidget</a> or QPixmap. You cannot blit from a
|
|---|
| 441 | <a href="qprinter.html">QPrinter</a>, for example. bitBlt() does nothing if you attempt to
|
|---|
| 442 | blit from an unsupported device.
|
|---|
| 443 | <p> bitBlt() does nothing if <em>src</em> has a greater depth than <em>dst</em>.
|
|---|
| 444 | If you need to for example, draw a 24-bit pixmap on an 8-bit
|
|---|
| 445 | widget, you must use drawPixmap().
|
|---|
| 446 |
|
|---|
| 447 | <h3 class=fn>void <a name="bitBlt-2"></a>bitBlt ( <a href="qpaintdevice.html">QPaintDevice</a> * dst, const <a href="qpoint.html">QPoint</a> & dp, const <a href="qpaintdevice.html">QPaintDevice</a> * src, const <a href="qrect.html">QRect</a> & sr, RasterOp rop )
|
|---|
| 448 | </h3>
|
|---|
| 449 |
|
|---|
| 450 | <p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
|
|---|
| 451 | <p> Overloaded <a href="#bitBlt">bitBlt</a>() with the destination point <em>dp</em> and source
|
|---|
| 452 | rectangle <em>sr</em>.
|
|---|
| 453 |
|
|---|
| 454 | <!-- eof -->
|
|---|
| 455 | <hr><p>
|
|---|
| 456 | This file is part of the <a href="index.html">Qt toolkit</a>.
|
|---|
| 457 | Copyright © 1995-2007
|
|---|
| 458 | <a href="http://www.trolltech.com/">Trolltech</a>. All Rights Reserved.<p><address><hr><div align=center>
|
|---|
| 459 | <table width=100% cellspacing=0 border=0><tr>
|
|---|
| 460 | <td>Copyright © 2007
|
|---|
| 461 | <a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
|
|---|
| 462 | <td align=right><div align=right>Qt 3.3.8</div>
|
|---|
| 463 | </table></div></address></body>
|
|---|
| 464 | </html>
|
|---|
