Style.BasedOn Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Windows
Assembly:
PresentationFramework.dll

Ottiene o imposta uno stile definito che è la base dello stile corrente.

public:
 property System::Windows::Style ^ BasedOn { System::Windows::Style ^ get(); void set(System::Windows::Style ^ value); };
public System.Windows.Style BasedOn { get; set; }
[System.Windows.Markup.Ambient]
public System.Windows.Style BasedOn { get; set; }
member this.BasedOn : System.Windows.Style with get, set
[<System.Windows.Markup.Ambient>]
member this.BasedOn : System.Windows.Style with get, set
Public Property BasedOn As Style

Valore della proprietà

Style

Stile definito che è la base dello stile corrente. Il valore predefinito è null.

Attributi
AmbientAttribute

Esempio

Esistono diversi modi in cui gli stili in WPF possono essere estesi o ereditati. Gli stili possono essere basati su altri stili tramite questa proprietà. Quando si usa questa proprietà, il nuovo stile erediterà i valori dello stile originale non ridefinito in modo esplicito nel nuovo stile. Nell'esempio Style2 seguente eredita il Control.Background valore di Yellowe aggiunge un Control.Foreground valore di Blue.


<Style x:Key="Style1">
  <Setter Property="Control.Background" Value="Yellow"/>
</Style>

<Style x:Key="Style2" BasedOn="{StaticResource Style1}">
  <Setter Property="Control.Foreground" Value="Blue"/>
</Style>

Analogamente, gli stili possono essere basati sullo stile di un elemento WPF esistente, come nell'esempio seguente in cui il nuovo stile è basato sullo stile di un TextBlock elemento.

  <Style
x:Key="TitleText"
BasedOn="{StaticResource {x:Type TextBlock}}"
TargetType="{x:Type TextBlock}">
    <Setter Property="FontSize" Value="32pt" />
    <Setter Property="Foreground">
      <Setter.Value>
        <LinearGradientBrush StartPoint="0.5,0" EndPoint="0.5,1">
          <LinearGradientBrush.GradientStops>
            <GradientStop Offset="0.0" Color="#90C117" />
            <GradientStop Offset="1.0" Color="#5C9417" />
          </LinearGradientBrush.GradientStops>
        </LinearGradientBrush>
      </Setter.Value>
    </Setter>
    <Setter Property="RenderTransform">
      <Setter.Value>
        <TranslateTransform X="0" Y="10"/>
      </Setter.Value>
    </Setter>
  </Style>

Nota

Se si crea uno stile con una proprietà e lo si basa su un altro stile che definisce anche una TargetType TargetType proprietà, il tipo di destinazione dello stile derivato deve essere uguale o derivato dal tipo dello stile di base.

Gli stili definiti per tipi specifici possono essere basati anche su altri stili, come nell'esempio seguente.

<Style TargetType="{x:Type Button}" BasedOn="{StaticResource Style1}">
  <Setter Property="Foreground" Value="Green"/>
</Style>

Commenti

Ogni stile supporta solo un BasedOn valore.

Uso della sintassi XAML per gli attributi

<object BasedOn="myStyle" .../>

Valori XAML

Mystyle
Stile esistente. In genere, si usano estensioni di markup e XAML WPF per fare riferimento a uno stile esistente.

Si applica a

Vedi anche