# TransitionPropagation

added in[version 26.1.0](https://developer.android.com/topic/libraries/support-library/revisions)  
belongs to Maven artifact com.android.support:transition:28.0.0-alpha1  
Summary:[Ctors](https://developer.android.com/reference/android/support/transition/TransitionPropagation#pubctors)\|[Methods](https://developer.android.com/reference/android/support/transition/TransitionPropagation#pubmethods)\|[Inherited Methods](https://developer.android.com/reference/android/support/transition/TransitionPropagation#inhmethods)\|[\[Expand All\]](https://developer.android.com/reference/android/support/transition/TransitionPropagation#)  

# TransitionPropagation

| This package is part of the Android[support library](https://developer.android.com/topic/libraries/support-library)which is no longer maintained. The support library has been superseded by[AndroidX](https://developer.android.com/jetpack/androidx)which is part of[Jetpack](https://developer.android.com/jetpack). We recommend using the AndroidX libraries in all new projects. You should also consider[migrating](https://developer.android.com/jetpack/androidx/migrate)existing projects to AndroidX. To find the AndroidX class that maps to this deprecated class, see the AndroidX support library[class mappings](https://developer.android.com/jetpack/androidx/migrate/class-mappings).

`
public


abstract
class
TransitionPropagation
`  
`

extends Object


``


`

|---|--------------------------------------------------|
| java.lang.Object                                    ||
| ↳ | android.support.transition.TransitionPropagation |

|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [![](https://developer.android.com/static/assets/images/styles/disclosure_down.png)](https://developer.android.com/reference/android/support/transition/TransitionPropagation#)Known Direct Subclasses [VisibilityPropagation](https://developer.android.com/reference/android/support/transition/VisibilityPropagation) |-------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------| | [VisibilityPropagation](https://developer.android.com/reference/android/support/transition/VisibilityPropagation) | Base class for`TransitionPropagation`s that care about View Visibility and the center position of the View. | |

|---|---|
| [![](https://developer.android.com/static/assets/images/styles/disclosure_down.png)](https://developer.android.com/reference/android/support/transition/TransitionPropagation#)Known Indirect Subclasses [CircularPropagation](https://developer.android.com/reference/android/support/transition/CircularPropagation),[SidePropagation](https://developer.android.com/reference/android/support/transition/SidePropagation) |---------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------| | [CircularPropagation](https://developer.android.com/reference/android/support/transition/CircularPropagation) | A propagation that varies with the distance to the epicenter of the Transition or center of the scene if no epicenter exists. | | [SidePropagation](https://developer.android.com/reference/android/support/transition/SidePropagation)         | A`TransitionPropagation`that propagates based on the distance to the side and, orthogonally, the distance to epicenter.       | ||

<br />

*** ** * ** ***

Extend`TransitionPropagation`to customize start delays for Animators created in[createAnimator(ViewGroup, TransitionValues, TransitionValues)](https://developer.android.com/reference/android/support/transition/Transition#createAnimator(android.view.ViewGroup, android.support.transition.TransitionValues, android.support.transition.TransitionValues)). A Transition such as[Explode](https://developer.android.com/reference/android/support/transition/Explode)defaults to using[CircularPropagation](https://developer.android.com/reference/android/support/transition/CircularPropagation)and Views closer to the epicenter will move out of the scene later and into the scene sooner than Views farther from the epicenter, giving the appearance of inertia. With no TransitionPropagation, all Views will react simultaneously to the start of the transition.  
**See also:**

- [setPropagation(TransitionPropagation)](https://developer.android.com/reference/android/support/transition/Transition#setPropagation(android.support.transition.TransitionPropagation))
- [getEpicenter()](https://developer.android.com/reference/android/support/transition/Transition#getEpicenter())

## Summary

|                                                               ### Public constructors                                                                ||
|---------------------------------------------------------------------------------------------------------------------------------------------------|---|
| ` `[TransitionPropagation](https://developer.android.com/reference/android/support/transition/TransitionPropagation#TransitionPropagation())`() ` |

|                                                                                                                                                                                                                                                                                                                                                                                                    ### Public methods                                                                                                                                                                                                                                                                                                                                                                                                    ||
|----------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| ` abstract void`     | ` `[captureValues](https://developer.android.com/reference/android/support/transition/TransitionPropagation#captureValues(android.support.transition.TransitionValues))`(`[TransitionValues](https://developer.android.com/reference/android/support/transition/TransitionValues)` transitionValues) ` Captures the values in the start or end scene for the properties that this transition propagation monitors.                                                                                                                                                                                                                                                                                                                                                                                 |
| ` abstract String[]` | ` `[getPropagationProperties](https://developer.android.com/reference/android/support/transition/TransitionPropagation#getPropagationProperties())`() ` Returns the set of property names stored in the[TransitionValues](https://developer.android.com/reference/android/support/transition/TransitionValues)object passed into[captureValues(TransitionValues)](https://developer.android.com/reference/android/support/transition/TransitionPropagation#captureValues(android.support.transition.TransitionValues))that this transition propagation cares about for the purposes of preventing duplicate capturing of property values.                                                                                                                                                          |
| ` abstract long`     | ` `[getStartDelay](https://developer.android.com/reference/android/support/transition/TransitionPropagation#getStartDelay(android.view.ViewGroup, android.support.transition.Transition, android.support.transition.TransitionValues, android.support.transition.TransitionValues))`(`[ViewGroup](https://developer.android.com/reference/android/view/ViewGroup.html)` sceneRoot, `[Transition](https://developer.android.com/reference/android/support/transition/Transition)` transition, `[TransitionValues](https://developer.android.com/reference/android/support/transition/TransitionValues)` startValues, `[TransitionValues](https://developer.android.com/reference/android/support/transition/TransitionValues)` endValues) ` Called by Transition to alter the Animator start delay. |

| ### Inherited methods |
|-----------------------|---|
| [![](https://developer.android.com/static/assets/images/styles/disclosure_down.png)](https://developer.android.com/reference/android/support/transition/TransitionPropagation#)From class` java.lang.Object ` |-------------------|-------------------------------| | ` Object`         | ` clone() `                   | | ` boolean`        | ` equals(Object arg0) `       | | ` void`           | ` finalize() `                | | ` final Class<?>` | ` getClass() `                | | ` int`            | ` hashCode() `                | | ` final void`     | ` notify() `                  | | ` final void`     | ` notifyAll() `               | | ` String`         | ` toString() `                | | ` final void`     | ` wait(long arg0, int arg1) ` | | ` final void`     | ` wait(long arg0) `           | | ` final void`     | ` wait() `                    | ||

## Public constructors

### TransitionPropagation

added in[version 26.1.0](https://developer.android.com/topic/libraries/support-library/revisions)  

```
TransitionPropagation ()
```

<br />

<br />

## Public methods

### captureValues

added in[version 26.1.0](https://developer.android.com/topic/libraries/support-library/revisions)  

```
void captureValues (TransitionValues transitionValues)
```

Captures the values in the start or end scene for the properties that this transition propagation monitors. These values are then passed as the startValues or endValues structure in a later call to[getStartDelay(ViewGroup, Transition, TransitionValues, TransitionValues)](https://developer.android.com/reference/android/support/transition/TransitionPropagation#getStartDelay(android.view.ViewGroup, android.support.transition.Transition, android.support.transition.TransitionValues, android.support.transition.TransitionValues)). The main concern for an implementation is what the properties are that the transition cares about and what the values are for all of those properties. The start and end values will be compared later during the[getStartDelay(ViewGroup, Transition, TransitionValues, TransitionValues)](https://developer.android.com/reference/android/support/transition/TransitionPropagation#getStartDelay(android.view.ViewGroup, android.support.transition.Transition, android.support.transition.TransitionValues, android.support.transition.TransitionValues)). method to determine the start delay.

Subclasses must implement this method. The method should only be called by the transition system; it is not intended to be called from external classes.

<br />

<br />

|                                                                                                                                                                                                                                       Parameters                                                                                                                                                                                                                                        ||
|--------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `transitionValues` | `TransitionValues`: The holder for any values that the Transition wishes to store. Values are stored in the`values`field of this TransitionValues object and are keyed from a String value. For example, to store a view's rotation value, a transition might call`transitionValues.values.put("appname:transitionname:rotation", view.getRotation())`. The target view will already be stored in the transitionValues structure when this method is called. <br /> |

### getPropagationProperties

added in[version 26.1.0](https://developer.android.com/topic/libraries/support-library/revisions)  

```
String[] getPropagationProperties ()
```

Returns the set of property names stored in the[TransitionValues](https://developer.android.com/reference/android/support/transition/TransitionValues)object passed into[captureValues(TransitionValues)](https://developer.android.com/reference/android/support/transition/TransitionPropagation#captureValues(android.support.transition.TransitionValues))that this transition propagation cares about for the purposes of preventing duplicate capturing of property values.

A`TransitionPropagation`must override this method to prevent duplicate capturing of values and must contain at least one

<br />

<br />

|                                                                                              Returns                                                                                              ||
|------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `String[]` | An array of property names as described in the class documentation for[TransitionValues](https://developer.android.com/reference/android/support/transition/TransitionValues). <br /> |

### getStartDelay

added in[version 26.1.0](https://developer.android.com/topic/libraries/support-library/revisions)  

```
long getStartDelay (ViewGroup sceneRoot, 
                Transition transition, 
                TransitionValues startValues, 
                TransitionValues endValues)
```

Called by Transition to alter the Animator start delay. All start delays will be adjusted such that the minimum becomes zero.

<br />

|                                           Parameters                                           ||
|---------------|---------------------------------------------------------------------------------|
| `sceneRoot`   | `ViewGroup`: The root of the View hierarchy running the transition. <br />      |
| `transition`  | `Transition`: The transition that created the Animator <br />                   |
| `startValues` | `TransitionValues`: The values for a specific target in the start scene. <br /> |
| `endValues`   | `TransitionValues`: The values for the target in the end scene. <br />          |

|                                                                                                                         Returns                                                                                                                          ||
|--------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `long` | A start delay to use with the Animator created by`transition`. The delay will be offset by the minimum delay of all`TransitionPropagation`s used in the Transition so that the smallest delay will be 0. Returned values may be negative. <br /> |

-

  ## Interfaces

  - [Transition.TransitionListener](https://developer.android.com/reference/android/support/transition/Transition.TransitionListener)
-

  ## Classes

  - [ArcMotion](https://developer.android.com/reference/android/support/transition/ArcMotion)
  - [AutoTransition](https://developer.android.com/reference/android/support/transition/AutoTransition)
  - [ChangeBounds](https://developer.android.com/reference/android/support/transition/ChangeBounds)
  - [ChangeClipBounds](https://developer.android.com/reference/android/support/transition/ChangeClipBounds)
  - [ChangeImageTransform](https://developer.android.com/reference/android/support/transition/ChangeImageTransform)
  - [ChangeScroll](https://developer.android.com/reference/android/support/transition/ChangeScroll)
  - [ChangeTransform](https://developer.android.com/reference/android/support/transition/ChangeTransform)
  - [CircularPropagation](https://developer.android.com/reference/android/support/transition/CircularPropagation)
  - [Explode](https://developer.android.com/reference/android/support/transition/Explode)
  - [Fade](https://developer.android.com/reference/android/support/transition/Fade)
  - [PathMotion](https://developer.android.com/reference/android/support/transition/PathMotion)
  - [PatternPathMotion](https://developer.android.com/reference/android/support/transition/PatternPathMotion)
  - [R](https://developer.android.com/reference/android/support/transition/R)
  - [R.attr](https://developer.android.com/reference/android/support/transition/R.attr)
  - [R.bool](https://developer.android.com/reference/android/support/transition/R.bool)
  - [R.color](https://developer.android.com/reference/android/support/transition/R.color)
  - [R.dimen](https://developer.android.com/reference/android/support/transition/R.dimen)
  - [R.drawable](https://developer.android.com/reference/android/support/transition/R.drawable)
  - [R.id](https://developer.android.com/reference/android/support/transition/R.id)
  - [R.integer](https://developer.android.com/reference/android/support/transition/R.integer)
  - [R.layout](https://developer.android.com/reference/android/support/transition/R.layout)
  - [R.string](https://developer.android.com/reference/android/support/transition/R.string)
  - [R.style](https://developer.android.com/reference/android/support/transition/R.style)
  - [R.styleable](https://developer.android.com/reference/android/support/transition/R.styleable)
  - [Scene](https://developer.android.com/reference/android/support/transition/Scene)
  - [SidePropagation](https://developer.android.com/reference/android/support/transition/SidePropagation)
  - [Slide](https://developer.android.com/reference/android/support/transition/Slide)
  - [Transition](https://developer.android.com/reference/android/support/transition/Transition)
  - [Transition.EpicenterCallback](https://developer.android.com/reference/android/support/transition/Transition.EpicenterCallback)
  - [TransitionInflater](https://developer.android.com/reference/android/support/transition/TransitionInflater)
  - [TransitionListenerAdapter](https://developer.android.com/reference/android/support/transition/TransitionListenerAdapter)
  - [TransitionManager](https://developer.android.com/reference/android/support/transition/TransitionManager)
  - [TransitionPropagation](https://developer.android.com/reference/android/support/transition/TransitionPropagation)
  - [TransitionSet](https://developer.android.com/reference/android/support/transition/TransitionSet)
  - [TransitionValues](https://developer.android.com/reference/android/support/transition/TransitionValues)
  - [Visibility](https://developer.android.com/reference/android/support/transition/Visibility)
  - [VisibilityPropagation](https://developer.android.com/reference/android/support/transition/VisibilityPropagation)