IMAGE (declare a graphic image control)

Top  Previous  Next

 

 

 

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:

PALETTE

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.