org.eclipse.birt.chart.ui.swt.interfaces
Interface IUIServiceProvider

public interface IUIServiceProvider

IUIServiceProvider

Field Summary

static int	COMMAND_CHART_EXPRESSION Deprecated.
static int	COMMAND_EXPRESSION Deprecated.
static int	COMMAND_EXPRESSION_CHART_DATAPOINTS Constant indicating an expression builder to input chart data point variables.
static int	COMMAND_EXPRESSION_DATA_BINDINGS Constant indicating an expression builder to input data bindings.
static int	COMMAND_EXPRESSION_SCRIPT_DATAPOINTS Constant indicating an expression builder to input script (one type of triigers) for value series.
static int	COMMAND_EXPRESSION_TOOLTIPS_DATAPOINTS Constant indicating an expression builder to input tooltips (one type of triggers) for value series.
static int	COMMAND_EXPRESSION_TRIGGERS_SIMPLE Constant indicating an expression builder to input triggers except for value series.
static int	COMMAND_HYPERLINK Constant indicating a builder to input hyper-link except for data points.
static int	COMMAND_HYPERLINK_DATAPOINTS Constant indicating a builder to input hyper-link for data points.
static int	CRITICAL_ERRORS Constant indicating a major (though not fatal) problem in the model
static int	FATAL_ERRORS Constant indicating a fatal error in the model
static int	MINOR_ERRORS Constant indicating a minor error in the model
static int	NO_ERRORS Constant indicating no detectable problems exist in the model
static int	POSSIBLE_ERRORS Constant indicating possible problems detected in the model

Method Summary

double	getConvertedValue(double dOriginalValue, java.lang.String sFromUnits, java.lang.String sToUnits) Gets the result of converting the given value between the specified absolute units of measurement.
java.util.List<java.lang.String>	getRegisteredKeys() Fetches the list of registered keys for externalizing chart content
java.lang.String	getValue(java.lang.String sKey) Fetches the value for the specified key from the properties file appropriate for the current locale
java.lang.String	invoke(int command, java.lang.String value, java.lang.Object context, java.lang.String sTitle) This method will be used by the Chart Builder UI to invoke numerous builder by a specified command.
java.lang.String	invoke(java.lang.String sExpression, java.lang.Object Context, java.lang.String sTitle) Deprecated. use invoke( int command, String value, Object context, String sTitle ) instead.
java.lang.String	invoke(java.lang.String sExpression, java.lang.Object Context, java.lang.String sTitle, boolean isChartProvider) Deprecated. use invoke( int command, String value, Object context, String sTitle ) instead.
boolean	isEclipseModeSupported() Returns whether the application is running under Eclipse Mode
boolean	isInvokingSupported() Returns whether all outside builder invokings are supported
java.lang.String[]	validate(org.eclipse.birt.chart.model.Chart chartModel, java.lang.Object oContext) This method will be used by the Chart Builder UI to validate the model and show any error messages before the user leaves the dialog.

Field Detail

FATAL_ERRORS

static final int FATAL_ERRORS

Constant indicating a fatal error in the model

See Also:

Constant Field Values

CRITICAL_ERRORS

static final int CRITICAL_ERRORS

Constant indicating a major (though not fatal) problem in the model

See Also:

Constant Field Values

MINOR_ERRORS

static final int MINOR_ERRORS

Constant indicating a minor error in the model

See Also:

Constant Field Values

NO_ERRORS

static final int NO_ERRORS

Constant indicating no detectable problems exist in the model

See Also:

Constant Field Values

POSSIBLE_ERRORS

static final int POSSIBLE_ERRORS

Constant indicating possible problems detected in the model

See Also:

Constant Field Values

COMMAND_EXPRESSION_DATA_BINDINGS

static final int COMMAND_EXPRESSION_DATA_BINDINGS

Constant indicating an expression builder to input data bindings.

See Also:

Constant Field Values

COMMAND_EXPRESSION_CHART_DATAPOINTS

static final int COMMAND_EXPRESSION_CHART_DATAPOINTS

Constant indicating an expression builder to input chart data point variables.

See Also:

Constant Field Values

COMMAND_EXPRESSION_TRIGGERS_SIMPLE

static final int COMMAND_EXPRESSION_TRIGGERS_SIMPLE

Constant indicating an expression builder to input triggers except for value series.

See Also:

Constant Field Values

COMMAND_EXPRESSION_SCRIPT_DATAPOINTS

static final int COMMAND_EXPRESSION_SCRIPT_DATAPOINTS

