Adding images to .fm2 forms

There is a number of containers and widgets that can have only text but an image as well:

• Button,
• Canvas,
• CheckBox,
• Label,
• ToolbarButton, and
• TabPage.

There are several methods to add an image to your form:

• in Lycia Form Designer - via imageURL of the Image property group,
• in Lycia Theme Designer - via New Image of the Image property group, and
• by ui methods - by setImage() and setImageUrl().

When you add images using LFD, you find and select them in the Select Image window:

Select Image window opens when you click Add for imageURL.

In the Select Image window, you can look and find images in two ways:

• by browsing for the image (default), or
• by entering its URL.

Regardless of what option you select for adding images, the Select Image window will have two panes - Location and Preview.

Preview pane is the same for both options. What is different is the Location pane.

Adding images by browsing

In the Location pane, you see three default locations for the images provided by Lycia:

• source - images added to your project,
• FGLIMAGEPATH - images located in the directory(s) you have specified in the FGLIMAGEPATH environments variable, and

• web resources - images located in the directory(s) you have specified as the physical location of your public resources. By default, it is

  C:\ProgramData\Querix\Lycia\progs\public.

When you spread out any of these locations, you see the files they contain and can choose one of these files:

When you select a file, it is automatically displayed in the Preview pane:

In the Preview pane, you can also learn the image dimensions and its size (if available):

Thus, to add an image by browsing you will follow these steps:

Here you can learn how to add images to your 4gl projects and programs.

Here you can learn how to change the image parameters like position, scaling, and size.

Adding image from URL

In the Location pane, you see a field where you enter the image URL.

There are many ways how you can specify the URL for the image:

1. simple website URL - for any online images,

2. {CONTEXT}/public/<image_name>.<image_extention> - for static resources which physical location is specified in the WebServer configuration files,

3. qx://application/<image_name>.<image_extention> - for images added as the requirement to this 4gl program,

4. qx://embedded/<image_name>.<image_extention> - for the embedded images, i.e. images installed together with Lycia and is located in these folders (by default):

   C:\Program Files\Querix\Lycia\jetty\temp

   C:\Program Files\Querix\Lycia\js_wb\pack

   /opt/Querix/tmp/jetty

5. qx://icon/<space-separated list of icon classes> - for icons of iconic fonts (e.g., Font Awesome), and

6. qx://clienttemp/<image_name>.<image_extention> - for images located in the temporary directory that is generated on the client side.

Once you enter the complete URL, the image is automatically displayed in the Preview pane - the same as with browsing:

If you enter the non-existing URL, you will get this message in the Preview pane - <No preview available>:

Thus, to add an image from URL you will follow these steps: