FullScreen
Microsoft Silverlight will reach end of support after October 2021. Learn more.
Gets or sets a value that indicates whether the Silverlight plug-in displays as a full-screen plug-in.
value = silverlightObject.content.FullScreen
silverlightObject.content.FullScreen = value
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.
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.
.gif "Note") 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. |