Background Property (Silverlight Plug-in)
Gets or sets the background color of the rectangular region that display XAML content.
|Scripting (Instantiation)|| |
|Scripting (Runtime)|| |
value = silverlightObject.settings.Background
silverlightObject.settings.Background = value
Specifies the background color value as a string, which can either be a named color value, or an 8-bit or 16-bit color value, with or without alpha transparency.
|Color Name||"Red"||A named color value. For a listing of color names, see the Remarks section in Color.|
|8 Bit RGB||"#F00"||An 8-bit RGB value, in the form "#RGB".|
|8 Bit RGB + Alpha||"#8F00"||An 8-bit RGB value with alpha transparency, in the form "#ARGB".|
|16 Bit RGB||"#FF0000"||A 16-bit RGB value, in the form "#RRGGBB". For a listing of hexadecimal equivalents for color names, see the Remarks section in Color.|
|16 Bit RGB + Alpha||"#80FF0000"||A 16-bit RGB value with alpha transparency, in the form "#AARRGGBB". For a listing of hexadecimal equivalents for color names, see the Remarks section in Color.|
|scRGB, no alpha||"sc#1,0,0"||An ScRGB value with no alpha transparency, in the form |
|scRGB, alpha||"sc#0.5,1,0,0"||An ScRGB value with no alpha transparency in the form |
This property is read/write. The default value is null (see Remarks). For more information on how this property is set during plug-in initialization, see Instantiating a Silverlight Plug-in (Using CreateSilverlight.js and Silverlight.js).
This property is available on the settings sub-object of a Silverlight plug-in instance.
For rendering, a null value for the plug-in Background property is interpreted as the named color White.
If the Windowless property is set to true, or on Macintosh (where the window-less mode is always active regardless of the Windowless setting) the Background property value can specify an alpha value for the color. The color value is then blended with the HTML page.
Important Setting an alpha channel value for full or partial transparency has possible performance consequences, particularly on certain client environments. See Performance Tips.
isWindowless:'false', // Display as windowed. background:'#80008080', // Background color of plug-in (alpha + RGB).
isWindowless:'true', // Display as window-less. background:'#80008080', // Background color of plug-in (alpha + RGB).
Notice the displayed output of the preceding plug-in initializations. The background of the first Silverlight plug-in area is opaque. The background of the second Silverlight plug-in are is blended with the background image of the HTML page.