Constant indicating an expression builder to input script (one type of triigers) for value series.

See Also:

Constant Field Values

COMMAND_EXPRESSION_TOOLTIPS_DATAPOINTS

static final int COMMAND_EXPRESSION_TOOLTIPS_DATAPOINTS

Constant indicating an expression builder to input tooltips (one type of triggers) for value series.

See Also:

Constant Field Values

COMMAND_EXPRESSION

static final int COMMAND_EXPRESSION

Deprecated.

Constant indicating a common expression builder.

See Also:

Constant Field Values

COMMAND_CHART_EXPRESSION

static final int COMMAND_CHART_EXPRESSION

Deprecated.

Constant indicating an expression builder specifically for chart.

See Also:

Constant Field Values

COMMAND_HYPERLINK

static final int COMMAND_HYPERLINK

Constant indicating a builder to input hyper-link except for data points.

See Also:

Constant Field Values

COMMAND_HYPERLINK_DATAPOINTS

static final int COMMAND_HYPERLINK_DATAPOINTS

Constant indicating a builder to input hyper-link for data points.

See Also:

Constant Field Values

Method Detail

invoke

java.lang.String invoke(java.lang.String sExpression,
                        java.lang.Object Context,
                        java.lang.String sTitle)

Deprecated. use invoke( int command, String value, Object context, String sTitle ) instead.

This method will be used by the Chart Builder UI to invoke the expression builder with any previously defined expression. The parameter may be null if a new expression is to be built.

Parameters:

sExpression - the expression to be displayed in the builder (after re-entry)

oContext - the application-specific context used by the Expression Builder for each invocation

sTitle - the title to be used for the Expression Builder Dialog

Returns:

The final expression string built by the user in the expression builder

invoke

java.lang.String invoke(java.lang.String sExpression,
                        java.lang.Object Context,
                        java.lang.String sTitle,
                        boolean isChartProvider)

Deprecated. use invoke( int command, String value, Object context, String sTitle ) instead.

This method will be used by the Chart Builder UI to invoke the expression builder with any previously defined expression. The parameter may be null if a new expression is to be built.

Parameters:

sExpression - the expression to be displayed in the builder (after re-entry)

oContext - the application-specific context used by the Expression Builder for each invocation

sTitle - the title to be used for the Expression Builder Dialog

isChartProvider - specified for chart expression provider.

Returns:

The final expression string built by the user in the expression builder

invoke

java.lang.String invoke(int command,
                        java.lang.String value,
                        java.lang.Object context,
                        java.lang.String sTitle)
                        throws org.eclipse.birt.chart.exception.ChartException

This method will be used by the Chart Builder UI to invoke numerous builder by a specified command.

Parameters:

command - Indicate which command will be executed.

value - initial value.

context - command context.

sTitle - dialog title if applicable.

Throws:

org.eclipse.birt.chart.exception.ChartException

Since:

2.0

isInvokingSupported

boolean isInvokingSupported()

Returns whether all outside builder invokings are supported

Since:

2.1

validate

java.lang.String[] validate(org.eclipse.birt.chart.model.Chart chartModel,
                            java.lang.Object oContext)

This method will be used by the Chart Builder UI to validate the model and show any error messages before the user leaves the dialog.

Parameters:

chartModel - the model to be validated

oContext - the application-specific context associated with the extended chart item

Returns:

an array of user-friendly messages indicating problems with the model

getRegisteredKeys

java.util.List<java.lang.String> getRegisteredKeys()

Fetches the list of registered keys for externalizing chart content

Returns:

List containing available keys for externalized content

getValue

java.lang.String getValue(java.lang.String sKey)

Fetches the value for the specified key from the properties file appropriate for the current locale

Parameters:

sKey - the lookup key for the externalized string

Returns:

the value associated with the key for the current locale, null if resource key is blank

getConvertedValue

double getConvertedValue(double dOriginalValue,
                         java.lang.String sFromUnits,
                         java.lang.String sToUnits)

Gets the result of converting the given value between the specified absolute units of measurement. Any implementation of this method needs to support conversion between at least the following units: Inches, Centimeters, Millimeters, Points and Pixels

Parameters:

dOriginalValue - the value to be converted

sFromUnits - the units of measurement from which the conversion is to be done

sToUnits - the units of measurement to which the conversion is to be done

Returns:

the converted value

isEclipseModeSupported

boolean isEclipseModeSupported()

Returns whether the application is running under Eclipse Mode

Since:

2.2