Export (0) Print
Expand All

background.addGlow 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 glow effect to the g:background element.

Syntax


iRetVal = background.addGlow(
  strColor,
  intRadius,
  intAlpha
)

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 glow is set using the intAlpha parameter of addGlow described below.

intRadius [in]

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

intAlpha [in]

An integer that sets the transparency of the glow effect as a percentage from 0 (transparent) to 100 (opaque).

Remarks

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

Examples

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


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

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

 

 

Community Additions

ADD
Show:
© 2014 Microsoft