BotCommands-core/io.github.freya022.botcommands.api.components.builder.select.persistent/PersistentStringSelectBuilder

PersistentStringSelectBuilder

abstract class PersistentStringSelectBuilder : StringSelectMenu.Builder, BaseComponentBuilder<PersistentStringSelectBuilder> , IConstrainableComponent<PersistentStringSelectBuilder> , IUniqueComponent<PersistentStringSelectBuilder> , IPersistentActionableComponent<PersistentStringSelectBuilder> , IPersistentTimeoutableComponent<PersistentStringSelectBuilder> (source)

Constructors

constructor()

Properties

constraints

abstract var constraints: InteractionConstraints

context

abstract override val context: BContext

customId

@get:Nonnull

open override var customId: String

filters

abstract val filters: MutableList<ComponentInteractionFilter>

List of filters applied to this component.

isDisabled

@set:Nonnull

open override var isDisabled: Boolean

isRequired

@get:Nullable

@set:Nonnull

open override var isRequired: Boolean?

maxValues

@set:Nonnull

open override var maxValues: Int

minValues

@set:Nonnull

open override var minValues: Int

options

@get:Nonnull

open val options: List<SelectOption?>

placeholder

@get:Nullable

@set:Nonnull

open override var placeholder: String?

resetTimeoutOnUse

abstract var resetTimeoutOnUse: Boolean

When true, resets the timeout duration everytime this component is used.

singleUse

abstract var singleUse: Boolean

Sets this component as being usable once.

uniqueId

@set:Nonnull

open override var uniqueId: Int

Functions

addFilter

@CheckReturnValue

abstract fun addFilter(filter: ComponentInteractionFilter): PersistentStringSelectBuilder

@CheckReturnValue

abstract fun addFilter(filterType: Class<out ComponentInteractionFilter>): PersistentStringSelectBuilder

Applies a filter to this component.

addOption

@Nonnull

open fun addOption(@Nonnull label: String, @Nonnull value: String): StringSelectMenu.Builder

@Nonnull

open fun addOption(@Nonnull label: String, @Nonnull value: String, @Nonnull description: String): StringSelectMenu.Builder

@Nonnull

open fun addOption(@Nonnull label: String, @Nonnull value: String, @Nonnull emoji: Emoji): StringSelectMenu.Builder

@Nonnull

open fun addOption(@Nonnull label: String, @Nonnull value: String, @Nullable description: String?, @Nullable emoji: Emoji?): StringSelectMenu.Builder

addOptions

@Nonnull

open fun addOptions(@Nonnull options: Collection<out SelectOption?>): StringSelectMenu.Builder

@Nonnull

open fun addOptions(@Nonnull vararg options: SelectOption?): StringSelectMenu.Builder

addPermissions

@CheckReturnValue

abstract fun addPermissions(permissions: Collection<Permission>): PersistentStringSelectBuilder

@CheckReturnValue

open fun addPermissions(vararg permissions: Permission): PersistentStringSelectBuilder

Adds permissions to the constraints

addRoleIds

@CheckReturnValue

open fun addRoleIds(vararg roleIds: Long): PersistentStringSelectBuilder

@CheckReturnValue

abstract fun addRoleIds(roleIds: Collection<Long>): PersistentStringSelectBuilder

Adds role IDs to the constraints

addRoles

@CheckReturnValue

abstract fun addRoles(roles: Collection<Role>): PersistentStringSelectBuilder

@CheckReturnValue

open fun addRoles(vararg roles: Role): PersistentStringSelectBuilder

Adds role IDs to the constraints

addUserIds

@CheckReturnValue

open fun addUserIds(vararg userIds: Long): PersistentStringSelectBuilder

@CheckReturnValue

abstract fun addUserIds(userIds: Collection<Long>): PersistentStringSelectBuilder

Adds user IDs to the constraints

addUsers

@CheckReturnValue

abstract fun addUsers(users: Collection<UserSnowflake>): PersistentStringSelectBuilder

@CheckReturnValue

open fun addUsers(vararg users: UserSnowflake): PersistentStringSelectBuilder

Adds user IDs to the constraints

bindTo

@CheckReturnValue

open fun bindTo(handlerName: String, vararg data: Any?): PersistentStringSelectBuilder

