image.top property

Article
05/31/2018

[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 number of pixels from the top edge of the gadget to position the g:image element.

This property is read/write.

Syntax

itop = image.top
image.top = itop

Property value

An Integer that specifies or receives the position, in pixels, of the target element from the top edge of the gadget.

Remarks

[!Caution]
Other than g:background, avoid images that render to the absolute edges of a gadget. In high-DPI, rounding errors can cause a magenta fringe around the border of the gadget.

This value overrides any positioning declared previously.

Examples

The following example demonstrates how to set the top-position of the g:image element from a gadget script file.

\\ imgBackground is the value of the 'id' attribute for the g:background element.
var imgTop = imgBackground.addImageObject(file, intX, intY);
imgTop.top = 50;

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)