FullScreen (Silverlight Plug-in Object)

Syntax

object Element

Silverlight.js

JavaScript

silverlightObject.content.fullScreen = bool;
bool = silverlightObject.content.fullScreen;

COM

Managed Code

Property Value

true if the Silverlight plug-in is displayed as a full-screen plug-in; false if the Silverlight plug-in is displayed as an embedded plug-in. The default value is false.

Remarks

For more information about full-screen behavior, which includes limitations on input, see Full-Screen Support.

You cannot set this property during instantiation. You cannot set this value in an onLoad handler (JavaScript) or Loaded handler (managed API). Typically, you switch to full-screen mode only in response to a user action. You can set IsFullScreen only in a handler for a user-initiated event, such as a mouse event or a keyboard event that is captured by the UI. Events from controls that incorporate lower level input, such as Click, are considered as user-initiated also.

A Silverlight plug-in can be displayed in either embedded mode or full-screen mode:

• In embeddedmode, the plug-in is displayed in the Web browser content area.

• In full-screen mode, the plug-in is displayed on top of all other applications.

When a Silverlight plug-in is displayed in full-screen mode, a message is displayed briefly that overlays the Silverlight content. This message alerts the user that the application is in full-screen mode, and provides information about how to return to embedded mode. The following illustration shows this message.

The FullScreenChanged event occurs when the value of the FullScreen / Content.IsFullScreen property changes.

Note:
For best performance, when your application goes into full-screen mode, hide or disconnect from the tree all the objects that are not being rendered in full-screen mode. You can hide an object by setting its Visibility property to Collapsed.

See Also

Reference

Concepts