In a window

• direct assignment:
  
  IMG_MyImage = "C:\Temp\MyImage.gif"
  
• assignment by variable:
  
  ImagePath = fCurrentDir() + "\MyImage.gif"
  IMG_MyImage = ImagePath
  
  
  Remark: An Image control can also be initialized from a buffer variable or from a text variable containing the image value in binary format.

In a page

• Server code:
  
  <Image control> = <Image name>
  
  Remark: In server code, if the image is available in a directory other than "<ProjectName>_WEB", you must:
  • specify the full path of image.
  • have read rights in this directory.
• Browser code:
  
  <Image control> = FolderWeb() + <Image name>
  
  Remark: if the option "Locate the image in the _WEB directory in browser code" is checked ("Details" tab in the control description window), FolderWeb is useless. The following syntax can be used:
  
  <Image control> = <Image name>
  
  Remark: If the control is associated with an item of a data file, the assignment is automatically performed via FileToPage. For more details, see Linking an Image control to an item.

In a window

• perform a simple assignment. For example:
  
  EDT_CurrentImageContent = IMG_Image1
  
• retrieve part of the name, with fExtractPath. For example:
  
  NameImageFile = fExtractPath(IMG_Image1, fFileName + fExtension)
  
• use Value

1. If the control is associated with a text item, the value entered is automatically retrieved via ScreenToFile. You also have the ability to use the following notation: CUSTOMER.NAME = EDT_Edit1.
2. If the control is associated with a binary memo, use HLinkMemo to associate the image file with the item.
3. If the Image control was assigned from a buffer variable or from a string variable, Value returns an empty string.
   See Linking an Image control to an item for more details.

In a page

• perform a simple assignment. For example:
  
  EDT_CurrentImageContent = IMG_Image1
  
• use Value.
• use Libellé (server code only).

1. If the field is associated with a text Item, the value entered is automatically retrieved using the PageToFile function. You also have the ability to use the following notation: CUSTOMER.NAME = EDT_Edit1.
2. If the control is associated with a binary memo, use HLinkMemo to associate the image file with the item.
   For more details, see Linking an Image control to an item.

To retrieve the position of the mouse in a click area, the following functions must be used in the click code of the image:

MouseXPos	Returns the horizontal coordinate of the mouse click.
MouseYPos	Returns the vertical coordinate of the mouse click.

The following properties are used to manage the characteristics of an Image control by programming.

Animation	Used to find out the current status of the animated image or to stop the animation of an animated image (animated GIF image for example)
InitialAnimation	Used to find out the initial status of the animation in an Image control
HorizontalAlignment	Used to find out and modify the horizontal alignment of the image caption
VerticalAlignment	Used to find out and modify the vertical alignment of the image caption
ImageMode	Used to find out and modify the display mode of an image in an Image control.

To find out the entire list of WLanguage properties that can be used with an Image control, see Properties associated with an Image control.