Config

abstract class Config
kotlin.Any
   ↳ androidx.emoji.text.EmojiCompat.Config

Configuration class for EmojiCompat. Changes to the values will be ignored after #init(Config) is called.

Summary

Protected constructors

Default constructor.

Public methods
open EmojiCompat.Config!

Sets the color used as emoji span indicator.

open EmojiCompat.Config!

Determines the strategy to start loading the metadata.

open EmojiCompat.Config!
setEmojiSpanIndicatorEnabled(emojiSpanIndicatorEnabled: Boolean)

Determines whether a background will be drawn for the emojis that are found and replaced by EmojiCompat.

open EmojiCompat.Config!
setReplaceAll(replaceAll: Boolean)

Determines whether EmojiCompat should replace all the emojis it finds with the EmojiSpans.

open EmojiCompat.Config!

Unregisters a callback that was added before.

open EmojiCompat.Config!
setUseEmojiAsDefaultStyle(useEmojiAsDefaultStyle: Boolean)

Determines whether EmojiCompat should use the emoji presentation style for emojis that have text style as default.

open EmojiCompat.Config!
setUseEmojiAsDefaultStyle(useEmojiAsDefaultStyle: Boolean, emojiAsDefaultStyleExceptions: MutableList<Int!>?)

open EmojiCompat.Config!

Registers an initialization callback.

Protected methods
EmojiCompat.MetadataRepoLoader!

Returns the MetadataRepoLoader.

Protected constructors

<init>

protected Config(metadataLoader: EmojiCompat.MetadataRepoLoader)

Default constructor.

Parameters
metadataLoader EmojiCompat.MetadataRepoLoader: MetadataRepoLoader instance, cannot be null

Public methods

setEmojiSpanIndicatorColor

open fun setEmojiSpanIndicatorColor(color: Int): EmojiCompat.Config!

Sets the color used as emoji span indicator. The default value is Color#GREEN.

setMetadataLoadStrategy

open fun setMetadataLoadStrategy(strategy: Int): EmojiCompat.Config!

Determines the strategy to start loading the metadata. By default EmojiCompat will start loading the metadata during EmojiCompat#init(Config). When set to EmojiCompat#LOAD_STRATEGY_MANUAL, you should call EmojiCompat#load() to initiate metadata loading.

Parameters
strategy Int: one of EmojiCompat#LOAD_STRATEGY_DEFAULT, EmojiCompat#LOAD_STRATEGY_MANUAL

setEmojiSpanIndicatorEnabled

open fun setEmojiSpanIndicatorEnabled(emojiSpanIndicatorEnabled: Boolean): EmojiCompat.Config!

Determines whether a background will be drawn for the emojis that are found and replaced by EmojiCompat. Should be used only for debugging purposes. The indicator color can be set using #setEmojiSpanIndicatorColor(int).

Parameters
emojiSpanIndicatorEnabled Boolean: when true a background is drawn for each emoji that is replaced

setReplaceAll

open fun setReplaceAll(replaceAll: Boolean): EmojiCompat.Config!

Determines whether EmojiCompat should replace all the emojis it finds with the EmojiSpans. By default EmojiCompat tries its best to understand if the system already can render an emoji and do not replace those emojis.

Parameters
replaceAll Boolean: replace all emojis found with EmojiSpans
Return
EmojiCompat.Config!: EmojiCompat.Config instance

unregisterInitCallback

open fun unregisterInitCallback(initCallback: EmojiCompat.InitCallback): EmojiCompat.Config!

Unregisters a callback that was added before.

Parameters
initCallback EmojiCompat.InitCallback: the initialization callback to be removed, cannot be null
Return
EmojiCompat.Config!: EmojiCompat.Config instance

setUseEmojiAsDefaultStyle

open fun setUseEmojiAsDefaultStyle(useEmojiAsDefaultStyle: Boolean): EmojiCompat.Config!

Determines whether EmojiCompat should use the emoji presentation style for emojis that have text style as default. By default, the text style would be used, unless these are followed by the U+FE0F variation selector. Details about emoji presentation and text presentation styles can be found here: http://unicode.org/reports/tr51/#Presentation_Style If useEmojiAsDefaultStyle is true, the emoji presentation style will be used for all emojis, including potentially unexpected ones (such as digits or other keycap emojis). If this is not the expected behaviour, method #setUseEmojiAsDefaultStyle(boolean, List) can be used to specify the exception emojis that should be still presented as text style.

Parameters
useEmojiAsDefaultStyle Boolean: whether to use the emoji style presentation for all emojis that would be presented as text style by default

setUseEmojiAsDefaultStyle

open fun setUseEmojiAsDefaultStyle(useEmojiAsDefaultStyle: Boolean, emojiAsDefaultStyleExceptions: MutableList<Int!>?): EmojiCompat.Config!
Parameters
emojiAsDefaultStyleExceptions Boolean: Contains the exception emojis which will be still presented as text style even if the useEmojiAsDefaultStyle flag is set to true. This list will be ignored if useEmojiAsDefaultStyle is false. Note that emojis with default emoji style presentation will remain emoji style regardless the value of useEmojiAsDefaultStyle or whether they are included in the exceptions list or not. When no exception is wanted, the method #setUseEmojiAsDefaultStyle(boolean) should be used instead.

registerInitCallback

open fun registerInitCallback(initCallback: EmojiCompat.InitCallback): EmojiCompat.Config!

Registers an initialization callback.

Parameters
initCallback EmojiCompat.InitCallback: the initialization callback to register, cannot be null
Return
EmojiCompat.Config!: EmojiCompat.Config instance

Protected methods

getMetadataRepoLoader

protected fun getMetadataRepoLoader(): EmojiCompat.MetadataRepoLoader!

Returns the MetadataRepoLoader.