Setter Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Representa um setter que aplica um valor de propriedade.
public ref class Setter : System::Windows::SetterBase
public ref class Setter : System::Windows::SetterBase, System::ComponentModel::ISupportInitialize
public class Setter : System.Windows.SetterBase
[System.Windows.Markup.XamlSetMarkupExtension("ReceiveMarkupExtension")]
[System.Windows.Markup.XamlSetTypeConverter("ReceiveTypeConverter")]
public class Setter : System.Windows.SetterBase, System.ComponentModel.ISupportInitialize
type Setter = class
inherit SetterBase
[<System.Windows.Markup.XamlSetMarkupExtension("ReceiveMarkupExtension")>]
[<System.Windows.Markup.XamlSetTypeConverter("ReceiveTypeConverter")>]
type Setter = class
inherit SetterBase
interface ISupportInitialize
Public Class Setter
Inherits SetterBase
Public Class Setter
Inherits SetterBase
Implements ISupportInitialize
- Herança
- Atributos
- Implementações
Exemplos
O exemplo seguinte define um Style que será aplicado a todos os TextBlock elementos. Isto Style aplica valores a várias TextBlock propriedades com o uso de 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>
O exemplo seguinte mostra um nome Style disponível para Button controlos. Define Style um Trigger elemento que altera a Foreground propriedade de um botão quando a IsPressed propriedade é true.
<Style x:Key="Triggers" TargetType="Button">
<Style.Triggers>
<Trigger Property="IsPressed" Value="true">
<Setter Property = "Foreground" Value="Green"/>
</Trigger>
</Style.Triggers>
</Style>
Observações
Styles e os diferentes tipos de gatilhos (classes que herdam de TriggerBase) usam Setters para aplicar valores de propriedades.
Deve especificar tanto as propriedades como PropertyValue e em um Setter para que o colocador seja significativo. No .NET 8 e versões anteriores, é lançada uma exceção se uma ou ambas as propriedades não estiverem definidas.
Content Model: Em versões .NET 9 e posteriores, a propriedade de conteúdo para Setter é Value, e é opcional especificar Value como atributo.
Construtores
| Name | Description |
|---|---|
| Setter() |
Inicializa uma nova instância da Setter classe. |
| Setter(DependencyProperty, Object, String) |
Inicializa uma nova instância da Setter classe com a propriedade, valor e nome do destino especificados. |
| Setter(DependencyProperty, Object) |
Inicializa uma nova instância da Setter classe com a propriedade e valor especificados. |
Propriedades
| Name | Description |
|---|---|
| IsSealed |
Obtém um valor que indica se este objeto está num estado imutável. (Herdado de SetterBase) |
| Property |
Obtém ou define a propriedade à qual será aplicada Value . |
| TargetName |
Obtém ou define o nome do objeto para o qual isto Setter se destina. |
| Value |
Obtém ou define o valor a aplicar à propriedade especificada por este Setter. |
Métodos
| Name | Description |
|---|---|
| CheckSealed() |
Verifica se este objeto é apenas de leitura e não pode ser alterado. (Herdado de SetterBase) |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| ReceiveMarkupExtension(Object, XamlSetMarkupExtensionEventArgs) |
Trata casos em que uma extensão de marcação fornece um valor para uma propriedade de Setter um objeto. |
| ReceiveTypeConverter(Object, XamlSetTypeConverterEventArgs) |
Trata de casos em que um conversor de tipos fornece um valor para uma propriedade de um Setter objeto. |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |
Implementações de Interface Explícita
| Name | Description |
|---|---|
| ISupportInitialize.BeginInit() |
Sinaliza ao objeto que a inicialização está a começar. |
| ISupportInitialize.EndInit() |
Sinaliza ao objeto que a inicialização está completa. |