org.bukkit.event.player
Class PlayerEditBookEvent

java.lang.Object
  org.bukkit.event.Event
      org.bukkit.event.player.PlayerEvent
          org.bukkit.event.player.PlayerEditBookEvent

All Implemented Interfaces:

Cancellable

public class PlayerEditBookEvent
extends PlayerEvent
implements Cancellable

Called when a player edits or signs a book and quill item. If the event is cancelled, no changes are made to the BookMeta

Nested Class Summary

Nested classes/interfaces inherited from class org.bukkit.event.Event

Event.Result

Field Summary

Fields inherited from class org.bukkit.event.player.PlayerEvent

player

Constructor Summary

PlayerEditBookEvent(Player who, int slot, BookMeta previousBookMeta, BookMeta newBookMeta, boolean isSigning)

Method Summary

static HandlerList	getHandlerList()
HandlerList	getHandlers()
BookMeta	getNewBookMeta() Gets the book meta that the player is attempting to add to the book.
BookMeta	getPreviousBookMeta() Gets the book meta currently on the book.
int	getSlot() Gets the inventory slot number for the book item that triggered this event.
boolean	isCancelled() Gets the cancellation state of this event.
boolean	isSigning() Gets whether or not the book is being signed.
void	setCancelled(boolean cancel) Sets the cancellation state of this event.
void	setNewBookMeta(BookMeta newBookMeta) Sets the book meta that will actually be added to the book.
void	setSigning(boolean signing) Sets whether or not the book is being signed.

Methods inherited from class org.bukkit.event.player.PlayerEvent

getPlayer

Methods inherited from class org.bukkit.event.Event

getEventName, isAsynchronous

Methods inherited from class java.lang.Object

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

Constructor Detail

PlayerEditBookEvent

public PlayerEditBookEvent(Player who,
                           int slot,
                           BookMeta previousBookMeta,
                           BookMeta newBookMeta,
                           boolean isSigning)

Method Detail

getPreviousBookMeta

public BookMeta getPreviousBookMeta()

Gets the book meta currently on the book.

Note: this is a copy of the book meta. You cannot use this object to change the existing book meta.

Returns:

the book meta currently on the book

getNewBookMeta

public BookMeta getNewBookMeta()

Gets the book meta that the player is attempting to add to the book.

Note: this is a copy of the proposed new book meta. Use setNewBookMeta(BookMeta) to change what will actually be added to the book.

Returns:

the book meta that the player is attempting to add

getSlot

public int getSlot()

Gets the inventory slot number for the book item that triggered this event.

This is a slot number on the player's hotbar in the range 0-8.

Returns:

the inventory slot number that the book item occupies

setNewBookMeta

public void setNewBookMeta(BookMeta newBookMeta)
                    throws IllegalArgumentException

Sets the book meta that will actually be added to the book.

Parameters:

newBookMeta - new book meta

Throws:

IllegalArgumentException - if the new book meta is null

isSigning

public boolean isSigning()

Gets whether or not the book is being signed. If a book is signed the Material changes from BOOK_AND_QUILL to WRITTEN_BOOK.

Returns:

true if the book is being signed

setSigning

public void setSigning(boolean signing)

Sets whether or not the book is being signed. If a book is signed the Material changes from BOOK_AND_QUILL to WRITTEN_BOOK.

Parameters:

signing - whether or not the book is being signed.

getHandlers

public HandlerList getHandlers()

Specified by:

getHandlers in class Event

getHandlerList

public static HandlerList getHandlerList()

isCancelled

public boolean isCancelled()

Description copied from interface: Cancellable

Gets the cancellation state of this event. A cancelled event will not be executed in the server, but will still pass to other plugins

Specified by:

isCancelled in interface Cancellable

Returns:

true if this event is cancelled

setCancelled

public void setCancelled(boolean cancel)

Description copied from interface: Cancellable

Sets the cancellation state of this event. A cancelled event will not be executed in the server, but will still pass to other plugins.

Specified by:

setCancelled in interface Cancellable

Parameters:

cancel - true if you wish to cancel this event