Summary: Ctors | Methods | Inherited Methods

CustomTabsIntent.Builder

Kotlin |Java

public static final class CustomTabsIntent.Builder
extends Object

java.lang.Object
↳	androidx.browser.customtabs.CustomTabsIntent.Builder

Builder class for CustomTabsIntent objects.

Summary

Public constructors
`CustomTabsIntent.Builder()` Creates a `CustomTabsIntent.Builder` object associated with no `CustomTabsSession`.
`CustomTabsIntent.Builder(CustomTabsSession session)` Creates a `CustomTabsIntent.Builder` object associated with a given `CustomTabsSession`.

Public methods
`CustomTabsIntent.Builder`	`addDefaultShareMenuItem()` Adds a default share item to the menu.
`CustomTabsIntent.Builder`	`addMenuItem(String label, PendingIntent pendingIntent)` Adds a menu item.
`CustomTabsIntent.Builder`	`addToolbarItem(int id, Bitmap icon, String description, PendingIntent pendingIntent)` This method is deprecated. Use CustomTabsIntent.Builder#setSecondaryToolbarViews(RemoteViews, int[], PendingIntent).
`CustomTabsIntent`	`build()` Combines all the options that have been set and returns a new `CustomTabsIntent` object.
`CustomTabsIntent.Builder`	`enableUrlBarHiding()` Enables the url bar to hide as the user scrolls down on the page.
`CustomTabsIntent.Builder`	`setActionButton(Bitmap icon, String description, PendingIntent pendingIntent, boolean shouldTint)` Sets the action button that is displayed in the Toolbar.
`CustomTabsIntent.Builder`	`setActionButton(Bitmap icon, String description, PendingIntent pendingIntent)` Sets the action button that is displayed in the Toolbar with default tinting behavior.
`CustomTabsIntent.Builder`	`setCloseButtonIcon(Bitmap icon)` Sets the Close button icon for the custom tab.
`CustomTabsIntent.Builder`	`setExitAnimations(Context context, int enterResId, int exitResId)` Sets the exit animations.
`CustomTabsIntent.Builder`	`setInstantAppsEnabled(boolean enabled)` Sets whether Instant Apps is enabled for this Custom Tab.
`CustomTabsIntent.Builder`	`setSecondaryToolbarColor(int color)` Sets the color of the secondary toolbar.
`CustomTabsIntent.Builder`	`setSecondaryToolbarViews(RemoteViews remoteViews, int[] clickableIDs, PendingIntent pendingIntent)` Sets the remote views displayed in the secondary toolbar in a custom tab.
`CustomTabsIntent.Builder`	`setShowTitle(boolean showTitle)` Sets whether the title should be shown in the custom tab.
`CustomTabsIntent.Builder`	`setStartAnimations(Context context, int enterResId, int exitResId)` Sets the start animations.
`CustomTabsIntent.Builder`	`setToolbarColor(int color)` Sets the toolbar color.

Inherited methods

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

CustomTabsIntent.Builder

public CustomTabsIntent.Builder ()

Creates a CustomTabsIntent.Builder object associated with no CustomTabsSession.

CustomTabsIntent.Builder

public CustomTabsIntent.Builder (CustomTabsSession session)

Creates a CustomTabsIntent.Builder object associated with a given CustomTabsSession. Guarantees that the Intent will be sent to the same component as the one the session is associated with.

Parameters
`session`	`CustomTabsSession`: The session to associate this Builder with.

Public methods

addDefaultShareMenuItem

public CustomTabsIntent.Builder addDefaultShareMenuItem ()

Adds a default share item to the menu.

Returns
`CustomTabsIntent.Builder`

addMenuItem

public CustomTabsIntent.Builder addMenuItem (String label, 
                PendingIntent pendingIntent)

Adds a menu item.

Parameters
`label`	`String`: Menu label.
`pendingIntent`	`PendingIntent`: Pending intent delivered when the menu item is clicked.

Returns
`CustomTabsIntent.Builder`

addToolbarItem

public CustomTabsIntent.Builder addToolbarItem (int id, 
                Bitmap icon, 
                String description, 
                PendingIntent pendingIntent)

This method is deprecated.
Use CustomTabsIntent.Builder#setSecondaryToolbarViews(RemoteViews, int[], PendingIntent).

Adds an action button to the custom tab. Multiple buttons can be added via this method. If the given id equals CustomTabsIntent.TOOLBAR_ACTION_BUTTON_ID, the button will be placed on the toolbar; if the bitmap is too wide, it will be put to the bottom bar instead. If the id is not CustomTabsIntent.TOOLBAR_ACTION_BUTTON_ID, it will be directly put on secondary toolbar. The maximum number of allowed toolbar items in a single intent is CustomTabsIntent.getMaxToolbarItems(). Throws an IllegalStateException when that number is exceeded per intent.

Parameters
`id`	`int`: The unique id of the action button. This should be non-negative.
`icon`	`Bitmap`: The icon.
`description`	`String`: The description for the button. To be used for accessibility.
`pendingIntent`	`PendingIntent`: The pending intent delivered when the button is clicked.

Returns
`CustomTabsIntent.Builder`

