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 Используя свойство , значение метода задания привязывается к содержимому ошибки текущего 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>

В следующем примере показано Style определение пользовательского элемента управления с именем NumericUpDown. Свойство TextTextBlock объекта привязывается к объекту Value , который является TemplatedParentэлементом NumericUpDown управления, Style к которому применяется в данном случае.

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

Ниже возвращается вторая 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)

Комментарии

Один из способов указать источник привязки Binding.RelativeSource — использовать свойство . Это тип свойства этого свойства. RelativeSource одновременно является реализацией расширения разметки и объектом данных. Когда расширение возвращает себя (см. ProvideValue), соответствующие сведения содержатся в данных. Основная цель расширения разметки заключается в том, чтобы разрешить синтаксис конструктора переменных аргументов в форме атрибута, чтобы FindAncestor режим можно было определить в соответствии с двумя дополнительными аргументами для типа предка и уровня, которые не требуются другим режимам.

Сведения о XAML см. в разделе RelativeSource MarkupExtension.

Конструкторы

Свойства

Методы

Явные реализации интерфейса

Применяется к

См. также раздел

• RelativeSource