org.eclipse.birt.report.model.api.metadata
Interface IChoiceSet


public interface IChoiceSet

Represents a set of choices on a predefined or user defined property type or property definition.


Method Summary
 boolean contains(java.lang.String choiceName)
          Returns true if the choice set has a match for the given name.
 IChoice findChoice(java.lang.String name)
          Finds a Choice in the ChoiceSet for the given choice name.
 IChoice findChoiceByDisplayName(java.lang.String name)
          Finds a IChoice in the IChoiceSet for its display name.
 UserChoice findUserChoiceByDisplayName(org.eclipse.birt.report.model.core.Module module, java.lang.String name)
          Finds a UserChoice in the IChoiceSet for its display name.
 IChoice[] getChoices()
          Returns an array containing the choices, the return choices are in their internal sequence.
 IChoice[] getChoices(java.util.Comparator c)
          Returns an array containing the choices, the return choices are sorted according to the given comparator.
 java.lang.String getName()
          Returns the name of this ChoiceSet.
 boolean isUserDefined()
          Tests whether this is a user-defined choice set or not.
 

Method Detail

contains

public boolean contains(java.lang.String choiceName)
Returns true if the choice set has a match for the given name.

Parameters:
choiceName - the choice name to match
Returns:
true if the name matches a choice, false otherwise

isUserDefined

public boolean isUserDefined()
Tests whether this is a user-defined choice set or not.

Returns:
true if the choice set is defined by user. Otherwise, false.

getName

public java.lang.String getName()
Returns the name of this ChoiceSet.

Returns:
the name of the ChoiceSet

getChoices

public IChoice[] getChoices()
Returns an array containing the choices, the return choices are in their internal sequence.

Returns:
the array of choices

getChoices

public IChoice[] getChoices(java.util.Comparator c)
Returns an array containing the choices, the return choices are sorted according to the given comparator. All elements in the array must be mutually comparable by the specified comparator (that is, c.compare(e1, e2) must not throw a ClassCastException for any elements e1 and e2 in the array).

Parameters:
c - the comparator that will be used to sort the choices. A null value indicates that the choices are natural ordered by their name.
Returns:
the array of choices sorted according to the given comparator.

findChoice

public IChoice findChoice(java.lang.String name)
Finds a Choice in the ChoiceSet for the given choice name.

Parameters:
name - the name of a Choice.
Returns:
the instance of the Choice that matches or null if choice not found.

findChoiceByDisplayName

public IChoice findChoiceByDisplayName(java.lang.String name)
Finds a IChoice in the IChoiceSet for its display name. For a user defined choice, the display name can be null.

Parameters:
name - display name of a IChoice.
Returns:
the instance of the Choice that matches or null if choice is not found.

findUserChoiceByDisplayName

public UserChoice findUserChoiceByDisplayName(org.eclipse.birt.report.model.core.Module module,
                                              java.lang.String name)
Finds a UserChoice in the IChoiceSet for its display name. For a user defined choice, the display name can be null.

Parameters:
module - the module
name - display name of a UserChoice.
Returns:
the instance of the UserChoice that matches or null if choice is not found.


Copyright © 2005 Actuate Corp. All rights reserved.