| **Navigation:**  [[introduction.htm|Language Reference]] > 8 - Controls > Control Declarations >====== IMAGE (declare a graphic image control) ====== | [[group  declare a group of controls .htm|{{btn_prev_n.gif|Previous page}}]][[introduction.htm|{{btn_home_n.gif|Return to chapter overview}}]][[item  declare a menu item .htm|{{btn_next_n.gif|Next page}}]] |
|  ||

|  | **IMAGE(**//file//**)**, | **AT( )** [,**USE( )**] [,**DISABLE**] | [ ,**FULL **] | [,**SCROLL**] [,**HIDE**] [,**LAYOUT**] |
|  |  |  | [ ,|**TILED**| ] | [,| **HSCROLL**| ] [,**EXTEND ( )**] |
|  |  |  | | **CENTERED**| | | **VSCROLL**| |
|  |  |  |  | |**HVSCROLL**| |

{{blk2blue.jpg|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 [[comment set document formatting .htm|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  set number of hardware colors .htm|PALETTE]]

[[how to assign an image to display at runtime.htm|How to Assign an Image to Display at Runtime]]

[[prop clipbits.htm|PROP:ClipBits]], [[prop imagebits.htm|PROP:ImageBits]], [[prop imageblob.htm|PROP:ImageBlob]]

{{notebox.jpg|NoteBox.jpg}}

There are many other properties associated with the processing of an Image control at runtime.

See [[hscroll  vscroll  hvscroll  set scroll bars .htm|PROP:HScroll]], [[hscroll  vscroll  hvscroll  set scroll bars .htm|PROP:VScroll]], [[prop hscrollpos.htm|PROP:HScrollPos]], [[prop vscrollpos.htm|PROP:VScrollPos]], [[prop xorigin.htm|PROP:XOrigin]], [[prop xorigin.htm|PROP:YOrigin]], [[prop imageinstance.htm|PROP:ImageInstance]], [[prop printmode.htm|PROP:PrintMode]], and [[prop active.htm|PROP:Active]].