This topic has not yet been rated - Rate this topic

RelativeSource Constructor (RelativeSourceMode, Type, Int32)

.NET Framework 4.5

Initializes a new instance of the RelativeSource class with an initial mode and additional tree-walking qualifiers for finding the desired relative source.

Namespace: System.Windows.Data
Assembly: PresentationFramework (in PresentationFramework.dll)

Syntax

C++

public RelativeSource(
	RelativeSourceMode mode,
	Type ancestorType,
	int ancestorLevel
)

Parameters

mode: Type: System.Windows.Data.RelativeSourceMode
One of the RelativeSourceMode values. For this signature to be relevant, this should be FindAncestor.

ancestorType: Type: System.Type
The Type of ancestor to look for.

ancestorLevel: Type: System.Int32
The ordinal position of the desired ancestor among all ancestors of the given type.

Remarks

ancestorType and ancestorLevel have no relevance if given as parameters for a mode other than FindAncestor. Do not use this signature for the other RelativeSourceMode values.

Examples

The following returns the second ItemsControl encountered on the upward path starting at the target element of the binding.

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

Version Information

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Platforms

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Reference

RelativeSource Class

RelativeSource Overload

System.Windows.Data Namespace

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)