FullScreen Property

Gets or sets whether the Silverlight plugin displays as a full-screen plugin.

Scripting (Instantiation)
Cannot be set during instantiation.
Scripting (Runtime)
value = silverlightObject.content.FullScreen
silverlightObject.content.FullScreen = value

Property Value

Boolean

Determines whether the Silverlight plugin displays as a full-screen plugin or embedded plugin.

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

Remarks

This property is available on the content sub-object of a Silverlight plugin instance.

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

You cannot set this property during instantiation. Typically you would switch to fullscreen only as a user-initiated action and therefore you would set fullscreen to true as part of a mouse or keyboard event handler.

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

  • embedded mode--plugin displays within the Web browser.
  • full-screen mode--plugin displays on top of all other applications.

When the Silverlight plugin displays in embedded mode, the plugin is contained within the browser window. When Silverlight plugin displays in full-screen mode, the plugin resizes to the current resolution of the display and overlays all other applications, including the browser. The following illustration shows the differences between embedded mode and full-screen mode.

Silverlight plugin displaying as embedded and full-screen mode

Embedded mode and full-screen mode

When a Silverlight plugin is displayed as full-screen, a message appears briefly. This message alerts the user that the application is now in full-screen mode, and provides information on how to return to embedded mode. The following illustration shows this message.

Fullscreen message

Fullscreen message

The OnFullScreenChange event occurs whenever the FullScreen property changes.

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

Applies To

Silverlight Plugin

See Also

Silverlight Full Screen Support
ActualHeight
ActualWidth
OnFullScreenChange