Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 05d8fbe4 authored Mar 12, 2025 by Harry Cutts

WindowManager: add JavaDoc to setTitle methods

This adds a bit of detail about what each is used for, and the
differences between them.

Bug: 245989146
Test: none
Flag: DOCS_ONLY
Change-Id: I037911300ba6ac73439b3d604cb37d0968fbf750

parent 73821a2c

core/java/android/view/Window.java

+10 −0

Original line number	Diff line number	Diff line
		@@ -1840,6 +1840,16 @@ public abstract class Window {
		@NonNull
		public abstract LayoutInflater getLayoutInflater();

		/**
		* Sets a user-facing title for the window.
		* <p>
		* This title may be shown to the user in the window's title or action bar
		* if the {@link #requestFeature requested features} provide such a bar.
		* It is also exposed through {@link
		* android.view.accessibility.AccessibilityWindowInfo#getTitle}.
		*
		* @see WindowManager.LayoutParams#setTitle
		*/
		public abstract void setTitle(CharSequence title);

		@Deprecated

core/java/android/view/WindowManager.java

+9 −0

Original line number	Diff line number	Diff line
		@@ -5095,6 +5095,15 @@ public interface WindowManager extends ViewManager {
		format = _format;
		}

		/**
		* Sets a title for the window.
		* <p>
		* This title will be used primarily for debugging, and may be exposed via {@link
		* android.view.accessibility.AccessibilityWindowInfo#getTitle} if no {@link Window#setTitle
		* user-facing title} has been set.
		*
		* @see Window#setTitle
		*/
		public final void setTitle(CharSequence title) {
		if (null == title)
		title = "";

core/java/android/view/accessibility/AccessibilityWindowInfo.java

+3 −0

Original line number	Diff line number	Diff line
		@@ -160,6 +160,9 @@ public final class AccessibilityWindowInfo implements Parcelable {

		/**
		* Gets the title of the window.
		* <p>
		* This is taken from the {@link android.view.Window}'s title, or its {@link
		* android.view.WindowManager.LayoutParams} if that is unset.
		*
		* @return The title of the window, or {@code null} if none is available.
		*/