Tag name: <amc:image>

The Image component renders an image specified by the source property.

image screenshot
image component.

<amc:image source="/images/globalhelp.gif" 
          shortDesc="global help"
          longDescURL="help.html"
          id="i2"/>

Attributes

Name Type Supports EL? Description
align String Yes Specifies the horizontal alignment of an element with respect to the surrounding context. Valid values:
  • left (default): the component is rendered flush left.
  • center: the component is centered horizontally.
  • right: the component is rendered flush right.
The attribute is ignored and defaulted to left when the parent Panel Group Layout has a horizontal layout.

Note: On BlackBerry smartphones, if the attribute value is assigned by an EL expression, any changes to the value will not affect the visual appearance of the element once it is rendered.
backgroundColor String Yes Sets the color of a background to an RGB value (rgb(255,0,0)) or a hexadecimal number (#ff0000 or #f00). The default value is device-dependent.
height int Yes Specifies the height of the component. Can be entered in pixels or as a percentage of its parent's height. A percentage value should be entered as a number followed by the "%" symbol. A number will be interpreted as a pixel value (as will a number followed by the text "px").
id String No Specifies the identifier for the component. The identifier must follow the following rules:
  • Must not be a zero-length String.
  • First character must be an ASCII letter (A-Za-z) or an underscore ('_').
  • Subsequent characters must be an ASCII letter or digit (A-Za-z0-9), an underscore ('_'), or a dash ('-').
rendered boolean Yes Specifies whether or not the component is rendered. When set to false, no output will be delivered for this component (the component will not in any way be rendered, and cannot be made visible).
source String Yes Specifies the location of the image resource. The image file must be included in the MobileClient project, and specified by its relative location in the project. This attribute can be specified as static text, EL Expression, or combination of both.
verticalAlign String Yes Specifies the vertical alignment of a component with respect to the surrounding context. Valid values:
  • top: the component is rendered flush top.
  • middle: the component is centered vertically.
  • bottom: the component is rendered flush bottom.
This attribute is ignored and defaulted to top when the parent Panel Group Layout has a vertical layout.

Note: On BlackBerry smartphones, if the attribute value is assigned by an EL expression, any changes to the value will not affect the visual appearance of the element once it is rendered.
width int Yes Specifies the width of this component. Can be entered in pixels or as a percentage of its parent's width. A percentage value should be entered as a number followed by the "%" symbol. A number will be interpreted as a pixel value (as will a number followed by the text "px").