Style.BasedOn Style.BasedOn Style.BasedOn Style.BasedOn Property

Definition

Ruft einen definierten Stil ab, der die Grundlage für den aktuellen Stil ist, oder legt diesen fest.Gets or sets a defined style that is the basis of the current style.

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

Eigenschaftswert

Ein definierter Stil, der die Grundlage für den aktuellen Stil darstellt.A defined style that is the basis of the current style. Der Standardwert ist nullsein.The default value is null.

Beispiele

Es gibt mehrere Möglichkeiten, das im Stile WPFWPF erweitert oder geerbt werden kann.There are several ways that styles in WPFWPF can be extended or inherited. Stile können auf anderen Formaten über diese Eigenschaft basieren.Styles can be based on other styles through this property. Wenn Sie diese Eigenschaft verwenden, erben die neue Formatvorlage die Werte der ursprünglichen Formatvorlage, die nicht explizit in das neue Format neu definiert werden.When you use this property, the new style will inherit the values of the original style that are not explicitly redefined in the new style. Im folgenden Beispiel Style2 erbt die Control.Background Wert Yellow, und fügt eine Control.Foreground Wert Blue.In the following example, Style2 inherits the Control.Background value of Yellow, and adds a Control.Foreground value of 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>

Auf ähnliche Weise Stile können basierend auf den Stil eines vorhandenen WPFWPF Element, wie im folgenden Beispiel, in die neue Formatvorlage auf den Stil der basiert, eine TextBlock Element.Similarly, styles can be based on the style of an existing WPFWPF element, as in the following example where the new style is based on the style of a TextBlock element.

  <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>

Hinweis

Bei der Erstellung eines Stils mit einem TargetType -Eigenschaft und als Grundlage einen anderen Stil, die definiert, die auch eine TargetType -Eigenschaft der Zieltyp des abgeleiteten Stils müssen identisch sein oder vom Typ für den grundlegenden Stil abgeleitet werden.If you create a style with a TargetType property and base it on another style that also defines a TargetType property, the target type of the derived style must be the same as or be derived from the type of the base style.

Für bestimmte Typen definierte Formatvorlagen können auch auf anderen Formaten, wie im folgenden Beispiel basieren.Styles defined for specific types can also be based on other styles, as in the following example.

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

Hinweise

Jeder Stil unterstützt nur einen BasedOn Wert.Each style only supports one BasedOn value.

Verwendung von XAML-AttributenXAML Attribute Usage

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

XAML-WerteXAML Values

myStylemyStyle
Einen vorhandenen Stil.An existing style. Normalerweise verwenden Sie die Markuperweiterungen und WPF XAML zum Verweisen auf einen vorhandenen Stil.Typically, you use the Markup Extensions and WPF XAML to refer to an existing style.

Gilt für:

Siehe auch