See Also:

IPropertySource.getPropertyDescriptors()

Method Summary
CellEditor	createPropertyEditor ( Composite parent)           Creates and returns a new cell editor for editing this property.
String	getCategory ()           Returns the name of the category to which this property belongs.
String	getDescription ()           Returns a brief description of this property.
String	getDisplayName ()           Returns the display name for this property.
String[]	getFilterFlags ()           Returns a list of filter types to which this property belongs.
Object	getHelpContextIds ()           Returns the help context id for this property or null if this property has no help context id.
Object	getId ()           Returns the id for this property.
ILabelProvider	getLabelProvider ()           Returns the label provider for this property.
boolean	isCompatibleWith ( IPropertyDescriptor anotherProperty)           Returns whether this property descriptor and the given one are compatible.

 

Method Detail

createPropertyEditor

CellEditor createPropertyEditor(
Composite parent)

Creates and returns a new cell editor for editing this property. Returns null if the property is not editable.

Parameters:

parent - the parent widget for the cell editor

Returns:

the cell editor for this property, or null if this property cannot be edited

getCategory

String getCategory()

Returns the name of the category to which this property belongs. Properties belonging to the same category are grouped together visually. This localized string is shown to the user

Returns:

the category name, or null if the default category is to be used

getDescription

String getDescription()

Returns a brief description of this property. This localized string is shown to the user when this property is selected.

Returns:

a brief description, or null if none

getDisplayName

String getDisplayName()

Returns the display name for this property. This localized string is shown to the user as the name of this property.

Returns:

a displayable name

getFilterFlags

String[] getFilterFlags()

Returns a list of filter types to which this property belongs. The user is able to toggle the filters to show/hide properties belonging to a filter type.

Valid values for these flags are declared as constants on IPropertySheetEntry

Returns:

a list of filter types to which this property belongs, or null if none

getHelpContextIds

Object getHelpContextIds()

Returns the help context id for this property or null if this property has no help context id.

NOTE: Help support system API's changed since 2.0 and arrays of contexts are no longer supported.

Thus the only valid non-null return type for this method is a String representing a context id. The previously valid return types are deprecated. The plural name for this method is unfortunate.

Returns:

the help context id for this entry

getId

Object getId()

Returns the id for this property. This object is used internally to distinguish one property descriptor from another.

Returns:

the property id

getLabelProvider

ILabelProvider getLabelProvider()

Returns the label provider for this property. The label provider is used to obtain the text (and possible image) for displaying the value of this property.

Returns:

the label provider used to display this property

isCompatibleWith

boolean isCompatibleWith(
IPropertyDescriptor anotherProperty)

Returns whether this property descriptor and the given one are compatible.

The property sheet uses this method during multiple selection to determine whether two property descriptors with the same id are in fact the same property and can be displayed as a single entry in the property sheet.

Parameters:

anotherProperty - the other property descriptor

Returns:

true if the property descriptors are compatible, and false otherwise