Throws
`IllegalStateException`

See also:

CustomTabsIntent.getMaxToolbarItems()

build

public CustomTabsIntent build ()

Combines all the options that have been set and returns a new CustomTabsIntent object.

Returns
`CustomTabsIntent`

enableUrlBarHiding

public CustomTabsIntent.Builder enableUrlBarHiding ()

Enables the url bar to hide as the user scrolls down on the page.

Returns
`CustomTabsIntent.Builder`

setActionButton

public CustomTabsIntent.Builder setActionButton (Bitmap icon, 
                String description, 
                PendingIntent pendingIntent, 
                boolean shouldTint)

Sets the action button that is displayed in the Toolbar.

This is equivalent to calling addToolbarItem(int, Bitmap, String, PendingIntent) with CustomTabsIntent.TOOLBAR_ACTION_BUTTON_ID as id.

Parameters
`icon`	`Bitmap`: The icon.
`description`	`String`: The description for the button. To be used for accessibility.
`pendingIntent`	`PendingIntent`: pending intent delivered when the button is clicked.
`shouldTint`	`boolean`: Whether the action button should be tinted.

Returns
`CustomTabsIntent.Builder`

See also:

addToolbarItem(int, Bitmap, String, PendingIntent)

setActionButton

public CustomTabsIntent.Builder setActionButton (Bitmap icon, 
                String description, 
                PendingIntent pendingIntent)

Sets the action button that is displayed in the Toolbar with default tinting behavior.

Parameters
`icon`	`Bitmap`
`description`	`String`
`pendingIntent`	`PendingIntent`

Returns
`CustomTabsIntent.Builder`

See also:

setActionButton(Bitmap, String, PendingIntent, boolean)

setCloseButtonIcon

public CustomTabsIntent.Builder setCloseButtonIcon (Bitmap icon)

Sets the Close button icon for the custom tab.

Parameters
`icon`	`Bitmap`: The icon `Bitmap`

Returns
`CustomTabsIntent.Builder`

setExitAnimations

public CustomTabsIntent.Builder setExitAnimations (Context context, 
                int enterResId, 
                int exitResId)

Sets the exit animations.

Parameters
`context`	`Context`: Application context.
`enterResId`	`int`: Resource ID of the "enter" animation for the application.
`exitResId`	`int`: Resource ID of the "exit" animation for the browser.

Returns
`CustomTabsIntent.Builder`

setInstantAppsEnabled

public CustomTabsIntent.Builder setInstantAppsEnabled (boolean enabled)

Sets whether Instant Apps is enabled for this Custom Tab.

Parameters
`enabled`	`boolean`: Whether Instant Apps should be enabled.

Returns
`CustomTabsIntent.Builder`

setSecondaryToolbarColor

public CustomTabsIntent.Builder setSecondaryToolbarColor (int color)

Sets the color of the secondary toolbar.

Parameters
`color`	`int`: The color for the secondary toolbar.

Returns
`CustomTabsIntent.Builder`

public CustomTabsIntent.Builder setSecondaryToolbarViews (RemoteViews remoteViews, 
                int[] clickableIDs, 
                PendingIntent pendingIntent)

Sets the remote views displayed in the secondary toolbar in a custom tab.

Parameters
`remoteViews`	`RemoteViews`: The `RemoteViews` that will be shown on the secondary toolbar.
`clickableIDs`	`int`: The IDs of clickable views. The onClick event of these views will be handled by custom tabs.
`pendingIntent`	`PendingIntent`: The `PendingIntent` that will be sent when the user clicks on one of the `View`s in clickableIDs. When the `PendingIntent` is sent, it will have the current URL as its intent data.

Returns
`CustomTabsIntent.Builder`

See also:

setShowTitle

public CustomTabsIntent.Builder setShowTitle (boolean showTitle)

Sets whether the title should be shown in the custom tab.

Parameters
`showTitle`	`boolean`: Whether the title should be shown.

Returns
`CustomTabsIntent.Builder`

setStartAnimations

public CustomTabsIntent.Builder setStartAnimations (Context context, 
                int enterResId, 
                int exitResId)

Sets the start animations.

Parameters
`context`	`Context`: Application context.
`enterResId`	`int`: Resource ID of the "enter" animation for the browser.
`exitResId`	`int`: Resource ID of the "exit" animation for the application.

Returns
`CustomTabsIntent.Builder`

setToolbarColor

public CustomTabsIntent.Builder setToolbarColor (int color)

Sets the toolbar color.

Parameters
`color`	`int`: `Color`

Returns
`CustomTabsIntent.Builder`

CustomTabsIntent.Builder

Summary

Public constructors

Public methods

Inherited methods

Public constructors

CustomTabsIntent.Builder

CustomTabsIntent.Builder

Public methods

addDefaultShareMenuItem

addMenuItem

addToolbarItem

build

enableUrlBarHiding

setActionButton

setActionButton

setCloseButtonIcon

setExitAnimations

setInstantAppsEnabled

setSecondaryToolbarColor

setSecondaryToolbarViews

setShowTitle

setStartAnimations

setToolbarColor

Annotations

Classes