com.ur.urcap.api.contribution.toolbar.swing

Interface SwingToolbarService

public interface SwingToolbarService

Defines an API required for defining and adding to PolyScope a toolbar.

Method Summary

Modifier and Type	Method and Description
void	configureContribution(ToolbarConfiguration configuration) This method is called once after the SwingToolbarService is registered.
SwingToolbarContribution	createToolbar(ToolbarContext context) Creates a new toolbar instance.
Icon	getIcon()

Method Detail

getIcon

Icon getIcon()

Returns:

The icon displayed in PolyScope for the URCap's toolbar. Called once at startup

Throws:

NullPointerException - in case this methods returns null

configureContribution

void configureContribution(ToolbarConfiguration configuration)

This method is called once after the SwingToolbarService is registered. Modify the configuration parameter to configure your contribution. The configuration object will already have default values for its properties matching most use cases.

The values of the ToolbarConfiguration object will be read once immediately after this method call. Changing values at a later stage will have no effect, so do not store a reference to the configuration object.

If the default values are appropriate, leave this method empty.

Parameters:

configuration - a modifiable ToolbarConfiguration with default values

createToolbar

SwingToolbarContribution createToolbar(ToolbarContext context)

Creates a new toolbar instance.

Parameters:

context - Provides access to services and APIs relevant for the toolbar

Returns:

the newly constructed toolbar contribution instance. Called once at startup.