RelativeSource クラス

定義

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

継承

Object

MarkupExtension

RelativeSource

属性

MarkupExtensionReturnTypeAttribute

実装

ISupportInitialize

例

次の例は、検証エラー メッセージを報告する ToolTip スタイル トリガーを示しています。 このプロパティを RelativeSource 使用すると、setter の値は現在 TextBox のエラー コンテンツ ( TextBox スタイルの使用) にバインドされます。 この例の詳細については、「 方法: バインド検証を実装する」を参照してください。

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

次の例は、カスタム NumericUpDownコントロールのStyle定義を示しています。 のプロパティはText、この場合にValue適用されるコントロールStyleであるオブジェクトTemplatedParent``NumericUpDownのプロパティにバインドされます。TextBlock

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

次は、バインディングのターゲット要素から始まる上向きのパスで検出された 2 番目 ItemsControl の値を返します。

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)

注釈

バインディング ソースを指定する方法の 1 つは、プロパティを Binding.RelativeSource 使用することです。 これは、そのプロパティのプロパティ型です。 RelativeSource は、同時にマークアップ拡張機能の実装とデータ オブジェクトです。 拡張機能がそれ自体を返すと (参照 ProvideValue)、関連する情報がデータに含まれます。 マークアップ拡張の主な目的は、属性形式で可変引数コンストラクター構文を許可し、他の FindAncestor モードで必要のない先祖型とレベルの 2 つの追加引数を使用してインラインでモードを定義できるようにすることです。

XAML の詳細については、「 RelativeSource MarkupExtension」を参照してください。

コンストラクター

プロパティ

メソッド

明示的なインターフェイスの実装

適用対象

こちらもご覧ください

• RelativeSource