# VisibilityPropagation

Added in[API level 21](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  
Summary:[Ctors](https://developer.android.com/reference/android/transition/VisibilityPropagation#pubctors)\|[Methods](https://developer.android.com/reference/android/transition/VisibilityPropagation#pubmethods)\|[Inherited Methods](https://developer.android.com/reference/android/transition/VisibilityPropagation#inhmethods)  

# VisibilityPropagation

*** ** * ** ***

[Kotlin](https://developer.android.com/reference/kotlin/android/transition/VisibilityPropagation "View this page in Kotlin")\|Java

`
public


abstract
class
VisibilityPropagation
`  
`


``

extends `[TransitionPropagation](https://developer.android.com/reference/android/transition/TransitionPropagation)`


``


`

|---|---|------------------------------------------|
| [java.lang.Object](https://developer.android.com/reference/java/lang/Object) |||
| ↳ | [android.transition.TransitionPropagation](https://developer.android.com/reference/android/transition/TransitionPropagation) ||
|   | ↳ | android.transition.VisibilityPropagation |

|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Known direct subclasses [CircularPropagation](https://developer.android.com/reference/android/transition/CircularPropagation),[SidePropagation](https://developer.android.com/reference/android/transition/SidePropagation) |-------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------| | [CircularPropagation](https://developer.android.com/reference/android/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/transition/SidePropagation)         | A`TransitionPropagation`that propagates based on the distance to the side and, orthogonally, the distance to epicenter.       | |

<br />

*** ** * ** ***

Base class for`TransitionPropagation`s that care about View Visibility and the center position of the View.

## Summary

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

|                                                                                                                                                                                                                                                                                                                                          ### Public methods                                                                                                                                                                                                                                                                                                                                           ||
|-------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| ` void`                                                                 | ` `[captureValues](https://developer.android.com/reference/android/transition/VisibilityPropagation#captureValues(android.transition.TransitionValues))`(`[TransitionValues](https://developer.android.com/reference/android/transition/TransitionValues)` values) ` Captures the values in the start or end scene for the properties that this transition propagation monitors.                                                                                                                                                                                                                                             |
| ` `[String[]](https://developer.android.com/reference/java/lang/String) | ` `[getPropagationProperties](https://developer.android.com/reference/android/transition/VisibilityPropagation#getPropagationProperties())`() ` Returns the set of property names stored in the[TransitionValues](https://developer.android.com/reference/android/transition/TransitionValues)object passed into[captureValues(android.transition.TransitionValues)](https://developer.android.com/reference/android/transition/TransitionPropagation#captureValues(android.transition.TransitionValues))that this transition propagation cares about for the purposes of preventing duplicate capturing of property values. |
| ` int`                                                                  | ` `[getViewVisibility](https://developer.android.com/reference/android/transition/VisibilityPropagation#getViewVisibility(android.transition.TransitionValues))`(`[TransitionValues](https://developer.android.com/reference/android/transition/TransitionValues)` values) ` Returns[View.getVisibility()](https://developer.android.com/reference/android/view/View#getVisibility())for the View at the time the values were captured.                                                                                                                                                                                      |
| ` int`                                                                  | ` `[getViewX](https://developer.android.com/reference/android/transition/VisibilityPropagation#getViewX(android.transition.TransitionValues))`(`[TransitionValues](https://developer.android.com/reference/android/transition/TransitionValues)` values) ` Returns the View's center x coordinate, relative to the screen, at the time the values were captured.                                                                                                                                                                                                                                                             |
| ` int`                                                                  | ` `[getViewY](https://developer.android.com/reference/android/transition/VisibilityPropagation#getViewY(android.transition.TransitionValues))`(`[TransitionValues](https://developer.android.com/reference/android/transition/TransitionValues)` values) ` Returns the View's center y coordinate, relative to the screen, at the time the values were captured.                                                                                                                                                                                                                                                             |

| ### Inherited methods |
|-----------------------|---|
| From class` `[android.transition.TransitionPropagation](https://developer.android.com/reference/android/transition/TransitionPropagation)` ` |----------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` abstract void`                                                                 | ` `[captureValues](https://developer.android.com/reference/android/transition/TransitionPropagation#captureValues(android.transition.TransitionValues))`(`[TransitionValues](https://developer.android.com/reference/android/transition/TransitionValues)` transitionValues) ` Captures the values in the start or end scene for the properties that this transition propagation monitors.                                                                                                                                                                                                                                                                                                                                                  | | ` abstract `[String[]](https://developer.android.com/reference/java/lang/String) | ` `[getPropagationProperties](https://developer.android.com/reference/android/transition/TransitionPropagation#getPropagationProperties())`() ` Returns the set of property names stored in the[TransitionValues](https://developer.android.com/reference/android/transition/TransitionValues)object passed into[captureValues(android.transition.TransitionValues)](https://developer.android.com/reference/android/transition/TransitionPropagation#captureValues(android.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/transition/TransitionPropagation#getStartDelay(android.view.ViewGroup,%20android.transition.Transition,%20android.transition.TransitionValues,%20android.transition.TransitionValues))`(`[ViewGroup](https://developer.android.com/reference/android/view/ViewGroup)` sceneRoot, `[Transition](https://developer.android.com/reference/android/transition/Transition)` transition, `[TransitionValues](https://developer.android.com/reference/android/transition/TransitionValues)` startValues, `[TransitionValues](https://developer.android.com/reference/android/transition/TransitionValues)` endValues) ` Called by Transition to alter the Animator start delay. | ||
| From class` `[java.lang.Object](https://developer.android.com/reference/java/lang/Object)` ` |--------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` `[Object](https://developer.android.com/reference/java/lang/Object)          | ` `[clone](https://developer.android.com/reference/java/lang/Object#clone())`() ` Creates and returns a copy of this object.                                                                                                                                                      | | ` boolean`                                                                     | ` `[equals](https://developer.android.com/reference/java/lang/Object#equals(java.lang.Object))`(`[Object](https://developer.android.com/reference/java/lang/Object)` obj) ` Indicates whether some other object is "equal to" this one.                                           | | ` void`                                                                        | ` `[finalize](https://developer.android.com/reference/java/lang/Object#finalize())`() ` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.                                                          | | ` final `[Class](https://developer.android.com/reference/java/lang/Class)`<?>` | ` `[getClass](https://developer.android.com/reference/java/lang/Object#getClass())`() ` Returns the runtime class of this`Object`.                                                                                                                                                | | ` int`                                                                         | ` `[hashCode](https://developer.android.com/reference/java/lang/Object#hashCode())`() ` Returns a hash code value for the object.                                                                                                                                                 | | ` final void`                                                                  | ` `[notify](https://developer.android.com/reference/java/lang/Object#notify())`() ` Wakes up a single thread that is waiting on this object's monitor.                                                                                                                            | | ` final void`                                                                  | ` `[notifyAll](https://developer.android.com/reference/java/lang/Object#notifyAll())`() ` Wakes up all threads that are waiting on this object's monitor.                                                                                                                         | | ` `[String](https://developer.android.com/reference/java/lang/String)          | ` `[toString](https://developer.android.com/reference/java/lang/Object#toString())`() ` Returns a string representation of the object.                                                                                                                                            | | ` final void`                                                                  | ` `[wait](https://developer.android.com/reference/java/lang/Object#wait(long,%20int))`(long timeoutMillis, int nanos) ` Causes the current thread to wait until it is awakened, typically by being*notified* or*interrupted*, or until a certain amount of real time has elapsed. | | ` final void`                                                                  | ` `[wait](https://developer.android.com/reference/java/lang/Object#wait(long))`(long timeoutMillis) ` Causes the current thread to wait until it is awakened, typically by being*notified* or*interrupted*, or until a certain amount of real time has elapsed.                   | | ` final void`                                                                  | ` `[wait](https://developer.android.com/reference/java/lang/Object#wait())`() ` Causes the current thread to wait until it is awakened, typically by being*notified* or*interrupted*.                                                                                             | ||

## Public constructors

### VisibilityPropagation

```
public VisibilityPropagation ()
```

<br />

<br />

## Public methods

### captureValues

Added in[API level 21](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public void captureValues (TransitionValues values)
```

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(android.view.ViewGroup, android.transition.Transition, android.transition.TransitionValues, android.transition.TransitionValues)](https://developer.android.com/reference/android/transition/TransitionPropagation#getStartDelay(android.view.ViewGroup,%20android.transition.Transition,%20android.transition.TransitionValues,%20android.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(android.view.ViewGroup, android.transition.Transition, android.transition.TransitionValues, android.transition.TransitionValues)](https://developer.android.com/reference/android/transition/TransitionPropagation#getStartDelay(android.view.ViewGroup,%20android.transition.Transition,%20android.transition.TransitionValues,%20android.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                                                                                                                                                                                                                                   ||
|----------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `values` | `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[API level 21](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

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

Returns the set of property names stored in the[TransitionValues](https://developer.android.com/reference/android/transition/TransitionValues)object passed into[captureValues(android.transition.TransitionValues)](https://developer.android.com/reference/android/transition/TransitionPropagation#captureValues(android.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[]](https://developer.android.com/reference/java/lang/String) | An array of property names as described in the class documentation for[TransitionValues](https://developer.android.com/reference/android/transition/TransitionValues). <br /> |

### getViewVisibility

Added in[API level 21](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public int getViewVisibility (TransitionValues values)
```

Returns[View.getVisibility()](https://developer.android.com/reference/android/view/View#getVisibility())for the View at the time the values were captured.

<br />

|                                                Parameters                                                 ||
|----------|-------------------------------------------------------------------------------------------------|
| `values` | `TransitionValues`: The TransitionValues captured at the start or end of the Transition. <br /> |

|                                                                              Returns                                                                              ||
|-------|------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `int` | [View.getVisibility()](https://developer.android.com/reference/android/view/View#getVisibility())for the View at the time the values were captured. <br /> |

### getViewX

Added in[API level 21](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public int getViewX (TransitionValues values)
```

Returns the View's center x coordinate, relative to the screen, at the time the values were captured.

<br />

|                                                Parameters                                                 ||
|----------|-------------------------------------------------------------------------------------------------|
| `values` | `TransitionValues`: The TransitionValues captured at the start or end of the Transition. <br /> |

|                                                   Returns                                                   ||
|-------|------------------------------------------------------------------------------------------------------|
| `int` | the View's center x coordinate, relative to the screen, at the time the values were captured. <br /> |

### getViewY

Added in[API level 21](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public int getViewY (TransitionValues values)
```

Returns the View's center y coordinate, relative to the screen, at the time the values were captured.

<br />

|                                                Parameters                                                 ||
|----------|-------------------------------------------------------------------------------------------------|
| `values` | `TransitionValues`: The TransitionValues captured at the start or end of the Transition. <br /> |

|                                                   Returns                                                   ||
|-------|------------------------------------------------------------------------------------------------------|
| `int` | the View's center y coordinate, relative to the screen, at the time the values were captured. <br /> |