org.gudy.azureus2.plugins.ui.tables
Interface TableManager

public interface TableManager

Allows plugins to manage Azureus UI tables.

Since:

2.0.8.5

Author:

TuxPaper

Field Summary

static java.lang.String	TABLE_ALL_PEERS Visible for All Peers table
static java.lang.String	TABLE_MYSHARES Visible for My Shares table
static java.lang.String	TABLE_MYTORRENTS_COMPLETE Visible for Completed Torrents table
static java.lang.String	TABLE_MYTORRENTS_INCOMPLETE Visible for Incompleted Torrents table
static java.lang.String	TABLE_MYTRACKER Visible for My Tracker table
static java.lang.String	TABLE_TORRENT_FILES Visible for Torrent Files table
static java.lang.String	TABLE_TORRENT_PEERS Visible for Torrent Peers table
static java.lang.String	TABLE_TORRENT_PIECES Visible for Torrent Pieces table

Method Summary

void	addColumn(TableColumn tableColumn) Adds a column to an Azureus UI table.
TableContextMenuItem	addContextMenuItem(java.lang.String tableID, java.lang.String resourceKey) Adds a Context Menu item to the specified table or to all table context menus.
TableContextMenuItem	addContextMenuItem(TableContextMenuItem parent, java.lang.String resourceKey) Adds a Context Menu item as a sub-item of the given menu item.
TableColumn	createColumn(java.lang.String tableID, java.lang.String cellID) Creates a column for a UI table.

Field Detail

TABLE_MYTORRENTS_COMPLETE

static final java.lang.String TABLE_MYTORRENTS_COMPLETE

Visible for Completed Torrents table

See Also:

Constant Field Values

TABLE_MYTORRENTS_INCOMPLETE

static final java.lang.String TABLE_MYTORRENTS_INCOMPLETE

Visible for Incompleted Torrents table

See Also:

Constant Field Values

TABLE_TORRENT_PEERS

static final java.lang.String TABLE_TORRENT_PEERS

Visible for Torrent Peers table

See Also:

Constant Field Values

TABLE_TORRENT_PIECES

static final java.lang.String TABLE_TORRENT_PIECES

Visible for Torrent Pieces table

See Also:

Constant Field Values

TABLE_TORRENT_FILES

static final java.lang.String TABLE_TORRENT_FILES

Visible for Torrent Files table

See Also:

Constant Field Values

TABLE_MYTRACKER

static final java.lang.String TABLE_MYTRACKER

Visible for My Tracker table

See Also:

Constant Field Values

TABLE_MYSHARES

static final java.lang.String TABLE_MYSHARES

Visible for My Shares table

See Also:

Constant Field Values

TABLE_ALL_PEERS

static final java.lang.String TABLE_ALL_PEERS

Visible for All Peers table

See Also:

Constant Field Values

Method Detail

createColumn

TableColumn createColumn(java.lang.String tableID,
                         java.lang.String cellID)

Creates a column for a UI table. In order for this object to be displayed in an Azureus UI table, the returned object must be added via the addColumn(TableColumn)

The distinction between creating and adding a column is required because some TableColumn functions are not available or act differently after the column had been added.

In order to the plugin to display correctly the column name, your are required to create a key in your language file consisting of the TableManager Table ID of the table you are adding the column to, plus ".column." plus the logical name of your column.

For example, if you are creating a column named "quality" in the table TABLE_TORRENT_FILES, youwould have to add the following to your language file:
Files.column.quality=Column Title
and if you wish to have a short description of the column (visible when the user is setting up columns), create another entry with the same key plus ".info". For the example above:
Files.column.quality.info=One line description

Parameters:

tableID - Which table the column will be visible in. See TableManager.

cellID - The logical name of the column.

Returns:

an interface object allowing modification of the table column.

addColumn

void addColumn(TableColumn tableColumn)

Adds a column to an Azureus UI table.

Parameters:

tableColumn - a column previously created with createColumn(java.lang.String, java.lang.String)

addContextMenuItem

TableContextMenuItem addContextMenuItem(java.lang.String tableID,
                                        java.lang.String resourceKey)

Adds a Context Menu item to the specified table or to all table context menus.

Parameters:

tableID - Which table the menu item will be visible in. See TableManager. If null, the menu item will be added to all table context menus.

resourceKey - ID of the context menu, which is also used to retrieve the textual name from the plugin language file.

Returns:

a newly created menu item for the table's context menu.

addContextMenuItem

TableContextMenuItem addContextMenuItem(TableContextMenuItem parent,
                                        java.lang.String resourceKey)

Adds a Context Menu item as a sub-item of the given menu item.

Parameters:

parent - The MenuItem to add this new item to. The parent MenuItem must have its style attribute to be set to "menu".

resourceKey - ID of the context menu, which is also used to retrieve the textual name from the plugin language file.

Returns:

a newly created menu item existing inside the given menu item.