install4j API documentation


com.install4j.api.beaninfo
Class Install4JPropertyDescriptor

java.lang.Object
  extended by java.beans.FeatureDescriptor
      extended by java.beans.PropertyDescriptor
          extended by com.install4j.api.beaninfo.Install4JPropertyDescriptor
Direct Known Subclasses:
FilePropertyDescriptor, ScriptPropertyDescriptor

public class Install4JPropertyDescriptor
extends java.beans.PropertyDescriptor

Property descriptor for use in instances of Install4JBeanInfo. For file and script properties, derived classes are available.

Using this class is not strictly required. In principle, you could also set values for the ATTRIBUTE_* constants in the property descriptor of an unrelated property descriptor class.


Field Summary
static java.lang.String ATTRIBUTE_CONTEXT
           
static java.lang.String ATTRIBUTE_PROPERTY_CATEGORY
           
static java.lang.String ATTRIBUTE_SORT_KEY
           
static java.lang.String CATEGORY_CONFIGURATION
          Default category used by install4j.
static java.lang.String CONTEXT_DATETIME
          Special context for properties of type java.util.Date that tells the install4j GUI to offer a time editor besides the default date editor as well.
static java.lang.String CONTEXT_LAUNCHER_ID
          Special context for properties of type java.lang.String that tells the install4j GUI to treat the string value as the id of a launcher.
static java.lang.String CONTEXT_MULTILINE
          Special context for properties of type java.lang.String that tells the install4j GUI to allow the user to enter multi-line strings in a separate dialog.
static java.lang.String CONTEXT_NON_SERVICE_LAUNCHER_ID
          Same as CONTEXT_LAUNCHER_ID, but service launchers are not selectable.
static java.lang.String CONTEXT_SERVICE_LAUNCHER_ID
          Same as CONTEXT_LAUNCHER_ID, but only service launchers are selectable.
 
Method Summary
static Install4JPropertyDescriptor create(java.lang.String propertyName, java.lang.Class beanClass, java.lang.String displayName, java.lang.String shortDescription)
          Same as create(String, Class, String, String, String) with a context of null.
static Install4JPropertyDescriptor create(java.lang.String propertyName, java.lang.Class beanClass, java.lang.String displayName, java.lang.String shortDescription, java.lang.String context)
          Create a property descriptor that can be passed to Install4JBeanInfo.addPropertyDescriptor(Install4JPropertyDescriptor).
 void setDisplayName(java.lang.String displayName)
           
 void setPropertyCategory(java.lang.String propertyCategory)
          Configures the property category.
 void setSortKey(java.lang.Integer sortKey)
          Set an integer key by which properties are sorted.
 
Methods inherited from class java.beans.PropertyDescriptor
createPropertyEditor, equals, getPropertyEditorClass, getPropertyType, getReadMethod, getWriteMethod, hashCode, isBound, isConstrained, setBound, setConstrained, setPropertyEditorClass, setReadMethod, setWriteMethod
 
Methods inherited from class java.beans.FeatureDescriptor
attributeNames, getDisplayName, getName, getShortDescription, getValue, isExpert, isHidden, isPreferred, setExpert, setHidden, setName, setPreferred, setShortDescription, setValue
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

ATTRIBUTE_PROPERTY_CATEGORY

public static final java.lang.String ATTRIBUTE_PROPERTY_CATEGORY
See Also:
setPropertyCategory(String), Constant Field Values

CATEGORY_CONFIGURATION

public static final java.lang.String CATEGORY_CONFIGURATION
Default category used by install4j.

See Also:
Constant Field Values

ATTRIBUTE_CONTEXT

public static final java.lang.String ATTRIBUTE_CONTEXT
See Also:
create(String, Class, String, String, String), Constant Field Values

CONTEXT_LAUNCHER_ID

public static final java.lang.String CONTEXT_LAUNCHER_ID
Special context for properties of type java.lang.String that tells the install4j GUI to treat the string value as the id of a launcher. In the property panel, a drop-down list of all defined launchers will be shown.

See Also:
Constant Field Values

CONTEXT_NON_SERVICE_LAUNCHER_ID

public static final java.lang.String CONTEXT_NON_SERVICE_LAUNCHER_ID
Same as CONTEXT_LAUNCHER_ID, but service launchers are not selectable.

See Also:
Constant Field Values

CONTEXT_SERVICE_LAUNCHER_ID

public static final java.lang.String CONTEXT_SERVICE_LAUNCHER_ID
Same as CONTEXT_LAUNCHER_ID, but only service launchers are selectable.

See Also:
Constant Field Values

CONTEXT_MULTILINE

public static final java.lang.String CONTEXT_MULTILINE
Special context for properties of type java.lang.String that tells the install4j GUI to allow the user to enter multi-line strings in a separate dialog.

See Also:
Constant Field Values

CONTEXT_DATETIME

public static final java.lang.String CONTEXT_DATETIME
Special context for properties of type java.util.Date that tells the install4j GUI to offer a time editor besides the default date editor as well.

See Also:
Constant Field Values

ATTRIBUTE_SORT_KEY

public static final java.lang.String ATTRIBUTE_SORT_KEY
See Also:
setSortKey(Integer), Constant Field Values
Method Detail

create

public static Install4JPropertyDescriptor create(java.lang.String propertyName,
                                                 java.lang.Class beanClass,
                                                 java.lang.String displayName,
                                                 java.lang.String shortDescription)
Same as create(String, Class, String, String, String) with a context of null.


create

public static Install4JPropertyDescriptor create(java.lang.String propertyName,
                                                 java.lang.Class beanClass,
                                                 java.lang.String displayName,
                                                 java.lang.String shortDescription,
                                                 java.lang.String context)
Create a property descriptor that can be passed to Install4JBeanInfo.addPropertyDescriptor(Install4JPropertyDescriptor).

Parameters:
propertyName - the name of the property
beanClass - the class of the bean that contains th property. Note:This is not the class of the property.
displayName - the display name of the property
shortDescription - a short description of the property
context - the context of the property. The context allows to specify different editors for the same property types. See the CONTEXT_* properties for the built-in contexts. This context is also used for enumerated properties in the EnumerationMapper. For properties of type String[], you can pass an item name as the context.
Returns:
the property descriptor

setPropertyCategory

public void setPropertyCategory(java.lang.String propertyCategory)
Configures the property category. In the install4j GUI, properties are grouped by their categories. If no category has been specified, the default "Configuration" category is used.

You can collapse certain categories by default with the Install4JBeanInfo.setCollapsedPropertyCategories(String[]) method.

Parameters:
propertyCategory - the category

setDisplayName

public void setDisplayName(java.lang.String displayName)
Overrides:
setDisplayName in class java.beans.FeatureDescriptor

setSortKey

public void setSortKey(java.lang.Integer sortKey)
Set an integer key by which properties are sorted. If no sort keys are specified, the properties will be sorted in the order they were added to the bean info.

Parameters:
sortKey - the sort key
See Also:
Install4JBeanInfo.addPropertyDescriptor(Install4JPropertyDescriptor)