Class GuiComponent

java.lang.Object
com.github.stefvanschie.inventoryframework.gui.GuiComponent
public class GuiComponent extends Object
Represents a component within a gui that can hold items. This is always in the shape of a rectangular grid.
Since:
0.8.0

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    protected final @NotNull List<PositionedPane>
    panes
    A set of all panes in this inventory.

  • Constructor Summary

    Constructors
    Constructor
    Description
    GuiComponent(int length, int height)
    Creates a new gui component with the specified length and width.

  • Method Summary

    Modifier and Type
    Method
    Description
    void
    addPane(@NotNull Slot slot, @NotNull Pane pane)
    Adds a pane to the current collection of panes.
    void
    click(@NotNull Gui gui, @NotNull InventoryClickEvent event, int index)
    Delegates the handling of the specified click event to the panes of this component.
    @NotNull GuiComponent
    copy()
    Creates a deep copy of this gui component.
    void
    display()
    This will make each pane in this component render their items in this gui component.
    void
    display(@NotNull Inventory inventory, int offset)
    This will make each pane in this component render their items in this inventory component.
    void
    display(@NotNull PlayerInventory inventory, int offset)
    This will make each pane in this component render their items in this gui component.
    @NotNull GuiComponent
    excludeRows(int from, int end)
    Returns a new gui component, excluding the range of specified rows.
    int
    getHeight()
    Gets the height of this gui component.
    int
    getLength()
    Gets the length of this gui component.
    @NotNull List<Pane>
    getPanes()
    Gets a list of panes this gui component contains.
    @NotNull List<? extends PositionedPane>
    getPositionedPanes()
    Gets a list of panes with their positions this gui component contains.
    boolean
    hasItem()
    Checks whether this component has at least one item.
    void
    load(@NotNull Object instance, @NotNull Element element, @NotNull Plugin plugin)
    Loads the provided element's child panes onto this component.
    void
    placeItems(@NotNull Inventory inventory, int offset)
    This places the items currently existing in this gui component into the specified inventory.
    void
    placeItems(@NotNull PlayerInventory inventory, int offset)
    This places the items currently existing in this gui component into the specified player inventory.

    Methods inherited from class Object

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

  • Field Details

    • panes

      @NotNull protected final @NotNull List<PositionedPane> panes
      A set of all panes in this inventory. This is guaranteed to be sorted in order of the pane's priorities, from the lowest priority to the highest priority. The order of panes with the same priority is unspecified.

  • Constructor Details

    • GuiComponent

      public GuiComponent(int length, int height)
      Creates a new gui component with the specified length and width. If either the length or the width is less than zero, an IllegalArgumentException will be thrown.
      Parameters:
      length - the length of the component
      height - the height of the component
      Since:
      0.8.0

  • Method Details

    • addPane

      public void addPane(@NotNull @NotNull Slot slot, @NotNull @NotNull Pane pane)
      Adds a pane to the current collection of panes.
      Parameters:
      slot - the position of the pane
      pane - the pane to add
      Since:
      0.8.0

    • display

      public void display(@NotNull @NotNull Inventory inventory, int offset)
      This will make each pane in this component render their items in this inventory component. The panes are displayed according to their priority, with the lowest priority rendering first and the highest priority (note: highest priority, not Pane.Priority.HIGHEST priority) rendering last. The items displayed in this gui component will be put into the specified inventory. The slots will start at the given offset up to this component's size + the offset specified.
      Parameters:
      inventory - the inventory to place the items in
      offset - the offset from which to start counting the slots
      Since:
      0.8.0
      See Also:

    • display

      public void display(@NotNull @NotNull PlayerInventory inventory, int offset)
      This will make each pane in this component render their items in this gui component. The panes are displayed according to their priority, with the lowest priority rendering first and the highest priority (note: highest priority, not Pane.Priority.HIGHEST priority) rendering last. The items displayed in this gui component will be put into the inventory found in InventoryHolder.getInventory(). The slots will be placed from the top-right to the bottom-left, continuing from left-to-right, top-to-bottom plus the specified offset. This ordering is different from the normal ordering of the indices of a PlayerInventory. See for the normal ordering of a PlayerInventory's slots its documentation.
      Parameters:
      inventory - the inventory to place the items in
      offset - the offset from which to start counting the slots
      Since:
      0.8.0
      See Also:

    • placeItems

      public void placeItems(@NotNull @NotNull PlayerInventory inventory, int offset)
      This places the items currently existing in this gui component into the specified player inventory. The slots will be placed from the top-right to the bottom-left, continuing from left-to-right, top-to-bottom plus the specified offset. This ordering is different from the normal ordering of the indices of a PlayerInventory. See for the normal ordering of a PlayerInventory's slots its documentation. In contrast to display(PlayerInventory, int) this does not render the panes of this component.
      Parameters:
      inventory - the inventory to place the items in
      offset - the offset from which to start counting the slots
      Since:
      0.8.0
      See Also:

    • placeItems

      public void placeItems(@NotNull @NotNull Inventory inventory, int offset)
      This places the items currently existing in this gui component into the specified inventory. The slots will start at the given offset up to this component's size + the offset specified. In contrast to display(Inventory, int) this does not render the panes of this component.
      Parameters:
      inventory - the inventory to place the items in
      offset - the offset from which to start counting the slots
      Since:
      0.8.0
      See Also:

    • click

      public void click(@NotNull @NotNull Gui gui, @NotNull @NotNull InventoryClickEvent event, int index)
      Delegates the handling of the specified click event to the panes of this component. This will call Pane.click(Gui, GuiComponent, InventoryClickEvent, Slot) on each pane until the right item has been found.
      Parameters:
      gui - the gui this inventory component belongs to
      event - the event to delegate
      index - the slot that was clicked
      Since:
      0.8.0

    • copy

      @NotNull @Contract(pure=true) public @NotNull GuiComponent copy()
      Creates a deep copy of this gui component. This means that all internal items will be cloned and all panes will be copied as per their own ItemStack.clone() and Pane.copy() methods. The returned gui component is guaranteed to not reference equals this gui component.
      Returns:
      the new gui component
      Since:
      0.8.0

    • excludeRows

      @NotNull @Contract(pure=true) public @NotNull GuiComponent excludeRows(int from, int end)
      Returns a new gui component, excluding the range of specified rows. The new gui component will have its size shrunk so only the included rows are present and any items in the excluded rows are discarded. All panes will stay present. Note that while this does make a new gui component, it does not make a copy. For example, the panes in the new gui component will be the exact same panes as in this one and will not be copied. This is also true for any retained items. The specified range is 0-indexed: the first row starts at index 0 and the last row ends at height - 1. The range is inclusive on both ends, the row specified at either parameter will also be excluded. When the range specified is invalid - that is, part of the range contains rows that are not included in this gui component, and IllegalArgumentException will be thrown.
      Parameters:
      from - the starting index of the range
      end - the ending index of the range
      Returns:
      the new, shrunk gui component
      Since:
      0.8.0

    • load

      public void load(@NotNull @NotNull Object instance, @NotNull @NotNull Element element, @NotNull @NotNull Plugin plugin)
      Loads the provided element's child panes onto this component. If the element contains any child panes, this will mutate this component.
      Parameters:
      instance - the instance to apply field and method references on
      element - the element to load
      plugin - the plugin to load the panes with
      Since:
      0.10.12

    • hasItem

      @Contract(pure=true) public boolean hasItem()
      Checks whether this component has at least one item. If it does, true is returned; false otherwise.
      Returns:
      true if this has an item, false otherwise
      Since:
      0.8.0

    • display

      public void display()
      This will make each pane in this component render their items in this gui component. The panes are displayed according to their priority, with the lowest priority rendering first and the highest priority (note: highest priority, not Pane.Priority.HIGHEST priority) rendering last.
      Since:
      0.8.0
      See Also:

    • getPositionedPanes

      @NotNull @Contract(pure=true) public @NotNull List<? extends PositionedPane> getPositionedPanes()
      Gets a list of panes with their positions this gui component contains. The returned list is unmodifiable. If this gui component currently does not have any panes, an empty list is returned. This list is guaranteed to be sorted according to the panes' priorities. The returned collection is not synchronized and no guarantees should be made as to the safety of concurrently accessing the returned collection. If synchronized behaviour should be allowed, the returned collection must be synchronized externally.
      Returns:
      the panes this component has
      Since:
      0.12.0

    • getPanes

      @NotNull @Contract(pure=true) public @NotNull List<Pane> getPanes()
      Gets a list of panes this gui component contains. The returned list is modifiable. If this gui component currently does not have any panes, an empty list is returned. This list is guaranteed to be sorted according to the panes' priorities.
      Returns:
      the panes this component has
      Since:
      0.8.0

    • getHeight

      @Contract(pure=true) public int getHeight()
      Gets the height of this gui component.
      Returns:
      the height
      Since:
      0.8.0

    • getLength

      @Contract(pure=true) public int getLength()
      Gets the length of this gui component.
      Returns:
      the length
      Since:
      0.8.0