org.gudy.azureus2.plugins.ui
Interface UIManager

public interface UIManager

Management tools for the user interface.

Author:

parg

Method Summary

void	addUIEventListener(UIManagerEventListener listener)
void	addUIListener(UIManagerListener listener)
void	attachUI(UIInstanceFactory factory) attach a new UI
void	copyToClipBoard(java.lang.String data)
BasicPluginConfigModel	createBasicPluginConfigModel(java.lang.String section_name)
BasicPluginConfigModel	createBasicPluginConfigModel(java.lang.String parent_section, java.lang.String section_name) Creates a basic plugin view model and adds it to the plugin in one step.
BasicPluginViewModel	createBasicPluginViewModel(java.lang.String name) Creates a basic plugin view model and adds it to the plugin in one step.
UIMessage	createMessage() Retrieves a UIMessage from any interface available, or returns null if one is not available.
PluginView	createPluginView(PluginViewModel model) Deprecated. Use createBasicPluginViewModel
void	detachUI(UIInstanceFactory factory) detach a UI - can fail if the UI doesn't support detaching
BasicPluginViewModel	getBasicPluginViewModel(java.lang.String name) Deprecated. Use createBasicPluginViewModel
UIInputReceiver	getInputReceiver() Retrieves a UIInputReceiver from any interface available, or returns null if one is not available.
MenuManager	getMenuManager() Retrieve the menu manager.
PluginConfigModel[]	getPluginConfigModels()
SWTManager	getSWTManager() Deprecated.
TableManager	getTableManager() Retrieve the Table Manager
UIInstance[]	getUIInstances() Returns an array of all currently attached user interfaces.
boolean	hasUIInstances() Returns true if there any user interfaces currently attached to Azureus.
void	openFile(java.io.File file) Opens up the file using the associated application.
void	openTorrent(Torrent torrent)
void	openURL(java.net.URL url)
void	removeUIEventListener(UIManagerEventListener listener)
void	removeUIListener(UIManagerListener listener)
boolean	showConfigSection(java.lang.String sectionID) Open Config View to the section specified
void	showFile(java.io.File file) Shows the file in a file explorer application in its parent folder.
long	showMessageBox(java.lang.String title_resource, java.lang.String message_resource, long message_map)
void	showTextMessage(java.lang.String title_resource, java.lang.String message_resource, java.lang.String contents)

Method Detail

getBasicPluginViewModel

BasicPluginViewModel getBasicPluginViewModel(java.lang.String name)

Deprecated. Use createBasicPluginViewModel

Gets a basic plugin view model that supports simple plugin requirements After getting the model create the view using createPluginView

Parameters:

name - name

Returns:

BasicPluginViewModel

createPluginView

PluginView createPluginView(PluginViewModel model)

Deprecated. Use createBasicPluginViewModel

Creates a view from the model. It is then necessary to add it to the plugin as any other PluginView

Parameters:

model -

Returns:

PluginView

createBasicPluginConfigModel

BasicPluginConfigModel createBasicPluginConfigModel(java.lang.String section_name)

Parameters:

section_name -

Returns:

BasicPluginConfigModel

Since:

2.1.0.0

createBasicPluginConfigModel

BasicPluginConfigModel createBasicPluginConfigModel(java.lang.String parent_section,
                                                    java.lang.String section_name)

Creates a basic plugin view model and adds it to the plugin in one step.

Parameters:

parent_section -

section_name - see ConfigSection.SECTION_*

Returns:

BasicPluginConfigModel

Since:

2.1.0.0

getPluginConfigModels

PluginConfigModel[] getPluginConfigModels()

Returns:

Since:

2.5.0.1

createBasicPluginViewModel

BasicPluginViewModel createBasicPluginViewModel(java.lang.String name)

Creates a basic plugin view model and adds it to the plugin in one step. view is placed inside the plugins section of the configuration page.

Parameters:

name - The name for the view (this should be localised text, rather than a message string).

Returns:

BasicPluginViewModel

Since:

2.1.0.2

copyToClipBoard

