.NET Framework Class Library for Silverlight
Application..::.RootVisual Property

Gets or sets the main application UI.

Namespace:  System.Windows
Assembly:  System.Windows (in System.Windows.dll)
Syntax

Visual Basic (Declaration)
Public Property RootVisual As UIElement
    Get
    Set
Visual Basic (Usage)
Dim instance As Application
Dim value As UIElement

value = instance.RootVisual

instance.RootVisual = value
C#
public UIElement RootVisual { get; set; }

Property Value

Type: System.Windows..::.UIElement
A UIElement that is the main application UI.
Exceptions

ExceptionCondition
InvalidOperationException

When setting this property, the specified value is not an instance of a class that derives from UIElement.

Remarks

You can set the value of the RootVisual property only one time from code, although you get its value any number of times.

Examples

The following code example demonstrates how an application can use a Startup event handler to set the RootVisual property.

Visual Basic
Partial Public Class App
    Inherits Application

    public Sub New()
        InitializeComponent()
    End Sub

    Private Sub Application_Startup(ByVal o As Object, _
        ByVal e As StartupEventArgs) Handles Me.Startup

        Me.RootVisual = New Page()

    End Sub


End Class
C#
using System.Windows; // Application, StartupEventArgs

namespace SilverlightApplication
{
    public partial class App : Application
    {
        public App()
        {
            InitializeComponent();
        }

        private void Application_Startup(object sender, StartupEventArgs e)
        {
            // Specify the main application UI
            this.RootVisual = new Page();
        }
    }
}
Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

See Also

Reference

Tags :


Page view tracker