Application.RootVisual Property (System.Windows)

Switch View

RootVisual Property

Collapse All

Language Filter

.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

public UIElement RootVisual { get; set; }

Property Value

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

Exceptions

Exception	Condition
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

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.

Reference

Application Class

Application Members

System.Windows Namespace