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
|
|