Image object (X Evolution 2)Official Content

Images are embedded objects in a GeneXus Knowledge Base. They hold the definition and the actual image(s) of an image that you can use anywhere you need to in your Knowledge Base. Having images as objects in the Knowledge Base provides several benefits, including:

  • Cross reference. You know where images are used.
  • Images can depend on Themes and on Languages. If you change either one or both, all images will be changed automatically.
  • Import/Export objects with the images they use. There's no more need for additional zip files with images.

Creating an Image

An Image can be created using the File/New/Object menu command (or its shortcut keys Ctrl-N), but most of the time you will create a new image when you need to select one to fill the value of a property or anywhere you need an image. Say, for example, you want to show an image in a Web Panel object. You can drag an Image control from the Toolbox into the form. At this time you are prompted to select one of the available images (those already existing in your Knowledge Base). The dialog will look like the one shown below. It has a filter field at the top, a list of image names on the left and a preview pane on the right. There are also two buttons at the bottom of the list of images.

Select Image Dialog

The "Import from file" button lets you create a new GeneXus Image from a file stored in your file system. It opens a file selector and, once you have selected an image file, a new dialog like the one below is opened, prompting you to provide basic information on the image you are creating.

Import Image From File

At this time, just give the name you want to assign to the Image object, and ignore other dialog options. If the default name suits you, just hit the OK button and you're done.

External Images

There may be images you do not "control". For example, you need to reference an image belonging to another company on the Internet, or you just want to share images between applications in your company. These are external images. They are basically the same as internal ones in terms of functionality, but the actual image is not stored in your Knowledge Base. Only its address (URL) is stored there.

Creating an external image is almost the same as creating an internal one. Drag an image control into a Web Panel form and the Select Image dialog appears. Select the "Reference External" Image button and a new dialog (like the one below) will be displayed. You must type in a name for it and provide a Source (i.e. where the image is located). The Source is usually a URL, such as "".

Reference External Image

External and Internal Images

Internal and external images are functionally the same. They can be used, referenced, etc. in the same way as preferences, Themes, source code, properties, etc. The difference is that, while the actual images of an Internal Image are stored in the Knowledge Base, the only thing that is stored for External Images is a reference to where the actual image should be. Internal Images are managed automatically, which means that you no longer need to worry about where the image should be in order for it to be available to your application either at design or runtime. Changes in the location of External Images must be handled manually.

Internal and External Images Sample

On the other hand, Internal Images require more storage space and generate larger Export files than External Images.

Managing Images

The Images node in the Folder View opens the Images tool window, which should look like the following image if the Detail view is the active one. It has several different views: List, Thumbnails, Tile and Detail, which resemble Windows Explorer.

Images Tool Window

On the right there is a Preview pane that shows the actual image, if available. Note that if an External Image is selected and it cannot be found (i.e. the image is not where it is expected to be, or it is on the Internet and there is no Internet connection) it will not be displayed. GeneXus does not cache external images.

When an image is opened (double-click, context menu Open, etc.), a new window appears (like the one below). At this time, you may need more detailed information on how Images are implemented.

A GeneXus Image is actually a container. It holds actual images used for each Language, Theme, or combinations of both. This is great, as changing the current Language and/or the current Theme will change the actual images accordingly without any coding! So, check the Theme dependent checkbox. Once checked, you can add actual images for every Theme in your knowledge Base as shown below.

Edit Image Window

Similarly, checking the Language dependent checkbox lets you add images for every language object in your Knowledge Base. This is helpful when images have text drawn in them.

Changing images at runtime

The actual image shown by a control may be changed at runtime using one of the following methods.

  • FromImage(<ImageName>)
Applies to Bitmap data type Variables and to Image controls. <ImageName> is the name of an Image object stored in the Knowledge Base. If &Bitmap is a bitmap data type variable the following code will change the image displayed by it to MyNewImage.
  • FromImage(<StringExpression>)
Applies to Bitmap data type Variables and to Image controls. <StringExpression> is an expression that must evaluate at runtime to the name of an Image object stored in the Knowledge Base. If &Bitmap is a bitmap data type variable and &Image is a character variable whose value is "MyNewImage", the following code will change the image displayed by it to MyNewImage.
&Bitmap.FromImage( &Image)
  • FromLink(<StringExpression>)
Applies to Bitmap data type Variables and to Image controls. <StringExpression> is a string expression that must evaluate to a valid image URL. This format is equivalent to the LoadBitmap function.
  • Link()
Applies to Image objects. It returns a string containing a link to the actual image for the current Language and Theme (if aplicable). For example:
TableControl.Background = BackgroundImage.Link()

Importing and Exporting Images

Images are "standard objects". They can be exported and imported without any special consideration unless importing from previous versions as discussed here.

As you can see, having images inside the KB improves GeneXus usability and Knowledge integration.

Images used automatically by GeneXus and managed as image object in KB 

GeneXus applications use a set of image objects that are included in the Knowledge Base creation. All images in the GeneXus generated application can be modified using the associated Image object within the Knowledge Base.

All images references can be found in the file images.txt file located in the model target path.


Subcribe to this category's changes
Sub CategoriesAdd a new subcategory in this category
PagesAdd a new page in this category
Was this page helpful?
What Is This?
Your feedback about this content is important. Let us know what you think.