me.mattstudios.mfgui.gui.guis

Class PaginatedGui

java.lang.Object

me.mattstudios.mfgui.gui.guis.BaseGui

me.mattstudios.mfgui.gui.guis.PaginatedGui

All Implemented Interfaces:

org.bukkit.inventory.InventoryHolder

Direct Known Subclasses:

ScrollingGui

public class PaginatedGui
extends BaseGui

GUI that allows you to have multiple pages

Constructor Summary

Constructors

Constructor and Description
PaginatedGui(int rows, int pageSize, @NotNull String title) Main constructor of the PaginatedGui
PaginatedGui(int rows, @NotNull String title) Alternative constructor that doesn't require the pageSize to be defined
PaginatedGui(@NotNull org.bukkit.plugin.Plugin plugin, int rows, int pageSize, @NotNull String title) Deprecated. No longer requires the plugin's instance to be passed use PaginatedGui(int, int, String) instead
PaginatedGui(@NotNull org.bukkit.plugin.Plugin plugin, int rows, @NotNull String title) Deprecated. No longer requires the plugin's instance to be passed use PaginatedGui(int, String) instead
PaginatedGui(@NotNull org.bukkit.plugin.Plugin plugin, @NotNull String title) Deprecated. No longer requires the plugin's instance to be passed use PaginatedGui(String) instead
PaginatedGui(@NotNull String title) Alternative constructor that only requires title

Method Summary

Modifier and Type	Method and Description
void	addItem(GuiItem... items) Overridden BaseGui.addItem(GuiItem...) to add the items to the page instead
void	addItem(@NotNull GuiItem item) Adds an GuiItem to the next available slot in the page area
Map<Integer,GuiItem>	getCurrentPageItems() Gets an immutable Map with all the current pages items
int	getCurrentPageNum() Gets the current page number
int	getNextPageNum() Gets the next page number
List<GuiItem>	getPageItems() Gets an immutable List with all the page items added to the GUI
int	getPrevPageNum() Gets the previous page number
boolean	next() Goes to the next page
boolean	nextPage() Deprecated. Use next() instead
void	open(@NotNull org.bukkit.entity.HumanEntity player) Overrides BaseGui.open(HumanEntity) to use the paginated populator instead
void	open(@NotNull org.bukkit.entity.HumanEntity player, int openPage) Specific open method for the Paginated GUI Uses populatePage()
boolean	previous() Goes to the previous page if possible
boolean	prevPage() Deprecated. Use previous() instead
BaseGui	setPageSize(int pageSize) Sets the page size
void	update() Overridden BaseGui.update() to use the paginated open
void	updatePageItem(int slot, @NotNull GuiItem item) Alternative updatePageItem(int, ItemStack) that uses GuiItem instead
void	updatePageItem(int row, int col, @NotNull GuiItem item) Alternative updatePageItem(int, GuiItem) that uses ROWS and COLUMNS instead
void	updatePageItem(int row, int col, @NotNull org.bukkit.inventory.ItemStack itemStack) Alternative updatePageItem(int, ItemStack) that uses ROWS and COLUMNS instead
void	updatePageItem(int slot, @NotNull org.bukkit.inventory.ItemStack itemStack) Updates the page GuiItem on the slot in the page Can get the slot from InventoryClickEvent.getSlot()
BaseGui	updateTitle(@NotNull String title) Overrides BaseGui.updateTitle(String) to use the paginated populator instead Updates the title of the GUI This method may cause LAG if used on a loop

Methods inherited from class me.mattstudios.mfgui.gui.guis.BaseGui

addSlotAction, addSlotAction, close, getFiller, getGuiItem, getGuiItems, getInventory, getRows, isUpdating, removeItem, removeItem, setCloseGuiAction, setDefaultClickAction, setDefaultTopClickAction, setDragAction, setItem, setItem, setItem, setOpenGuiAction, setOutsideClickAction, setRows, setUpdating, updateItem, updateItem, updateItem, updateItem

Methods inherited from class java.lang.Object

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

Constructor Detail

PaginatedGui

public PaginatedGui(int rows,
                    int pageSize,
                    @NotNull
                    @NotNull String title)

Main constructor of the PaginatedGui

Parameters:

rows - The rows the GUI should have

pageSize - The pageSize

title - The GUI's title

PaginatedGui

public PaginatedGui(int rows,
                    @NotNull
                    @NotNull String title)

Alternative constructor that doesn't require the pageSize to be defined

Parameters:

rows - The rows the GUI should have

title - The GUI's title

PaginatedGui

public PaginatedGui(@NotNull
                    @NotNull String title)

Alternative constructor that only requires title

Parameters:

title - The GUI's title

PaginatedGui

@Deprecated
public PaginatedGui(@NotNull
                                 @NotNull org.bukkit.plugin.Plugin plugin,
                                 int rows,
                                 int pageSize,
                                 @NotNull
                                 @NotNull String title)

