image.src property

[The Windows Gadget Platform/Sidebar is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions. ]

Gets or sets the image file used by the g:image element.

This property is read/write.

Syntax

strsrc = image.src
image.src(strUNC) = strsrc

Property value

a UNC path or a URI.

Remarks

Valid image filetypes are .JPG, .BMP, .GIF, or .PNG.

Special characters in UNC paths should be escaped with a '\'.

Examples

The following example demonstrates how to specify a new image for the g:image element from a gadget script file.

// imgBackground is the value of the 'id' attribute for the g:background element.
var imgSrc = imgBackground.addImageObject(file, intX, intY);
imgSrc.src = "..\\aero\%logo.png";

Requirements

Minimum supported client
Windows Vista [desktop apps only]
Minimum supported server
Windows Server 2008 [desktop apps only]
End of client support
Windows 7
End of server support
Windows Server 2008
IDL
Sidebar.idl
DLL
Sidebar.Exe (version 1.00 or later)

See also

Reference

background

image

text