AvGetImageReference Method

Method: avGetImageReference

Parameters:

Name

Usage

Class

Description

Filename

Input

Alpha – max length 50

This is the name of the file (without the path). Alphanumeric.

Source

Input

Alpha

The image source O=Other, T=Themed

The default is O

Size

Input

Alpha

The size Small, Medium, Large or XLarge.

Default is Medium.

Applies to Source(T) requests only.

ReverseDarkandLight

Input

Boolean

Reverse light and dark requests.

Default is false. Applies to Source(T) requests only.

Bitmap

Result

PRIM_BMP reference

This is a reference to the image or *null if it cannot be found.

Set your displayed image's Image property to this value.

 

See shipped example DF_T44H1O for more details.

This method returns references to images from subfolders of the folder <LANSA root>\X_WIN95\X_LANSA\x_dem\web\vl\vlfone\images. 

The themed (ie: Source(T)) subfolders are named Black, Blue and White.

These folders themselves each have Large, Medium Small and XLarge subfolders.

The 'other' non-themed (ie: Source(O)) subfolder is named Other. There are no subfolders.

Source(T) themed images are derived at execution time as being Black, Blue or White depending on the theme you are currently using and the ReverseLightandDark usage context parameter.

They are then further refined by the Size parameter.

This means that when you choose an image from this screen:

You are not selecting a specific image. You are selecting an image that may vary at execution time according to the theme and light and dark usage context.

To see a change in usage context open two command handler panes and watch the images on the title area change as the pane is brought to the front.

If you add an image to the themed set you should provide it in 12 versions – 3 colors and 4 sizes.

Source(O) other images refer directly to an image in the other folder.

You can add custom images to the 'Other' folder at will and control their sizing yourself.