TestScreenManager
public
class
TestScreenManager
extends ScreenManager
| java.lang.Object | ||
| ↳ | androidx.car.app.ScreenManager | |
| ↳ | androidx.car.app.testing.TestScreenManager | |
The ScreenManager that is used for testing.
This class will track the following usages of the ScreenManager throughout your test:
- All the
Screens pushed viaScreenManager.push(Screen), orScreenManager.pushForResult(Screen, OnScreenResultListener). - All the
Screens removed via,ScreenManager.pop(),ScreenManager.popTo(String), orScreenManager.remove(Screen).
Summary
Public methods | |
|---|---|
List<Screen>
|
getScreensPushed()
Returns all the |
List<Screen>
|
getScreensRemoved()
Returns all the |
boolean
|
hasScreens()
Returns |
void
|
pop()
Pops the top |
void
|
popTo(String marker)
Removes screens from the top of the stack until a |
void
|
popToRoot()
Removes all screens from the stack until the root has been reached. |
void
|
push(Screen screen)
Pushes the |
void
|
pushForResult(Screen screen, OnScreenResultListener onScreenResultListener)
Pushes a |
void
|
remove(Screen screen)
Removes the |
void
|
reset()
Resets the values tracked by this |
Inherited methods | |
|---|---|
Public methods
getScreensPushed
public List<Screen> getScreensPushed ()
Returns all the Screens pushed via ScreenManager.push(Screen), and ScreenManager.pushForResult(Screen, OnScreenResultListener).
The screens are stored in the order in which they were pushed, where the first screen in the list is the first screen that was pushed.
The screens will be stored until reset() is called.
| Returns | |
|---|---|
List<Screen> |
|
getScreensRemoved
public List<Screen> getScreensRemoved ()
Returns all the Screens removed via ScreenManager.pop(), ScreenManager.popTo(String), and ScreenManager.remove(Screen).
The screens are stored in the order in which they were removed, where the first screen in the list, is the first screen that was removed.
The screens will be stored until reset() is called.
| Returns | |
|---|---|
List<Screen> |
|
hasScreens
public boolean hasScreens ()
Returns true if the Screen stack has any screens in it.
| Returns | |
|---|---|
boolean |
|
pop
public void pop ()
Pops the top Screen from the stack.
If the top Screen is the only Screen in the stack, it will not be removed.
popTo
public void popTo (String marker)
Removes screens from the top of the stack until a Screen which has the given marker is found, or the root has been reached.
The root Screen will not be popped.
| Parameters | |
|---|---|
marker |
String |
popToRoot
public void popToRoot ()
Removes all screens from the stack until the root has been reached.
push
public void push (Screen screen)
Pushes the screen to the stack.
If the screen pushed is already in the stack it will be moved to the top of the
stack.
| Parameters | |
|---|---|
screen |
Screen |
pushForResult
public void pushForResult (Screen screen, OnScreenResultListener onScreenResultListener)
Pushes a Screen, for which you would like a result from, onto the stack.
When the given screen finishes, the onScreenResultCallback will receive a
callback to OnScreenResultListener.onScreenResult(Object) with the result that the pushed
screen set via Screen.setResult(Object).
| Parameters | |
|---|---|
screen |
Screen: the Screen to push on top of the stack |
onScreenResultListener |
OnScreenResultListener: the listener that will be executed with the result pushed by
the screen through Screen.setResult(Object). This
callback will be executed on the main thread |
remove
public void remove (Screen screen)
Removes the screen from the stack.
If the screen is the only Screen in the stack, it will not be removed.
| Parameters | |
|---|---|
screen |
Screen |
reset
public void reset ()
Resets the values tracked by this TestScreenManager and the Screen stack.