1.1.1 choices
public <property type>[] choices<PropertyName>([<property type> param])
public List<property type> choices<PropertyName>([<property  type> param])
Complements a get/set method for a reference field.
The choices method provides the user with a set of options for setting a property. This method  is called when the user interface makes the options available, hence its return  can be based on  the current state of the object. Note - this does not limit the state of the field,  see the validate  methods for a way to do that.