void copyToClipBoard(java.lang.String data)
                     throws UIException

Parameters:

data -

Throws:

UIException

Since:

2.1.0.0

getTableManager

TableManager getTableManager()

Retrieve the Table Manager

Returns:

Table management functions

Since:

2.1.0.0

showTextMessage

void showTextMessage(java.lang.String title_resource,
                     java.lang.String message_resource,
                     java.lang.String contents)

Parameters:

title_resource -

message_resource -

contents -

Since:

2.3.0.5

showMessageBox

long showMessageBox(java.lang.String title_resource,
                    java.lang.String message_resource,
                    long message_map)

Parameters:

title_resource -

message -

message_map - - see UIManagerEvent.MT_x

Returns:

selected value

Since:

3.0.5.3

openURL

void openURL(java.net.URL url)
             throws UIException

Parameters:

url -

Throws:

UIException

Since:

2.3.0.6

openTorrent

void openTorrent(Torrent torrent)

Parameters:

torrent -

Since:

3.0.5.3

getSWTManager

SWTManager getSWTManager()

Deprecated.

Retrieve a class of SWT specific functions

Returns:

SWTManager

Since:

2.1.0.0

showConfigSection

boolean showConfigSection(java.lang.String sectionID)

Open Config View to the section specified

Parameters:

sectionID - ID of section to open to. ConfigSection.SECTION_* constants

Returns:

true-Section opened; false-Section invalid or UI does not support config views

Since:

2.3.0.7

getMenuManager

MenuManager getMenuManager()

Retrieve the menu manager.

Returns:

Menu management functions

Since:

3.0.0.7

attachUI

void attachUI(UIInstanceFactory factory)
              throws UIException

attach a new UI

Parameters:

factory -

Throws:

UIException

Since:

2.3.0.5

detachUI

void detachUI(UIInstanceFactory factory)
              throws UIException

detach a UI - can fail if the UI doesn't support detaching

Parameters:

factory -

Throws:

UIException

Since:

2.3.0.5

addUIListener

void addUIListener(UIManagerListener listener)

Parameters:

listener -

Since:

2.3.0.5

removeUIListener

void removeUIListener(UIManagerListener listener)

Parameters:

listener -

Since:

2.3.0.5

addUIEventListener

void addUIEventListener(UIManagerEventListener listener)

Parameters:

listener -

Since:

2.3.0.5

removeUIEventListener

void removeUIEventListener(UIManagerEventListener listener)

Parameters:

listener -

Since:

2.3.0.5

hasUIInstances

boolean hasUIInstances()

Returns true if there any user interfaces currently attached to Azureus. Note that this value may change over time, and that at the point when a plugin is being initialised, there is no guarantee over whether if the user interfaces will have been created yet or not. If you want to monitor what user interfaces are being attached / detached from Azureus, you should add a UIListener to this object.

Since:

3.0.0.7

getUIInstances

UIInstance[] getUIInstances()

Returns an array of all currently attached user interfaces. Note that this value may change over time, and that at the point when a plugin is being initialised, there is no guarantee over whether if the user interfaces will have been created yet or not. If you want to monitor what user interfaces are being attached / detached from Azureus, you should add a UIListener to this object.

Since:

3.0.0.7

getInputReceiver

UIInputReceiver getInputReceiver()

Retrieves a UIInputReceiver from any interface available, or returns null if one is not available. This is a convenience method to allow you to grab an instance without having to iterate over any attached interfaces.

Since:

3.0.5.3

See Also:

UIInstance.getInputReceiver()

createMessage

UIMessage createMessage()

Retrieves a UIMessage from any interface available, or returns null if one is not available. This is a convenience method to allow you to grab an instance without having to iterate over any attached interfaces.

Since:

3.0.5.3

See Also:

UIInstance.createMessage()

openFile

void openFile(java.io.File file)

Opens up the file using the associated application.

Parameters:

file - The file to open.

Since:

3.0.5.3

showFile

void showFile(java.io.File file)

Shows the file in a file explorer application in its parent folder.

Parameters:

file - The file to show.

Since:

3.0.5.3