ControlTemplate.TargetType Eigenschaft

Referenz

Definition

Namespace:: System.Windows.Controls

Assembly:: PresentationFramework.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Dient zum Abrufen oder Festlegen des Typs, für den diese ControlTemplate vorgesehen ist.

public:
 property Type ^ TargetType { Type ^ get(); void set(Type ^ value); };

[System.Windows.Markup.Ambient]
public Type TargetType { get; set; }

[<System.Windows.Markup.Ambient>]
member this.TargetType : Type with get, set

Public Property TargetType As Type

Eigenschaftswert

Type

Standardwert: null.

Attribute: AmbientAttribute

Ausnahmen

ArgumentNullException

Die TargetType-Eigenschaft darf nicht null sein, wenn die Definition der Vorlage über einen ContentPresenter verfügt.

ArgumentException

Die angegebenen Typen sind nicht gültig. Der TargetType eines ControlTemplate muss ein Control, eine Page oder ein PageFunctionBase sein oder von diesen erben.

Beispiele

Im folgenden Beispiel wird die Verwendung dieser Eigenschaft veranschaulicht:

<Style x:Key="{x:Type Label}"
       TargetType="Label">
  <Setter Property="HorizontalContentAlignment"
          Value="Left" />
  <Setter Property="VerticalContentAlignment"
          Value="Top" />
  <Setter Property="Template">
    <Setter.Value>
      <ControlTemplate TargetType="Label">
        <Border>
          <ContentPresenter HorizontalAlignment="{TemplateBinding HorizontalContentAlignment}"
                            VerticalAlignment="{TemplateBinding VerticalContentAlignment}"
                            RecognizesAccessKey="True" />
        </Border>
        <ControlTemplate.Triggers>
          <Trigger Property="IsEnabled"
                   Value="false">
            <Setter Property="Foreground">
              <Setter.Value>
                <SolidColorBrush Color="{DynamicResource DisabledForegroundColor}" />
              </Setter.Value>
            </Setter>
          </Trigger>
        </ControlTemplate.Triggers>
      </ControlTemplate>
    </Setter.Value>
  </Setter>
</Style>

Im obigen Beispiel wird die folgende Ressource verwendet:

Das vollständige Beispiel finden Sie unter Beispiel zum Formatieren mit ControlTemplates.

Hinweise

Wenn Sie im Ressourcenabschnitt eine eigenständige ControlTemplate Instanz haben, deren TargetType Eigenschaft auf einen Typ festgelegt ist, wird der ControlTemplate nicht automatisch auf diesen Typ angewendet. Stattdessen müssen Sie eine x:Key angeben und die Vorlage explizit anwenden.

Beachten Sie auch, dass die TargetType -Eigenschaft für ein ControlTemplate erforderlich ist, wenn die Vorlagendefinition einen ContentPresenterenthält.

Verwendung von XAML-Attributen

<object  TargetType="typeName"/>

XAML-Werte

typeName
Der Typname der Klasse. Um auf den Type Namen der -Klasse zu verweisen, verwenden Sie die Markuperweiterungen und WPF-XAML.

Gilt für: