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
Prev ComponentContentsNext Component