org.bukkit.event.server

Class TabCompleteEvent

java.lang.Object

org.bukkit.event.Event

org.bukkit.event.server.TabCompleteEvent

All Implemented Interfaces:

Cancellable

public class TabCompleteEvent
extends Event
implements Cancellable

Called when a CommandSender of any description (ie: player or console) attempts to tab complete.

Nested Class Summary

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

Event.Result

Constructor Summary

Constructors

Constructor and Description
TabCompleteEvent(CommandSender sender, String buffer, List<String> completions)
TabCompleteEvent(CommandSender sender, String buffer, List<String> completions, boolean isCommand, Location location)

Method Summary

Modifier and Type	Method and Description
String	getBuffer() Return the entire buffer which formed the basis of this completion.
List<String>	getCompletions() The list of completions which will be offered to the sender, in order.
static HandlerList	getHandlerList()
HandlerList	getHandlers()
Location	getLocation()
CommandSender	getSender() Get the sender completing this command.
boolean	isCancelled() Gets the cancellation state of this event.
boolean	isCommand()
void	setCancelled(boolean cancelled) Sets the cancellation state of this event.
void	setCompletions(List<String> completions) Set the completions offered, overriding any already set.

Methods inherited from class org.bukkit.event.Event

callEvent, getEventName, isAsynchronous

Methods inherited from class java.lang.Object

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

Constructor Detail

TabCompleteEvent

public TabCompleteEvent(CommandSender sender,
                        String buffer,
                        List<String> completions)

TabCompleteEvent

public TabCompleteEvent(CommandSender sender,
                        String buffer,
                        List<String> completions,
                        boolean isCommand,
                        Location location)

Method Detail

getSender

public CommandSender getSender()

Get the sender completing this command.

Returns:

the CommandSender instance

getBuffer

public String getBuffer()

Return the entire buffer which formed the basis of this completion.

Returns:

command buffer, as entered

getCompletions

public List<String> getCompletions()

The list of completions which will be offered to the sender, in order. This list is mutable and reflects what will be offered.

Returns:

a list of offered completions

isCommand

public boolean isCommand()

Returns:

True if it is a command being tab completed, false if it is a chat message.

getLocation

public Location getLocation()

Returns:

The position looked at by the sender, or null if none

setCompletions

public void setCompletions(List<String> completions)

Set the completions offered, overriding any already set. The passed collection will be cloned to a new List. You must call {getCompletions()} to mutate from here

Parameters:

completions - the new completions

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 cancelled)

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:

cancelled - true if you wish to cancel this event

getHandlers

public HandlerList getHandlers()

Specified by:

getHandlers in class Event

getHandlerList

public static HandlerList getHandlerList()