| Navigation: Language Reference > 8 - Controls > Control Declarations >====== IMAGE (declare a graphic image control) ====== |    |
| IMAGE(file), | AT( ) [,USE( )] [,DISABLE] | [ ,FULL ] | [,SCROLL] [,HIDE] [,LAYOUT] | |||||
| [ , | TILED | ] | [, | HSCROLL | ] [,EXTEND ( )] | |||
| CENTERED | VSCROLL | |||||||
| HVSCROLL |
| IMAGE | Places a graphic image on the WINDOW, TOOLBAR, or REPORT. |
| file | A string constant or equate (see below) containing the name of the file to display (PROP:Text). The named file is automatically linked into the .EXE as a resource. |
| AT | Specifies the initial size and location of the control (PROP:AT). If omitted, default values are selected by the runtime library. |
| USE | A field equate label to reference the control in executable code (PROP:USE). |
| DISABLE | Specifies the control appears dimmed when the WINDOW or APPLICATION opens (PROP:DISABLE). |
| FULL | Specifies the control expands to occupy the entire size of the WINDOW for any missing AT attribute width or height parameter (PROP:FULL). Not valid in a REPORT. |
| SCROLL | Specifies the control scrolls with the window (PROP:SCROLL). Not valid in a REPORT. |
| HIDE | Specifies the control does not appear when the WINDOW or APPLICATION opens (PROP:HIDE). UNHIDE must be used to display it. |
| TILED | Specifies the image displays at its default size and is tiled to fill the entire area of the IMAGE (PROP:TILED). |
| CENTERED | Specifies the image displays at its default size and is centered in the area of the IMAGE (PROP:CENTERED). |
| HSCROLL | Specifies a horizontal scroll bar is automatically added to the IMAGE control when the graphic image is wider than the area specified for display (PROP:HSCROLL). Not valid in a REPORT. |
| VSCROLL | Specifies a vertical scroll bar is automatically added to the IMAGE control when the graphic image is taller than the area specified for display (PROP:VSCROLL). Not valid in a REPORT. |
| HVSCROLL | Specifies both vertical and horizontal scroll bars are automatically added to the IMAGE control when the graphic image is larger than the display area. Not valid in a REPORT. |
| LAYOUT | Specifies the control's left-to-right or right-to-left display orientation (PROP:LAYOUT) |
| EXTEND | Specifies special document formatting information. This information contains a valid string of attributes that are assigned to a designated REPORT control for a given document type. Valid only in a REPORT. See also EXTEND |
The IMAGE control places a graphic image on the WINDOW (or TOOLBAR) at the position specified by its AT attribute. It is valid in Clarion Win32 Windows, and also for REPORT structures in both Clarion Win32 and Clarion#. The image is stretched to fill the area specified by the AT attribute unless the TILED or CENTERED attribute is present. The displayed file may be a bitmap (.BMP), PaintBrush (.PCX), Graphic Interchange Format (.GIF), JPEG (.JPG), or Windows metafile (.WMF). The file may be an icon (.ICO) or Icon Equate in an IMAGE on a WINDOW but not on a REPORT, because Windows does not support printing icons. The type of file is determined by its extension.
This control cannot receive input focus and does not generate events.
Example:
MDIChild WINDOW('Child One'),AT(0,0,320,200),MDI,MAX,HVSCROLL
IMAGE('PIC.BMP'),AT(0,0,20,20),USE(?I1)
IMAGE('PIC.WMF'),AT(40,0,20,20),USE(?I3),SCROLL
END
CustRpt REPORT,AT(1000,1000,6500,9000),THOUS
CustDetail DETAIL,AT(0,0,6500,1000)
IMAGE('PIC.BMP'),AT(0,0,20,20),USE(?I1)
IMAGE('PIC.WMF'),AT(40,0,20,20),USE(?I2)
IMAGE('PIC.JPG'),AT(60,0,20,20),USE(?I3)
END
END
See Also:
How to Assign an Image to Display at Runtime
PROP:ClipBits, PROP:ImageBits, PROP:ImageBlob
There are many other properties associated with the processing of an Image control at runtime.
See PROP:HScroll, PROP:VScroll, PROP:HScrollPos, PROP:VScrollPos, PROP:XOrigin, PROP:YOrigin, PROP:ImageInstance, PROP:PrintMode, and PROP:Active.