정보
요청한 주제가 아래에 표시됩니다. 그러나 이 주제는 이 라이브러리에 포함되지 않습니다.

연결된 Storyboard.TargetProperty 속성

2013-12-13

애니메이션을 적용할 속성의 이름을 가져오거나 설정합니다.

Namespace:  System.Windows.Media.Animation
어셈블리:  System.Windows(System.Windows.dll)
XMLNS for XAML: xmlns에 매핑되지 않습니다.

See GetTargetProperty, SetTargetProperty
<object Storyboard.TargetProperty="simplePropertyName"/>
- or -
<object Storyboard.TargetProperty="propertyPath"/>

XAML 값

simplePropertyName

애니메이션을 적용할 종속성 속성의 이름입니다.

propertyPath

속성 경로가 복잡한 경우 간접 애니메이션을 통해 대상 지정된 속성이나 연결된 속성에 애니메이션을 적용할 수 있습니다.

속성 값

형식: System.Windows.PropertyPath
애니메이션을 적용할 속성입니다.

종속성 속성 식별자 필드: TargetPropertyProperty

이 속성은 Storyboard가 아닌 개체에서도 설정할 수 있는 Storyboard 전용 연결 속성의 예입니다.

Storyboard.TargetProperty의 값은 Storyboard.TargetName에서 참조하는 요소의 기존 속성을 참조해야 합니다. 자세한 내용은 Windows Phone의 애니메이션, 동작 및 출력의 "Storyboard 만들기" 섹션을 참조하세요.

Storyboard.TargetProperty는 간접 속성 대상 지정을 지원하며, 속성 경로 구문을 사용하여 간접 대상을 지정합니다. 간접 속성 대상 지정은 애니메이션이 적용되는 속성 자체의 형식이 개체이지만 실제로 애니메이션이 적용되는 값이 개체 형식 자체가 아니라 해당 개체의 속성인 경우에 필요합니다. 특히 이 방법은 개체가 최초에 XAML 개체 요소가 아닌 XAML 특성 형식으로 지정되어 태그에서 하위 개체를 대상으로 지정할 이름을 제공할 수 없는 경우에 필요합니다. 예를 들어, SolidColorBrush의 선형 보간을 사용하여 RectangleFill에 애니메이션을 적용하려면 ColorAnimation을 지정하고 여기에 "(Rectangle.Fill).Color"의 Storyboard.TargetProperty 값을 지정합니다.

런타임에 컬렉션에 추가되는 개체에 애니메이션을 적용할 때도 속성 경로를 사용할 수 있습니다. 이러한 경우 해당 컬렉션을 보유하는 개체에 이름을 지정한 다음 속성 경로 구문을 사용하여 특정 인덱스를 탐색해야 합니다. 이렇게 하면 자체에는 이름이 없지만 명명된 개체의 하위 속성으로 존재하는 개체를 애니메이션의 대상으로 지정할 수 있습니다.

실행 중인 애니메이션에 Storyboard.TargetProperty를 설정하려고 하면 런타임 오류가 발생합니다. 그러나 아직 실행되고 있지 않거나 중지된 기존 애니메이션에 다시 대상을 지정할 수 있습니다. 애니메이션의 대상을 다시 지정하는 경우 일반적으로 형식이 동일하거나 기본 개체 정의에 의해 속성을 공유하는 대상을 사용합니다. Storyboard.TargetName을 변경하여 애니메이션의 대상을 다시 지정하는 경우 Storyboard.TargetProperty가 지원되지 않는 속성을 참조하면 런타임 오류가 발생합니다.

대상으로 지정하는 속성에서는 적용되는 애니메이션 유형을 사용해야 합니다. 예를 들어, EllipseGeometry의 속성에 애니메이션을 적용하는 경우 DoubleAnimation 또는 DoubleAnimationUsingKeyFrames를 사용하여 RadiusX 또는 RadiusY에 애니메이션을 적용하고, PointAnimation 또는 PointAnimationUsingKeyFrames를 사용하여 Center에 애니메이션을 적용합니다. 형식이 일치하지 않으면 파서 오류가 발생합니다. 형식이 정확히 일치해야 하며 애니메이션 속성에 대한 형식은 암시적으로 변환되지 않습니다. 예를 들어, Canvas.ZIndex는 double이 아닌 정수를 사용하므로 DoubleAnimation을 사용하여 "(Canvas.ZIndex)" 대상에 애니메이션을 적용할 수는 없습니다.

컬렉션을 사용하는 propertyName 구문에서 컬렉션은 속성 체인의 마지막 항목일 수 없습니다. 그 이유는 Double, ColorPoint 애니메이션 형식을 통해서는 컬렉션에 포함된 개체 형식에 직접 애니메이션을 적용할 수 없기 때문입니다. 속성 체인은 컬렉션의 인덱스에서 가져온 개체의 속성으로 끝나야 합니다.

Windows Phone OS

지원되는 버전: 8.0, 7.1, 7.0

Windows Phone

표시: