ilog.views.customizer.styling

Interface IlvRuleCustomizerLogic

public interface IlvRuleCustomizerLogic

This interface represents a logical customizer that can customize one CSS rule, or a logical group of CSS rules that represent one unit. The customizer can be retrieved from the CSS component adapter. The customizer is not a GUI component but only the functionality to change the rule.

In order to customize a rule, the process is as follows:

• Allocate a CSS component adapter for your component. For a chart component, allocate an ilog.views.chart.customizer.IlvChartCSSAdapter.
• Retrieve the rule customizer logic that matches a rule from the CSS component adapter.
• Set the main rule of the rule customizer logic.
• Set the rule customizer logic as target of the component customizer. The component customizer represents the GUI of the customizer.

This interface allows a uniform view to the predefined rule customizer logics that exist in Perforce JViews Charts. You don't need to create a class that implements this interface. The various predefined internal classes of rule customizer logics of Perforce JViews Charts implement this interface.

Since:

JViews 7.5

Method Summary

Modifier and Type	Method and Description
void	addPropertyChangeListener(PropertyChangeListener listener) Add a PropertyChangeListener to the listener list.
void	firePropertyChange(String propertyName, Object oldValue, Object newValue) Fires an event that a property has changed.
IlvComponentCSSAdapter	getAdapter() Returns the component css adapter this rule customizer logic belongs to.
Collection	getDependentRules() Returns the dependent rules that are currently handled by this rule customizer logic.
IlvCSSRule	getMainRule() Returns the main rule currently handled by this rule customizer logic.
boolean	match(IlvCSSRule rule) Returns true if the rule customizer logic matches a rule.
void	removePropertyChangeListener(PropertyChangeListener listener) Remove a PropertyChangeListener from the listener list.
void	setMainRule(IlvCSSRule rule) Sets the main rule handled by this rule customizer logic.

Method Detail

getAdapter

IlvComponentCSSAdapter getAdapter()

Returns the component css adapter this rule customizer logic belongs to.

setMainRule

void setMainRule(IlvCSSRule rule)

Sets the main rule handled by this rule customizer logic.

getMainRule

IlvCSSRule getMainRule()

Returns the main rule currently handled by this rule customizer logic. Returns null if no rule is currently handled by this rule customizer logic.

getDependentRules

Collection getDependentRules()

Returns the dependent rules that are currently handled by this rule customizer logic. This happens when the customizer handles a logical group of rules. From the main rule, the customizer determines whether other rules depend on the main rule.

Returns:

An unmodifiable collection of IlvCSSRule objects.

match

boolean match(IlvCSSRule rule)

Returns true if the rule customizer logic matches a rule. This means the rule customizer logic is suitable to customize the rule.

addPropertyChangeListener

void addPropertyChangeListener(PropertyChangeListener listener)

Add a PropertyChangeListener to the listener list. The listener is registered for all properties.

Parameters:

listener - The PropertyChangeListener to be added.

removePropertyChangeListener

void removePropertyChangeListener(PropertyChangeListener listener)

Remove a PropertyChangeListener from the listener list.

Parameters:

listener - The PropertyChangeListener to be removed.

firePropertyChange

void firePropertyChange(String propertyName,
                        Object oldValue,
                        Object newValue)

Fires an event that a property has changed. No event is fired if oldValue and oldValue are equal and non-null. rule customizer logics fire a property event "mainRule" if the main rule has changed.

Parameters:

propertyName - The name of the property that was changed.

oldValue - The old value of the property.

newValue - The new value of the property.