VisualStateGroup.Name property

Applies to Windows and Windows Phone

Gets the name of the VisualStateGroup.

Syntax


public string Name { get; }


<VisualStateGroup x:Name="groupName"/>

XAML Values

groupName

The name of the VisualStateGroup. Name is a read-only property, so specify the name of the VisualStateGroup by setting the x:Name attribute. An unprefixed string "Name" won't work.

Property value

Type: System.String [.NET] | Platform::String [C++]

The name of the VisualStateGroup.

Remarks

Name is a read-only property that you can check with code at run-time to read the value of the x:Name attribute that was applied to a VisualStateGroup in a XAML control template. You can't literally set Name because it's read-only, and x:Name can only be set in XAML. The value is available as soon as the XAML that contains the control template and the VisualStateGroup definition is loaded.

The need to check the Name of a VisualStateGroup at run-time is anticipated to be relatively uncommon, and would only be relevant to advanced scenarios. For the most part, the definition of a VisualStateGroup in XAML combined with using VisualStateManager and VisualStateGroup events in code provides you all that you need to define and invoke visual states for a custom or Windows Runtime-defined control.

Requirements

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Minimum supported phone

Windows Phone 8.1 [Windows Runtime apps only]

Namespace

Windows.UI.Xaml
Windows::UI::Xaml [C++]

Metadata

Windows.winmd

See also

VisualStateGroup
Quickstart: Control templates
x:Name attribute
VisualStateManager

 

 

Show:
© 2014 Microsoft