com.softwareag.mobile.runtime.toolkit.ui.controller

Interface IResourceController

All Known Implementing Classes:

AbstractApplicationController, AbstractViewController, TransitionStackController

public interface IResourceController

This interface provides methods for loading and resizing images as well as for loading html files.

Version:

9.6.0.0000-0237

Method Summary

Methods

Modifier and Type	Method and Description
javax.microedition.lcdui.Image	getDefaultPlaceHolderImage() Return the default place holder image that will be used if requested image was not found.
javax.microedition.lcdui.Image	loadImage(java.lang.String imageName) Tries to find and load image with the given name.
javax.microedition.lcdui.Image	loadImage(java.lang.String imageName, int viewBackGroundcolor) Tries to find and load image with the given name.
javax.microedition.lcdui.Image	loadImage(java.lang.String imageName, int viewBackGroundcolor, int parentsWidth) Tries to find and load image with the given name.
java.lang.String	loadWWWResource(com.softwareag.mobile.runtime.nui.nUIObject target, java.lang.String fileName, java.lang.String prefix, java.lang.String encoding) Loads the given html file to the string
javax.microedition.lcdui.Image	resizeImage(javax.microedition.lcdui.Image image, int width, int height) Resize the given image.

Method Detail

loadWWWResource

java.lang.String loadWWWResource(com.softwareag.mobile.runtime.nui.nUIObject target,
                               java.lang.String fileName,
                               java.lang.String prefix,
                               java.lang.String encoding)

Loads the given html file to the string

Parameters:

target - object that triggers the call

fileName - requested html file

prefix - relative path, where the given file is supposed to be found.

encoding - this encoding will be used by reading the html file. return content of the given file.

getDefaultPlaceHolderImage

javax.microedition.lcdui.Image getDefaultPlaceHolderImage()

Return the default place holder image that will be used if requested image was not found. You can override this method to use another image.

loadImage

javax.microedition.lcdui.Image loadImage(java.lang.String imageName)

Tries to find and load image with the given name. See loadImage(String, int, int) for more details

loadImage

javax.microedition.lcdui.Image loadImage(java.lang.String imageName,
                                       int viewBackGroundcolor)

Tries to find and load image with the given name. See loadImage(String, int, int) for more details

loadImage

javax.microedition.lcdui.Image loadImage(java.lang.String imageName,
                                       int viewBackGroundcolor,
                                       int parentsWidth)

Tries to find and load image with the given name. If image could not be found #defaultPlaceHolderImage will be returned. Following paths are used for searching in the given ordering:

• platform specific folders. E.g. "drawable-mdpi/" on Android or "Non-Retina/" on iOS or "W360/" on BlackBerry. You can change the platform folders by overriding one of the following methods:
  • AbstractApplicationController#getAndroidGraphicsFolder(int, int)
  • AbstractApplicationController#getBlackBerryGraphicsFolder(int, int, int)
  • AbstractApplicationController#getIOSGraphicsFolders(int, int)
  • AbstractApplicationController#getWinPhoneGraphicFolder(int, int, int) see also AbstractApplicationController#getWinPhoneThemeFolder(int)
• platform specific "fallback" folder(it's just a root folder "/")
• general specific folders. E.g. "general/w200/" or "general/w400/". You can extend general folders by overriding AbstractApplicationController#getGeneralGraphicsFolder(int, int)
• general "fallback" folder: "general/"

Parameters:

name - filename to load

viewBackGroundcolor - background color of view, where image will be shown

containerWidth - width of container, where image will be shown. if value is -1, then the smallest side of screen will used as containerWidth

Returns:

an image or default image if image with the given name was not found

resizeImage

javax.microedition.lcdui.Image resizeImage(javax.microedition.lcdui.Image image,
                                         int width,
                                         int height)

Resize the given image. See ImageHandler#resizeImage(Image, int, int, boolean) for more details.