Class Pane

java.lang.Object
com.github.stefvanschie.inventoryframework.pane.Pane
Direct Known Subclasses:
CycleButton, Label, MasonryPane, OutlinePane, PaginatedPane, PagingButtons, PatternPane, StaticPane, ToggleButton, VariableBar
public abstract class Pane extends Object
The base class for all panes.

  • Nested Class Summary

    Nested Classes
    Modifier and Type
    Class
    Description
    static enum 
    Pane.Priority
    An enum representing the rendering priorities for the panes.

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    protected int
    height
    Length is horizontal, height is vertical
    protected int
    length
    Length is horizontal, height is vertical
    protected @Nullable Consumer<? super InventoryClickEvent>
    onClick
    The consumer that will be called once a players clicks in this pane
    protected UUID
    uuid
    A unique identifier for panes to locate them by

  • Constructor Summary

    Constructors
    Modifier
    Constructor
    Description
    protected
    Pane(int length, int height)
    Constructs a new default pane, with no position
    protected
    Pane(int length, int height, @NotNull Pane.Priority priority)
    Constructs a new default pane

  • Method Summary

    Modifier and Type
    Method
    Description
    protected void
    callOnClick(@NotNull InventoryClickEvent event)
    Calls the consumer (if it's not null) that was specified using setOnClick(Consumer), so the consumer that should be called whenever this pane is clicked in.
    abstract void
    clear()
    Clears the entire pane of any items/panes.
    abstract boolean
    click(@NotNull Gui gui, @NotNull GuiComponent guiComponent, @NotNull InventoryClickEvent event, @NotNull Slot slot)
    Called whenever there is being clicked on this pane
    @NotNull Pane
    copy()
    Makes a copy of this pane and returns it.
    static @NotNull Pane
    createBorder(int length, int height, @NotNull GuiItem item)
    Creates a pane which displays as a border around the outside of the pane consisting of the provided item.
    abstract @NotNull GuiItemContainer
    display()
    Returns a GuiItemContainer with all the items that should be displayed of this pane.
    protected static <T extends GuiItem>
    T
    findMatchingItem(@NotNull Collection<T> items, @NotNull ItemStack item)
    Finds a type of GuiItem from the provided collection of items based on the provided ItemStack.
    int
    getHeight()
    Returns the height of this pane
    abstract @NotNull Collection<GuiItem>
    getItems()
    Gets all the items in this pane and all underlying panes.
    int
    getLength()
    Returns the length of this pane
    abstract @NotNull Collection<Pane>
    getPanes()
    Gets all the panes in this panes, including any child panes from other panes.
    @NotNull Pane.Priority
    getPriority()
    Returns the priority of the pane
    @NotNull UUID
    getUUID()
    Gets the UUID associated with this pane.
    boolean
    isVisible()
    Returns the pane's visibility state
    static void
    load(@NotNull Pane pane, @NotNull Object instance, @NotNull Element element)
     
    protected static boolean
    matchesItem(@NotNull GuiItem guiItem, @NotNull ItemStack item)
    Checks whether a GuiItem is the same item as the given ItemStack.
    void
    setHeight(int height)
    Set the height of this pane
    void
    setLength(int length)
    Set the length of this pane
    void
    setOnClick(@Nullable Consumer<? super InventoryClickEvent> onClick)
    Set the consumer that should be called whenever this pane is clicked in.
    void
    setPriority(@NotNull Pane.Priority priority)
    Sets the priority of this pane
    void
    setVisible(boolean visible)
    Sets whether this pane is visible or not

    Methods inherited from class Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

  • Field Details

    • length

      protected int length
      Length is horizontal, height is vertical

    • height

      protected int height
      Length is horizontal, height is vertical

    • onClick

      @Nullable protected @Nullable Consumer<? super InventoryClickEvent> onClick
      The consumer that will be called once a players clicks in this pane

    • uuid

      protected UUID uuid
      A unique identifier for panes to locate them by

  • Constructor Details

    • Pane

      protected Pane(int length, int height, @NotNull @NotNull Pane.Priority priority)
      Constructs a new default pane
      Parameters:
      length - the length of the pane
      height - the height of the pane
      priority - the priority of the pane
      Since:
      0.12.0

    • Pane

      protected Pane(int length, int height)
      Constructs a new default pane, with no position
      Parameters:
      length - the length of the pane
      height - the height of the pane

  • Method Details

    • copy

      @NotNull @Contract(pure=true) public @NotNull Pane copy()
      Makes a copy of this pane and returns it. This makes a deep copy of the pane. This entails that the underlying panes and/or items will be copied as well. The returned pane will never be reference equal to the current pane.
      Returns:
      a copy of this pane
      Since:
      0.6.2

    • setLength

      public void setLength(int length)
      Set the length of this pane
      Parameters:
      length - the new length

    • setHeight

      public void setHeight(int height)
      Set the height of this pane
      Parameters:
      height - the new height

    • getLength

      @Contract(pure=true) public int getLength()
      Returns the length of this pane
      Returns:
      the length

    • getHeight

      @Contract(pure=true) public int getHeight()
      Returns the height of this pane
      Returns:
      the height

    • getUUID

      @NotNull @Contract(pure=true) public @NotNull UUID getUUID()
      Gets the UUID associated with this pane.
      Returns:
      the uuid
      Since:
      0.7.1

    • display

      @NotNull public abstract @NotNull GuiItemContainer display()
      Returns a GuiItemContainer with all the items that should be displayed of this pane.
      Returns:
      a container containing all the items to be displayed
      Since:
      0.12.0

    • isVisible

      @Contract(pure=true) public boolean isVisible()
      Returns the pane's visibility state
      Returns:
      the pane's visibility

    • setVisible

      public void setVisible(boolean visible)
      Sets whether this pane is visible or not
      Parameters:
      visible - the pane's visibility

    • click

      public abstract boolean click(@NotNull @NotNull Gui gui, @NotNull @NotNull GuiComponent guiComponent, @NotNull @NotNull InventoryClickEvent event, @NotNull @NotNull Slot slot)
      Called whenever there is being clicked on this pane
      Parameters:
      gui - the gui in which was clicked
      guiComponent - the gui component in which this pane resides
      event - the event that occurred while clicking on this item
      slot - the slot that was clicked in
      Returns:
      whether the item was found or not

    • setPriority

      public void setPriority(@NotNull @NotNull Pane.Priority priority)
      Sets the priority of this pane
      Parameters:
      priority - the priority

    • load

      public static void load(@NotNull @NotNull Pane pane, @NotNull @NotNull Object instance, @NotNull @NotNull Element element)

    • matchesItem

      @Contract(pure=true) protected static boolean matchesItem(@NotNull @NotNull GuiItem guiItem, @NotNull @NotNull ItemStack item)
      Checks whether a GuiItem is the same item as the given ItemStack. The item will be compared using internal data. When the item does not have this data, this method will return false. If the item does have such data, but its value does not match, false is also returned. This method will not mutate any of the provided arguments.
      Parameters:
      guiItem - the gui item to check
      item - the item which the gui item should be checked against
      Returns:
      true if the GuiItem matches the ItemStack, false otherwise
      Since:
      0.10.14

    • findMatchingItem

      @Nullable @Contract(pure=true) protected static <T extends GuiItem> T findMatchingItem(@NotNull @NotNull Collection<T> items, @NotNull @NotNull ItemStack item)
      Finds a type of GuiItem from the provided collection of items based on the provided ItemStack. The items will be compared using internal data. When the item does not have this data, this method will return null. If the item does have such data, but its value cannot be found in the provided list, null is also returned. This method will not mutate any of the provided arguments, nor any of the contents inside of the arguments. The provided collection may be unmodifiable if preferred. This method will always return a type of GuiItem that is in the provided collection - when the returned result is not null - such that an element E inside the provided collection reference equals the returned type of GuiItem.
      Type Parameters:
      T - a type of GuiItem, which will be used in the provided collection and as return type
      Parameters:
      items - a collection of items in which will be searched
      item - the item for which an GuiItem should be found
      Returns:
      the found type of GuiItem or null if none was found
      Since:
      0.5.14

    • getPriority

      @NotNull public @NotNull Pane.Priority getPriority()
      Returns the priority of the pane
      Returns:
      the priority

    • getItems

      @NotNull @Contract(pure=true) public abstract @NotNull Collection<GuiItem> getItems()
      Gets all the items in this pane and all underlying panes. The returned collection is not guaranteed to be mutable or to be a view of the underlying data. (So changes to the gui are not guaranteed to be visible in the returned value.)
      Returns:
      all items

    • getPanes

      @NotNull @Contract(pure=true) public abstract @NotNull Collection<Pane> getPanes()
      Gets all the panes in this panes, including any child panes from other panes. The returned collection is not guaranteed to be mutable or to be a view of the underlying data. (So changes to the gui are not guaranteed to be visible in the returned value.)
      Returns:
      all panes

    • clear

      public abstract void clear()
      Clears the entire pane of any items/panes. Underlying panes will not be cleared.
      Since:
      0.3.2

    • setOnClick

      public void setOnClick(@Nullable @Nullable Consumer<? super InventoryClickEvent> onClick)
      Set the consumer that should be called whenever this pane is clicked in.
      Parameters:
      onClick - the consumer that gets called
      Since:
      0.4.0

    • callOnClick

      protected void callOnClick(@NotNull @NotNull InventoryClickEvent event)
      Calls the consumer (if it's not null) that was specified using setOnClick(Consumer), so the consumer that should be called whenever this pane is clicked in.
      Parameters:
      event - the event to handle
      Since:
      0.6.0

    • createBorder

      @NotNull @Contract(pure=true) public static @NotNull Pane createBorder(int length, int height, @NotNull @NotNull GuiItem item)
      Creates a pane which displays as a border around the outside of the pane consisting of the provided item. The slot, length and height parameters are used for the respective properties of the pane. If either the length or height is negative an IllegalArgumentException will be thrown.
      Parameters:
      length - the length of the pane
      height - the height of the pane
      item - the item of which the border is made
      Returns:
      the created pane which displays a border
      Throws:
      IllegalArgumentException - if length or height is negative
      Since:
      0.12.0