background.addShadow method

[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. ]

Adds a shadow effect to the g:background image.

Syntax

iRetVal = background.addShadow(
  strColor,
  intRadius,
  intAlpha,
  intDeltaX,
  intDeltaY
)

Parameters

strColor [in]

A named Windows color (such as "Black") or a color in the format "Color(Alpha, R, G, B)" where the Alpha, R, G, and B values can range from 0 to 255.

Note   If using the "Color(Alpha, R, G, B)" specification, the Alpha value is superfluous. The transparency of the shadow is set using the intAlpha parameter of addShadow described below.

intRadius [in]

An integer that specifies the radius (or boundary), in pixels, that the shadow effect extends outward from the edge of the target element.

intAlpha [in]

An integer that sets the transparency of the shadow effect. The value can range from 0 (transparent) to 100 (opaque).

intDeltaX [in]

The offset, in pixels, from the leftmost edge of the target element.

intDeltaY [in]

The offset, in pixels, from the rightmost edge of the target element.

Remarks

The opacity of the target element must be set to a value of at least 1 for the shadow effect to be visible.

Examples

The following example demonstrates how to add a shadow effect to a g:background element.

\\ imgBackground is the value of the 'id' attribute for the g:background element.
imgBackground.addShadow("black", 50, 50, 0, 0);
imgBackground.addShadow("Color(255, 255, 0, 0)", 50, 25, 0, 0);

Requirements

See also

Reference

background

image

text

Send comments about this topic to Microsoft

Build date: 10/27/2012