FullScreen

Property Value

Type: Boolean

true if the Silverlight plug-in displays as a full-screen plug-in; false if the Silverlight plug-in displays as an embedded plug-in.

This property is read/write. The default value is false.

Managed Equivalent

IsFullScreen

Remarks

This property is available on the content subobject of a Silverlight plug-in instance.

If the value is set to true, the Silverlight plug-in displays as a full-screen plug-in. Otherwise, the Silverlight plug-in displays as an embedded plug-in.

You cannot set this property during instantiation. You can switch to full screen only as a user-initiated action. Typically you would set this property to true as part of a mouse or keyboard event handler. Silverlight will block attempts to set FullScreen on actions that are not user initiated, such as in an OnLoad (Silverlight Plug-in Object) handler.

A Silverlight plug-in can display in embedded mode or full-screen mode:

• In embedded mode, the plug-in is contained in the Web browser window.

• In full-screen mode, the plug-in is resized to the current resolution of the display and displays on top of all other applications, including the browser.

When a Silverlight plug-in is displayed in full-screen mode, a message appears briefly. This message alerts the user that the application is now in full-screen mode, and provides information about how to return to embedded mode.

The OnFullScreenChanged event occurs whenever the FullScreen 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.

Applies To

Silverlight Plug-in

See Also

Reference