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. If the file name cannot be found, an image reference will be returned, but it will not be loaded - Check the Isloaded property of the image. 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.