Adds a g:image element to the g:background element.

Syntax

image_element = g:background.addImageObject(strUNC, intXOffset, intYOffset)

Parameters

strUNC	Required. A Universal Naming Convention (UNC) string that specifies the new image to be added.
intXOffset	Required. An integer that specifies the horizontal position of the image relative to the top-left corner of the background.
intYOffset	Required. An integer that specifies the vertical position of the image relative to the top-left corner of the background.

Return Value

Returns a g:image object.

Remarks

The initial background image remains at the bottom of the z-order and is overlayed with the new image, which effectively becomes part of the background.

Valid image types are .JPG, .BMP, .GIF, and .PNG.

Example

The following example demonstrates how to add an image to a gadget background.

\\ imgBackground is the value of the 'id' attribute for the g:background element.
var imgGlow = imgBackground.addImageObject("file://img.png", 0, 0);

Applies To

g:background

See Also

g:image, g:text