Package net.dv8tion.jda.api.entities

Interface IPositionableChannel

All Superinterfaces:
Channel, Comparable<GuildChannel>, Formattable, GuildChannel, IMentionable, ISnowflake
All Known Subinterfaces:
BaseGuildMessageChannel, Category, NewsChannel, StageChannel, StoreChannel, TextChannel, VoiceChannel
public interface IPositionableChannel extends GuildChannel
Represents a GuildChannel that has a position. These channels can be re-ordered using a position value. In the case of identical position values, the natural order of the channel snowflakes is used.

  • Method Details

    • getManager

      @Nonnull IPositionableChannelManager<?,?> getManager()
      Description copied from interface: GuildChannel
      Returns the ChannelManager for this GuildChannel.
      In the ChannelManager, you can modify the name, topic and position of this GuildChannel. You modify multiple fields in one request by chaining setters before calling RestAction.queue().

      This is a lazy idempotent getter. The manager is retained after the first call. This getter is not thread-safe and would require guards by the user.

      Specified by:
      getManager in interface GuildChannel
      Returns:
      The ChannelManager of this GuildChannel

    • getPosition

      default int getPosition()
      The position this GuildChannel is displayed at.
      Higher values mean they are displayed lower in the Client. Position 0 is the top most GuildChannel Channels of a Guild do not have to have continuous positions
      Returns:
      Zero-based int of position of the GuildChannel.
      Throws:
      IllegalStateException - If this channel is not in the guild cache

    • getPositionRaw

      int getPositionRaw()
      The actual position of the GuildChannel as stored and given by Discord. Channel positions are actually based on a pairing of the creation time (as stored in the snowflake id) and the position. If 2 or more channels share the same position then they are sorted based on their creation date. The more recent a channel was created, the lower it is in the hierarchy. This is handled by getPosition() and it is most likely the method you want. If, for some reason, you want the actual position of the channel then this method will give you that value.
      Returns:
      The true, Discord stored, position of the GuildChannel.