@CheckReturnValue

abstract fun bindTo(handlerName: String, data: List<Any?>): PersistentStringSelectBuilder

Binds the given handler name with its arguments to this component.

build

abstract override fun build(): StringSelectMenu

constraints

@CheckReturnValue

abstract fun constraints(block: ReceiverConsumer<InteractionConstraints>): PersistentStringSelectBuilder

Allows manipulating the InteractionConstraints instance

@CheckReturnValue

abstract fun constraints(constraints: InteractionConstraints): PersistentStringSelectBuilder

Replaces the current interaction constraints with the given ones.

filter

inline fun <T : ComponentInteractionFilter> IActionableComponent<*>.filter(): T

Convenience extension to load an ComponentInteractionFilter service.

noTimeout

@CheckReturnValue

abstract fun noTimeout(): PersistentStringSelectBuilder

Removes the timeout from this component.

rateLimitReference

@CheckReturnValue

abstract fun rateLimitReference(reference: ComponentRateLimitReference): PersistentStringSelectBuilder

Sets the rate limiter of this component to one declared by a RateLimitProvider.

resetTimeoutOnUse

abstract fun resetTimeoutOnUse(resetTimeoutOnUse: Boolean): PersistentStringSelectBuilder

When true, resets the timeout duration everytime this component is used.

setCustomId

abstract override fun ~~setCustomId~~(customId: String): StringSelectMenu.Builder

setDefaultOptions

@Nonnull

open fun setDefaultOptions(@Nonnull values: Collection<out SelectOption?>): StringSelectMenu.Builder

@Nonnull

open fun setDefaultOptions(@Nonnull vararg values: SelectOption?): StringSelectMenu.Builder

setDefaultValues

@Nonnull

open fun setDefaultValues(@Nonnull vararg values: String?): StringSelectMenu.Builder

@Nonnull

open fun setDefaultValues(@Nonnull values: Collection<String?>): StringSelectMenu.Builder

setDisabled

@Nonnull

open fun setDisabled(disabled: Boolean): StringSelectMenu.Builder

setMaxValues

@Nonnull

open fun setMaxValues(maxValues: Int): StringSelectMenu.Builder

setMinValues

@Nonnull

open fun setMinValues(minValues: Int): StringSelectMenu.Builder

setPlaceholder

@Nonnull

open fun setPlaceholder(@Nullable placeholder: String?): StringSelectMenu.Builder

setRequired

@Nonnull

open fun setRequired(@Nullable required: Boolean?): StringSelectMenu.Builder

setRequiredRange

@Nonnull

open fun setRequiredRange(min: Int, max: Int): StringSelectMenu.Builder

setUniqueId

@Nonnull

open fun setUniqueId(uniqueId: Int): StringSelectMenu.Builder

singleUse

@CheckReturnValue

abstract fun singleUse(singleUse: Boolean): PersistentStringSelectBuilder

Sets this component as being usable once.

timeout

@CheckReturnValue

open fun timeout(timeout: Duration, handlerName: String, vararg data: Any?): PersistentStringSelectBuilder

@CheckReturnValue

open fun timeout(timeout: Duration, handlerName: String, data: List<Any?>): PersistentStringSelectBuilder

open fun timeout(timeout: Duration, handlerName: String, vararg data: Any?): PersistentStringSelectBuilder

abstract fun timeout(timeout: Duration, handlerName: String, data: List<Any?>): PersistentStringSelectBuilder

@CheckReturnValue

open fun timeout(timeout: Long, timeoutUnit: TimeUnit, handlerName: String, vararg data: Any?): PersistentStringSelectBuilder

@CheckReturnValue

open fun timeout(timeout: Long, timeoutUnit: TimeUnit, handlerName: String, data: List<Any?>): PersistentStringSelectBuilder

Sets the timeout on this component, invalidating the component on expiration, and running the timeout handler with the given name and its arguments.

@CheckReturnValue

open fun timeout(timeout: Duration): PersistentStringSelectBuilder

abstract fun timeout(timeout: Duration): PersistentStringSelectBuilder

@CheckReturnValue

open fun timeout(timeout: Long, timeoutUnit: TimeUnit): PersistentStringSelectBuilder

Sets the timeout on this component, invalidating the component on expiration.