User Tools

Site Tools


image_declare_a_graphic_image_control_.htm
Navigation:  Language Reference > 8 - Controls > Control Declarations >====== IMAGE (declare a graphic image control) ====== Previous pageReturn to chapter overviewNext page
IMAGE(file), AT( ) [,USE( )] [,DISABLE] [ ,FULL ] [,SCROLL] [,HIDE] [,LAYOUT]
[ ,TILED ] [, HSCROLL ] [,EXTEND ( )]
CENTERED VSCROLL
HVSCROLL

blk2blue.jpg

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

NoteBox.jpg

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.

image_declare_a_graphic_image_control_.htm.txt · Last modified: 2021/04/15 15:57 (external edit)