Deprecated. No longer requires the plugin's instance to be passed use PaginatedGui(int, int, String) instead

Old constructor

Parameters:

plugin - The plugin's instance

rows - The rows the GUI should have

pageSize - The pageSize

title - The GUI's title

PaginatedGui

@Deprecated
public PaginatedGui(@NotNull
                                 @NotNull org.bukkit.plugin.Plugin plugin,
                                 int rows,
                                 @NotNull
                                 @NotNull String title)

Deprecated. No longer requires the plugin's instance to be passed use PaginatedGui(int, String) instead

Old constructor

Parameters:

plugin - The plugin's instance

rows - The rows the GUI should have

title - The GUI's title

PaginatedGui

@Deprecated
public PaginatedGui(@NotNull
                                 @NotNull org.bukkit.plugin.Plugin plugin,
                                 @NotNull
                                 @NotNull String title)

Deprecated. No longer requires the plugin's instance to be passed use PaginatedGui(String) instead

Old constructor

Parameters:

plugin - The plugin's instance

title - The GUI's title

Method Detail

setPageSize

public BaseGui setPageSize(int pageSize)

Sets the page size

Parameters:

pageSize - The new page size

Returns:

The GUI for easier use when declaring, works like a builder

addItem

public void addItem(@NotNull
                    @NotNull GuiItem item)

Adds an GuiItem to the next available slot in the page area

Parameters:

item - The GuiItem to add to the page

addItem

public void addItem(@NotNull
                    GuiItem... items)

Overridden BaseGui.addItem(GuiItem...) to add the items to the page instead

Overrides:

addItem in class BaseGui

Parameters:

items - Varargs for specifying the GuiItems

update

public void update()

Overridden BaseGui.update() to use the paginated open

Overrides:

update in class BaseGui

updatePageItem

public void updatePageItem(int slot,
                           @NotNull
                           @NotNull org.bukkit.inventory.ItemStack itemStack)

Updates the page GuiItem on the slot in the page Can get the slot from InventoryClickEvent.getSlot()

Parameters:

slot - The slot of the item to update

itemStack - The new ItemStack

updatePageItem

public void updatePageItem(int row,
                           int col,
                           @NotNull
                           @NotNull org.bukkit.inventory.ItemStack itemStack)

Alternative updatePageItem(int, ItemStack) that uses ROWS and COLUMNS instead

Parameters:

row - The row of the slot

col - The columns of the slot

itemStack - The new ItemStack

updatePageItem

public void updatePageItem(int slot,
                           @NotNull
                           @NotNull GuiItem item)

Alternative updatePageItem(int, ItemStack) that uses GuiItem instead

Parameters:

slot - The slot of the item to update

item - The new ItemStack

updatePageItem

public void updatePageItem(int row,
                           int col,
                           @NotNull
                           @NotNull GuiItem item)

Alternative updatePageItem(int, GuiItem) that uses ROWS and COLUMNS instead

Parameters:

row - The row of the slot

col - The columns of the slot

item - The new GuiItem

open

public void open(@NotNull
                 @NotNull org.bukkit.entity.HumanEntity player)

Overrides BaseGui.open(HumanEntity) to use the paginated populator instead

Overrides:

open in class BaseGui

Parameters:

player - The HumanEntity to open the GUI to

open

public void open(@NotNull
                 @NotNull org.bukkit.entity.HumanEntity player,
                 int openPage)

Specific open method for the Paginated GUI Uses populatePage()

Parameters:

player - The HumanEntity to open it to

openPage - The specific page to open at

updateTitle

public BaseGui updateTitle(@NotNull
                           @NotNull String title)

Overrides BaseGui.updateTitle(String) to use the paginated populator instead Updates the title of the GUI This method may cause LAG if used on a loop

Overrides:

updateTitle in class BaseGui

Parameters:

title - The title to set

Returns:

The GUI for easier use when declaring, works like a builder

getCurrentPageItems

public Map<Integer,GuiItem> getCurrentPageItems()

Gets an immutable Map with all the current pages items

Returns:

The Map with all the currentPage

getPageItems

public List<GuiItem> getPageItems()

Gets an immutable List with all the page items added to the GUI

Returns:

The List with all the pageItems

getCurrentPageNum

public int getCurrentPageNum()

Gets the current page number

Returns:

The current page number

getNextPageNum

public int getNextPageNum()

Gets the next page number

Returns:

The next page number or pageNum if no next is present

getPrevPageNum

public int getPrevPageNum()

Gets the previous page number

Returns:

The previous page number or pageNum if no previous is present

next

public boolean next()

Goes to the next page

nextPage

@Deprecated
public boolean nextPage()

Deprecated. Use next() instead

Goes to the next page

previous

public boolean previous()

Goes to the previous page if possible

prevPage

@Deprecated
public boolean prevPage()

Deprecated. Use previous() instead

Goes to the previous page if possible