VisualState.Name Свойство

Определение

Пространство имен:

System.Windows

Сборка:

PresentationFramework.dll

Возвращает или задает имя таблицы для объекта VisualState.

public:
 property System::String ^ Name { System::String ^ get(); void set(System::String ^ value); };

public string Name { get; set; }

member this.Name : string with get, set

Public Property Name As String

Значение свойства

String

Имя VisualState.

Примеры

В следующем примере создается вызываемая ControlTemplate VisualStateGroup Button CommonStates и добавляется VisualState объекты для состояний, Normal``Pressedи .MouseOver Кроме Button того, определяется состояние, которое Disabled находится в CommonStates VisualStateGroupэлементе, но в примере он не используется для краткости. Полный пример см. в разделе "Настройка внешнего вида существующего элемента управления путем создания элемента управления".

  <!--Define the states and transitions for the common states.
      The states in the VisualStateGroup are mutually exclusive to
      each other.-->
  <VisualStateGroup x:Name="CommonStates">

    <!--The Normal state is the state the button is in
        when it is not in another state from this VisualStateGroup.-->
    <VisualState x:Name="Normal" />

    <!--Change the SolidColorBrush, BorderBrush, to red when the
        mouse is over the button.-->
    <VisualState x:Name="MouseOver">
      <Storyboard>
        <ColorAnimation Storyboard.TargetName="BorderBrush" 
                        Storyboard.TargetProperty="Color" 
                        To="Red" />
      </Storyboard>
    </VisualState>

    <!--Change the SolidColorBrush, BorderBrush, to Transparent when the
        button is pressed.-->
    <VisualState x:Name="Pressed">
      <Storyboard>
        <ColorAnimation Storyboard.TargetName="BorderBrush" 
                        Storyboard.TargetProperty="Color"
                        To="Transparent"/>
      </Storyboard>
    </VisualState>

    <!--The Disabled state is omitted for brevity.-->
  </VisualStateGroup>
</VisualStateManager.VisualStateGroups>

Комментарии

Вы указываете, какое визуальное состояние элемент должен вводить, передавая Name VisualState элемент в VisualStateManager.

Если элемент Control управления используется VisualStateManager в ControlTemplateэлементе управления, автор элемента управления должен указать объекты, которые VisualState элемент управления ожидает найти в ней ControlTemplate , поместив TemplateVisualStateAttribute подпись класса в подпись класса. ControlTemplate авторы определяют новые VisualState объекты и устанавливают Name для свойства значение, указанное свойством TemplateVisualStateAttribute.Name .

Чтобы найти имена визуальных состояний для элементов управления, включенных в WPF, см. статью "Стили и шаблоны элементов управления". Сведения о том, как создать объект ControlTemplate и VisualState объекты для существующих элементов управления, см. в разделе "Настройка внешнего вида существующего элемента управления путем создания элемента управления".