RelativeSource Klasse

Definition

public ref class RelativeSource : System::Windows::Markup::MarkupExtension, System::ComponentModel::ISupportInitialize

[System.Windows.Markup.MarkupExtensionReturnType(typeof(System.Windows.Data.RelativeSource))]
public class RelativeSource : System.Windows.Markup.MarkupExtension, System.ComponentModel.ISupportInitialize

[<System.Windows.Markup.MarkupExtensionReturnType(typeof(System.Windows.Data.RelativeSource))>]
type RelativeSource = class
    inherit MarkupExtension
    interface ISupportInitialize

Public Class RelativeSource
Inherits MarkupExtension
Implements ISupportInitialize

Vererbung

Object

MarkupExtension

RelativeSource

Attribute

MarkupExtensionReturnTypeAttribute

Implementiert

ISupportInitialize

Beispiele

Im folgenden Beispiel wird ein Formatauslöser gezeigt, der eine Überprüfungsfehlermeldung erstellt ToolTip . RelativeSource Mithilfe der Eigenschaft bindet der Wert des Setter an den Fehlerinhalt des Aktuellen TextBox (mit TextBox der Formatvorlage). Weitere Informationen zu diesem Beispiel finden Sie unter How to: Implementieren der Bindungsüberprüfung.

<Style x:Key="textBoxInError" TargetType="{x:Type TextBox}">
  <Style.Triggers>
    <Trigger Property="Validation.HasError" Value="true">
      <Setter Property="ToolTip"
        Value="{Binding RelativeSource={x:Static RelativeSource.Self},
                        Path=(Validation.Errors)/ErrorContent}"/>
    </Trigger>
  </Style.Triggers>
</Style>

Das folgende Beispiel zeigt die Style Definition eines benutzerdefinierten Steuerelements namens NumericUpDown. Die Text Eigenschaft des TextBlock Objekts ist Value an das Objekt gebunden, TemplatedParentdas das ist, was das NumericUpDown Steuerelement ist, auf das dies Style in diesem Fall angewendet wird.

<!--ControlTemplate for NumericUpDown that inherits from
    Control.-->
<Style TargetType="{x:Type local:NumericUpDown}">
  <Setter Property="HorizontalAlignment" Value="Center"/>
  <Setter Property="VerticalAlignment" Value="Center"/>
  <Setter Property="Template">
    <Setter.Value>
      <ControlTemplate TargetType="{x:Type local:NumericUpDown}">
        <Grid Margin="3">
          <Grid.RowDefinitions>
            <RowDefinition/>
            <RowDefinition/>
          </Grid.RowDefinitions>
          <Grid.ColumnDefinitions>
            <ColumnDefinition/>
            <ColumnDefinition/>
          </Grid.ColumnDefinitions>

          <Border BorderThickness="1" BorderBrush="Gray" 
                  Margin="2" Grid.RowSpan="2" 
                  VerticalAlignment="Center" HorizontalAlignment="Stretch">
                  
            <TextBlock Text="{Binding RelativeSource={RelativeSource TemplatedParent}, Path=Value}" 
                       Width="60" TextAlignment="Right" Padding="5"/>
          </Border>
          
          <RepeatButton Command="{x:Static local:NumericUpDown.IncreaseCommand}"  
                        Grid.Column="1" Grid.Row="0">Up</RepeatButton>
                        
          <RepeatButton Command="{x:Static local:NumericUpDown.DecreaseCommand}"
                        Grid.Column="1" Grid.Row="1">Down</RepeatButton>

        </Grid>

      </ControlTemplate>
    </Setter.Value>
  </Setter>
</Style>

Im Folgenden wird der zweite ItemsControl Aufwärtspfad zurückgegeben, der am Zielelement der Bindung beginnt.

Binding myBinding = new Binding();
// Returns the second ItemsControl encountered on the upward path
// starting at the target element of the binding
myBinding.RelativeSource = new RelativeSource(
    RelativeSourceMode.FindAncestor, typeof(ItemsControl), 2);

Dim myBinding As New Binding()
' Returns the second ItemsControl encountered on the upward path
' starting at the target element of the binding
myBinding.RelativeSource = New RelativeSource(RelativeSourceMode.FindAncestor, GetType(ItemsControl), 2)

Hinweise

Eine der Möglichkeiten zum Angeben einer Bindungsquelle besteht darin, die Binding.RelativeSource Eigenschaft zu verwenden. Dies ist der Eigenschaftstyp dieser Eigenschaft. RelativeSource ist gleichzeitig eine Markuperweiterungsimplementierung und ein Datenobjekt. Wenn die Erweiterung selbst zurückgibt (siehe ProvideValue), werden die relevanten Informationen in den Daten enthalten. Der Hauptzweck der Markuperweiterung besteht darin, eine Syntax des Variablenargumentkonstruktors in Attributformular zuzulassen, sodass der FindAncestor Modus inline mit den beiden zusätzlichen Argumenten für den Vorgängertyp und die Ebene definiert werden kann, die die anderen Modi nicht benötigen.

Informationen zu XAML finden Sie unter RelativeSource MarkupExtension.

Konstruktoren

Eigenschaften

Methoden

Explizite Schnittstellenimplementierungen

Gilt für

Siehe auch

• RelativeSource