Interface ICustomId

All Superinterfaces:

Component

All Known Subinterfaces:

ActionComponent, AttachmentUpload, Button, Checkbox, CheckboxGroup, EntitySelectMenu, RadioGroup, SelectMenu, StringSelectMenu, TextInput

public interface ICustomId
extends Component

Component which has an associated custom id.

Nested Class Summary

Nested classes/interfaces inherited from interface Component

Component.Type

Method Summary

Modifier and Type	Method	Description
String	getCustomId()	An unique component ID or null.
ICustomId	withUniqueId(int uniqueId)	Creates a new component with the provided numeric ID.

Methods inherited from interface Component

getType, getUniqueId, isMessageCompatible, isModalCompatible

Method Details

getCustomId

@Nullable
String getCustomId()

An unique component ID or null.
Some components such as link buttons don't have this.

Custom IDs can contain custom data, this is typically used to pass data between a slash command and your button listener.

While this ID is unique and can be retrieved with ComponentInteraction.getComponentId(), you should use Component.getUniqueId() to identify a component in a single message, such as when replacing components using ComponentTree or IReplaceable.replace(ComponentReplacer).

Returns:

The component ID or null if not present

See Also:

• ComponentInteraction.getComponentId()
• Component.getUniqueId()

withUniqueId

@Nonnull
ICustomId withUniqueId(int uniqueId)

Description copied from interface: Component

Creates a new component with the provided numeric ID.
If no ID is set, Discord will generate IDs incrementally starting from 1 and will not use existing IDs from the same message/modal.

Specified by:

withUniqueId in interface Component

Parameters:

uniqueId - The new ID; must be higher or equal to 1

Returns:

The new component