Setter Klasa

Definicja

Przestrzeń nazw:

System.Windows

Zestaw:

PresentationFramework.dll

Reprezentuje element ustawiający, który stosuje wartość właściwości.

public ref class Setter : System::Windows::SetterBase, System::ComponentModel::ISupportInitialize

[System.Windows.Markup.XamlSetMarkupExtension("ReceiveMarkupExtension")]
[System.Windows.Markup.XamlSetTypeConverter("ReceiveTypeConverter")]
public class Setter : System.Windows.SetterBase, System.ComponentModel.ISupportInitialize

[<System.Windows.Markup.XamlSetMarkupExtension("ReceiveMarkupExtension")>]
[<System.Windows.Markup.XamlSetTypeConverter("ReceiveTypeConverter")>]
type Setter = class
    inherit SetterBase
    interface ISupportInitialize

Public Class Setter
Inherits SetterBase
Implements ISupportInitialize

Dziedziczenie

Object

SetterBase

Setter

Atrybuty

XamlSetMarkupExtensionAttribute XamlSetTypeConverterAttribute

Implementuje

ISupportInitialize

Przykłady

W poniższym przykładzie zdefiniowano Style, które zostaną zastosowane do każdego elementu TextBlock. Ta Style stosuje wartości do kilku właściwości TextBlock z użyciem Setters.

<Style TargetType="{x:Type TextBlock}">
  <Setter Property="FontFamily" Value="Segoe Black" />
  <Setter Property="HorizontalAlignment" Value="Center" />
  <Setter Property="FontSize" Value="12pt" />
  <Setter Property="Foreground" Value="#777777" />
</Style>

W poniższym przykładzie pokazano nazwaną Style dostępną do Button kontrolek. Style definiuje element Trigger, który zmienia właściwość Foreground przycisku, gdy właściwość IsPressed jest true.

<Style x:Key="Triggers" TargetType="Button">
    <Style.Triggers>
    <Trigger Property="IsPressed" Value="true">
        <Setter Property = "Foreground" Value="Green"/>
    </Trigger>
    </Style.Triggers>
</Style>

Uwagi

Styles i różne typy wyzwalaczy (klasy dziedziczone z TriggerBase) używają Setters do stosowania wartości właściwości.

Należy określić zarówno właściwości Property, jak i Value na Setter, aby element setter był zrozumiały. W programie .NET 8 i starszych wersjach zgłaszany jest wyjątek, jeśli nie ustawiono jednej lub obu właściwości.

Content Model: w wersji .NET 9 i nowszych właściwość zawartości dla Setter jest Valuei jest opcjonalna, aby określić Value jako atrybut.

Konstruktory

Setter()	Inicjuje nowe wystąpienie klasy Setter.
Setter(DependencyProperty, Object)	Inicjuje nowe wystąpienie klasy Setter z określoną właściwością i wartością.
Setter(DependencyProperty, Object, String)	Inicjuje nowe wystąpienie klasy Setter z określoną właściwością, wartością i nazwą docelową.

Właściwości

IsSealed	Pobiera wartość wskazującą, czy ten obiekt jest w stanie niezmiennym. (Odziedziczone po SetterBase)
Property	Pobiera lub ustawia właściwość, do której zostanie zastosowana Value.
TargetName	Pobiera lub ustawia nazwę obiektu, który jest przeznaczony dla tego Setter.
Value	Pobiera lub ustawia wartość, która ma być stosowana do właściwości określonej przez tę Setter.

Metody

CheckSealed()	Sprawdza, czy ten obiekt jest tylko do odczytu i nie można go zmienić. (Odziedziczone po SetterBase)
Equals(Object)	Określa, czy określony obiekt jest równy bieżącemu obiektowi. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Pobiera Type bieżącego wystąpienia. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Object. (Odziedziczone po Object)
ReceiveMarkupExtension(Object, XamlSetMarkupExtensionEventArgs)	Obsługuje przypadki, w których rozszerzenie znaczników zapewnia wartość właściwości obiektu Setter.
ReceiveTypeConverter(Object, XamlSetTypeConverterEventArgs)	Obsługuje przypadki, w których konwerter typów zapewnia wartość właściwości obiektu Setter.
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Jawne implementacje interfejsu

ISupportInitialize.BeginInit()	Sygnalizuje rozpoczęcie inicjowania obiektu.
ISupportInitialize.EndInit()	Sygnalizuje ukończenie inicjowania obiektu.

Zobacz też

• EventSetter
• TriggerBase