Appendix A: QIMAGE
| Rapid-Q Documentation by William Yu (c)1999-2000 |
Appendix A: QIMAGE |
|
QIMAGE Component
QImage is used to display a graphical image (BMP/ICON). It can also be used to
draw primitive graphics.
QImage Properties
| Field | Type | R/W | Default |
|
|
|
|
| Align | INTEGER | RW | alNone |
| Align determines how the control aligns within its parent control.
|
| Autosize | INTEGER | RW | False |
| AutoSize determines whether the image control resizes to accommodate the image it displays.
|
| BMP | STRING | RW | |
| Use BMP to assign a new bitmap file, or to store BMP in the image cache.
Examples:
DIM Image AS QIMAGE
Image.BMP = "whatever.bmp"
|
| BMPHandle | RESOURCE | W | |
| Center | INTEGER | RW | False |
| Center positions the image so that it is centered in the image control.
|
| CopyMode | INTEGER | RW | cmBlackness |
| Cursor | INTEGER | RW | crDefault |
| Enabled | INTEGER | RW | True |
| Font | QFONT | W | |
| Handle | INTEGER | RW | |
| Height | INTEGER | RW | |
| Hint | STRING | RW | |
| ICOHandle | RESOURCE | W | |
| Icon | STRING | W | |
| IncrementalDisplay | INTEGER | RW | False |
| IncrementalDisplay specifies whether partial renderings of the image are drawn
periodically during slow operations or on large compressed images.
|
| Left | INTEGER | RW | 0 |
| Parent | QFORM/QPANEL/QTABCONTROL | W | |
| Pixel | 2D ARRAY of INTEGER | RW | |
| PopupMenu | QPOPUPMENU | W | |
| ShowHint | INTEGER | RW | False |
| Stretch | INTEGER | RW | False |
| Stretch resizes the image so that it exactly fits the bounds of the image control.
|
| Tag | INTEGER | RW | |
| Top | INTEGER | RW | 0 |
| Transparent | INTEGER | RW | False |
| Width | INTEGER | RW | |
| Visible | INTEGER | RW | True |
QImage Methods
| Method | Type | Description | Params |
|
|
|
|
| Center | SUB | Centers image | 0 |
| Circle | SUB (x1%, y1%, x2%, y2%, c%, fill%) | Draw & Fill Circle | 6 |
| CopyRect | SUB (D, Image, S) | D and S are QRECTs, Image can be a QImage, QCanvas, or QBitmap | 3 |
| Draw | SUB (x%, y%, BMP) | Draw Bitmap at (X,Y) | 3 |
| FillRect | SUB (x1%, y1%, x2%, y2%, c%) | Draws & Fills a rectangle | 5 |
| Line | SUB (x1%, y1%, x2%, y2%, c%) | Draws a line | 5 |
| Paint | SUB (x%, y%, c%, borderc%) | Fill Region | 4 |
| Pset | SUB (x%, y%, c%) | Pixel plot | 3 |
| Rectangle | SUB (x1%, y1%, x2%, y2%, c%) | Draws a rectangle | 5 |
| Repaint | SUB | Force repainting of image | 0 |
| Rotate | SUB (xOrigin%, yOrigin%, Angle%) | Rotates entire image at specified origin | 3 |
| RoundRect | SUB (x1%, y1%, x2%, y2%, x3%, y3%, c%) | Draws & Fills a rounded rectangle | 7 |
| StretchDraw | SUB (Rect AS QRECT, BMP) | Draw BMP and stretch to fit inside Rect | 2 |
| TextHeight | FUNCTION (Text$) AS WORD | Returns the height, in pixels, of Text$ string | 1 |
| TextWidth | FUNCTION (Text$) AS WORD | Returns the width, in pixels, of Text$ string | 1 |
| TextRect | SUB (Rect AS QRECT, x%, y%, S$, fc%, bc%) | Write text, and clip within region Rect | 6 |
| TextOut | SUB (x%, y%, S$, fc%, bc%) | Writes text to image | 5 |
QImage Events
| Event | Type | Occurs when... | Params |
|
|
|
|
| OnClick | VOID | User clicked on image | 0 |
| OnDblClick | VOID | User double clicked on image | 0 |
| OnMouseDown | SUB (Button%, X%, Y%, Shift%) | Mouse button held down | 4 |
| OnMouseMove | SUB (X%, Y%, Shift%) | Mouse moves | 3 |
| OnMouseUp | SUB (Button%, X%, Y%, Shift%) | Mouse button is released | 4 |
QImage Examples
'-- How to use a resource file
CONST False = 0
CONST True = 1
$RESOURCE RES_BMP1 AS "C:\WINDOWS\CLOUDS.BMP"
DIM Form AS QForm
DIM Image AS QImage
Image.Parent = Form
Image.Autosize = True
Image.BMPHandle = RES_BMP1
Form.ShowModal
|
|