BotCommands/io.github.freya022.botcommands.api.components.builder.button/PersistentButtonBuilder

PersistentButtonBuilder

class PersistentButtonBuilder : AbstractButtonBuilder<PersistentButtonBuilder> , IPersistentActionableComponent<PersistentButtonBuilder> , IPersistentTimeoutableComponent<PersistentButtonBuilder> (source)

Properties

componentType

override val componentType: ComponentType

constraints

open override var constraints: InteractionConstraints

context

open override val context: BContext

filters

open override val filters: MutableList<ComponentInteractionFilter<*>>

List of filters applied to this component.

handler

open override val handler: ComponentHandler?

instance

open override val instance: PersistentButtonBuilder

lifetimeType

open override val lifetimeType: LifetimeType

oneUse

open override var ~~oneUse~~: Boolean

Sets this component as being usable once.

rateLimitGroup

open override val rateLimitGroup: String?

resetTimeoutOnUse

open override var resetTimeoutOnUse: Boolean

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

singleUse

open override var singleUse: Boolean

Sets this component as being usable once.

timeout

open override val timeout: ComponentTimeout?

timeoutDuration

open override val timeoutDuration: Duration?

Functions

addFilter

@CheckReturnValue

open override fun addFilter(filter: ComponentInteractionFilter<*>): PersistentButtonBuilder

@CheckReturnValue

open override fun addFilter(filterType: Class<out ComponentInteractionFilter<*>>): PersistentButtonBuilder

Applies a filter to this component.

addPermissions

@CheckReturnValue

open override fun addPermissions(vararg permissions: Permission): PersistentButtonBuilder

@CheckReturnValue

open override fun addPermissions(permissions: Collection<Permission>): PersistentButtonBuilder

Adds permissions to the constraints

addRoleIds

@CheckReturnValue

open override fun addRoleIds(vararg roleIds: Long): PersistentButtonBuilder

@CheckReturnValue

open override fun addRoleIds(roleIds: Collection<Long>): PersistentButtonBuilder

Adds role IDs to the constraints

addRoles

@CheckReturnValue

open override fun addRoles(vararg roles: Role): PersistentButtonBuilder

@CheckReturnValue

open override fun addRoles(roles: Collection<Role>): PersistentButtonBuilder

Adds role IDs to the constraints

addUserIds

@CheckReturnValue

open override fun addUserIds(vararg userIds: Long): PersistentButtonBuilder

@CheckReturnValue

open override fun addUserIds(userIds: Collection<Long>): PersistentButtonBuilder

Adds user IDs to the constraints

addUsers

@CheckReturnValue

open override fun addUsers(vararg users: UserSnowflake): PersistentButtonBuilder

@CheckReturnValue

open override fun addUsers(users: Collection<UserSnowflake>): PersistentButtonBuilder

Adds user IDs to the constraints

bindTo

@CheckReturnValue

open override fun ~~bindTo~~(handlerName: String, block: ReceiverConsumer<PersistentHandlerBuilder>): PersistentButtonBuilder

@CheckReturnValue

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

@CheckReturnValue

open override fun bindTo(handlerName: String, data: List<Any?>): PersistentButtonBuilder

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

build

@CheckReturnValue

fun build(): Button

constraints

@CheckReturnValue

open override fun constraints(block: ReceiverConsumer<InteractionConstraints>): PersistentButtonBuilder

Allows manipulating the InteractionConstraints instance

@CheckReturnValue

open override fun constraints(constraints: InteractionConstraints): PersistentButtonBuilder

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

open override fun noTimeout(): PersistentButtonBuilder

Removes the timeout from this component.

oneUse

@CheckReturnValue

open override fun ~~oneUse~~(oneUse: Boolean): PersistentButtonBuilder

Sets this component as being usable once.

rateLimitReference

@CheckReturnValue

open override fun rateLimitReference(group: String): PersistentButtonBuilder

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

resetTimeoutOnUse

open override fun resetTimeoutOnUse(resetTimeoutOnUse: Boolean): PersistentButtonBuilder

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

singleUse

@CheckReturnValue

open override fun singleUse(singleUse: Boolean): PersistentButtonBuilder

Sets this component as being usable once.

timeout

@CheckReturnValue

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

@CheckReturnValue

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

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 override fun timeout(timeout: Duration): PersistentButtonBuilder

@CheckReturnValue

open override fun timeout(timeout: Long, timeoutUnit: TimeUnit): PersistentButtonBuilder

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