diff --git a/docs/xml/Android.Window/InputTransferToken.xml b/docs/xml/Android.Window/InputTransferToken.xml
index 09d9e05c3..52062f205 100644
--- a/docs/xml/Android.Window/InputTransferToken.xml
+++ b/docs/xml/Android.Window/InputTransferToken.xml
@@ -123,8 +123,8 @@
- To be added.
- To be added.
+ Describes the special objects in this token's marshaled representation.
+ A bitmask of special object types in the marshaled representation.
@@ -267,9 +267,9 @@
- To be added.
- To be added.
- To be added.
+ The parcel that receives the token.
+ Additional flags describing how the token is written.
+ Flattens this token into a parcel.
diff --git a/docs/xml/Android.Window/SplashScreenStyle.xml b/docs/xml/Android.Window/SplashScreenStyle.xml
index 3949ce8d2..14d216881 100644
--- a/docs/xml/Android.Window/SplashScreenStyle.xml
+++ b/docs/xml/Android.Window/SplashScreenStyle.xml
@@ -11,8 +11,8 @@
System.Enum
- To be added.
- To be added.
+ Specifies the visual style of a launched activity's splash screen.
+ Use these values with the splash screen style APIs on ActivityOptions.
@@ -40,7 +40,7 @@
1
- To be added.
+ Shows the launched activity's splash screen icon.
@@ -68,7 +68,7 @@
0
- To be added.
+ Uses a solid-color splash screen without showing the launched activity's icon.
diff --git a/docs/xml/Android.Window/SplashScreenView.xml b/docs/xml/Android.Window/SplashScreenView.xml
index 4615b928f..149a53ee0 100644
--- a/docs/xml/Android.Window/SplashScreenView.xml
+++ b/docs/xml/Android.Window/SplashScreenView.xml
@@ -76,7 +76,7 @@
Returns the duration of the icon animation if icon is animatable.
- To be added.
+ The icon animation duration, or or a non-null zero duration when the icon is not animatable.
Returns the duration of the icon animation if icon is animatable.
@@ -122,7 +122,7 @@
If the replaced icon is animatable, return the animation start time based on system clock.
- To be added.
+ The icon animation start time, or when no animatable icon is available.
If the replaced icon is animatable, return the animation start time based on system clock.
@@ -163,7 +163,7 @@
Get the view containing the Splash Screen icon and its background.
- To be added.
+ The view containing the splash screen icon and its background, or when no icon view exists.
Get the view containing the Splash Screen icon and its background.
diff --git a/docs/xml/Android.Window/SurfaceSyncGroup.xml b/docs/xml/Android.Window/SurfaceSyncGroup.xml
index 3a164346c..59e0cddef 100644
--- a/docs/xml/Android.Window/SurfaceSyncGroup.xml
+++ b/docs/xml/Android.Window/SurfaceSyncGroup.xml
@@ -120,12 +120,9 @@
The AttachedSurfaceControl that will be add to this
SurfaceSyncGroup.
- This is run on the same thread that the call was made on, but
- after the rendering is paused and before continuing to render
- the next frame. This method will not return until the
- execution of the runnable completes. This can be used to make
- changes to the AttachedSurfaceControl, ensuring that the
- changes are included in the sync.
+ Runs synchronously on the calling thread after rendering is paused
+ and before the next frame is rendered. This method blocks until the runnable completes.
+ Use it to make changes to the AttachedSurfaceControl that are included in the sync.
Add an AttachedSurfaceControl to the SurfaceSyncGroup.
true if the AttachedSurfaceControl was successfully added to the SurfaceSyncGroup,
false otherwise.
@@ -181,11 +178,14 @@
- To be added.
- To be added.
- To be added.
- To be added.
- To be added.
+ The surface package to add to this synchronization group.
+ An optional operation that runs synchronously on the calling thread
+ after rendering is paused and before the next frame is rendered. This method blocks
+ until the operation completes, allowing its changes to the hosted surface to be
+ included in the sync.
+ Adds a surface package to this synchronization group.
+ if the surface package was added; otherwise, .
+ Rendering is paused while the optional operation executes so its changes can be included in the synchronized frame.
@@ -215,9 +215,14 @@
- To be added.
- To be added.
- To be added.
+ The transaction to synchronize with the group's other
+ transactions while the group is active. If the group has completed, the transaction
+ is applied immediately.
+ Adds a transaction to an active synchronization group; applies it immediately
+ when the group has completed.
+ The transaction is synchronized with the group's other transactions only while
+ the group is active. Once the group has completed, Android applies the transaction
+ immediately.
diff --git a/docs/xml/Android.Window/SystemOnBackInvokedCallbacks.xml b/docs/xml/Android.Window/SystemOnBackInvokedCallbacks.xml
index 1570752f1..56c6ae980 100644
--- a/docs/xml/Android.Window/SystemOnBackInvokedCallbacks.xml
+++ b/docs/xml/Android.Window/SystemOnBackInvokedCallbacks.xml
@@ -81,9 +81,10 @@
The associated Activity
- Get a callback to triggers Activity#finishAndRemoveTask() on the associated
- Activity.
- To be added.
+ Get a callback that finishes the associated Activity, removing its task from
+ Recents when the activity is the task root.
+ A callback that finishes the activity when back is invoked and removes its task from
+ Recents only when the activity is the task root.
Get a callback to triggers Activity#finishAndRemoveTask() on the associated
Activity. If the activity is the root activity of its task, the entire task
@@ -161,7 +162,7 @@
The associated Activity
Get a callback to triggers Activity#moveTaskToBack(boolean) on the associated
Activity, moving the task containing the activity to the background.
- To be added.
+ A callback that moves the activity's task to the background when back is invoked.
Get a callback to triggers Activity#moveTaskToBack(boolean) on the associated
Activity, moving the task containing the activity to the background. The system
diff --git a/docs/xml/Android.Window/TrustedPresentationThresholds.xml b/docs/xml/Android.Window/TrustedPresentationThresholds.xml
index 182afe94a..cce0e72fe 100644
--- a/docs/xml/Android.Window/TrustedPresentationThresholds.xml
+++ b/docs/xml/Android.Window/TrustedPresentationThresholds.xml
@@ -85,14 +85,14 @@
- The min alpha the Window is required to
- have to be considered inside the
- threshold.
- The min fraction of the Window that was presented
- to the user to be considered
- inside the threshold.
- The time in milliseconds required for the
- Window to be in the threshold.
+ The minimum alpha the Window must have to be considered inside the
+ threshold. Must be greater than 0.0 and no greater than 1.0.
+ The minimum fraction of the Window presented to the
+ user to be considered inside the threshold. Must be greater than 0.0 and no greater
+ than 1.0.
+ The time in milliseconds required for the Window to
+ be in the threshold. Must be at least 1 millisecond; zero or negative values cause
+ this constructor to throw IllegalArgumentException.
Creates a new TrustedPresentationThresholds.
Creates a new TrustedPresentationThresholds.
@@ -166,9 +166,9 @@
- To be added.
- To be added.
- To be added.
+ Describes the special objects in this threshold object's marshaled representation.
+ A bitmask of special object types in the marshaled representation.
+ The bitmask indicates whether the parcel representation contains special objects such as file descriptors.
@@ -229,7 +229,7 @@
The min alpha the Window is required to have to be considered inside the
threshold.
- To be added.
+ A value greater than 0.0 and no greater than 1.0.
The min alpha the Window is required to have to be considered inside the
threshold.
@@ -272,7 +272,7 @@
The min fraction of the Window that was presented to the user to be considered
inside the threshold.
- To be added.
+ A value greater than 0.0 and no greater than 1.0.
The min fraction of the Window that was presented to the user to be considered
inside the threshold.
@@ -314,7 +314,7 @@
The time in milliseconds required for the Window to be in the threshold.
- To be added.
+ A value of at least 1 millisecond.
The time in milliseconds required for the Window to be in the threshold.
@@ -426,10 +426,10 @@
- To be added.
- To be added.
- To be added.
- To be added.
+ The parcel that receives the threshold values.
+ Additional flags describing how the threshold values are written.
+ Flattens these threshold values into a parcel.
+ The parcel representation can be used to transfer threshold values across process boundaries.
diff --git a/docs/xml/ns-Android.Window.xml b/docs/xml/ns-Android.Window.xml
index f85a67c54..a8cacc332 100644
--- a/docs/xml/ns-Android.Window.xml
+++ b/docs/xml/ns-Android.Window.xml
@@ -1,6 +1,6 @@
- To be added.
- To be added.
+ Provides APIs for predictive back navigation, splash screens, surface synchronization, input transfer, and trusted presentation thresholds.
+ These APIs support Android window behavior that is coordinated with the system.