Follow Techotopia on Twitter

On-line Guides
All Guides
eBook Store
iOS / Android
Linux for Beginners
Office Productivity
Linux Installation
Linux Security
Linux Utilities
Linux Virtualization
Linux Kernel
System/Network Admin
Programming
Scripting Languages
Development Tools
Web Development
GUI Toolkits/Desktop
Databases
Mail Systems
openSolaris
Eclipse Documentation
Techotopia.com
Virtuatopia.com

How To Guides
Virtualization
General System Admin
Linux Security
Linux Filesystems
Web Servers
Graphics & Desktop
PC Hardware
Windows
Problem Solutions
Privacy Policy

  




 

 


Eclipse Platform
Release 3.5

org.eclipse.ui.views.properties
Class PropertySheetEntry

java.lang.Object
  extended by 

org.eclipse.core.commands.common.EventManager
      extended by 
org.eclipse.ui.views.properties.PropertySheetEntry
All Implemented Interfaces:
IPropertySheetEntry

public class PropertySheetEntry
extends EventManager
implements IPropertySheetEntry

PropertySheetEntry is an implementation of IPropertySheetEntry which uses IPropertySource and IPropertyDescriptor to interact with domain model objects.

Every property sheet entry has a single descriptor (except the root entry which has none). This descriptor determines what property of its objects it will display/edit.

Entries do not listen for changes in their objects. Since there is no restriction on properties being independent, a change in one property may affect other properties. The value of a parent's property may also change. As a result we are forced to refresh the entire entry tree when a property changes value.

Since:
3.0 (was previously internal)

Field Summary
 
Fields inherited from interface org.eclipse.ui.views.properties. IPropertySheetEntry
FILTER_ID_EXPERT
 
Constructor Summary
PropertySheetEntry ()
           
 
Method Summary
 void addPropertySheetEntryListener ( IPropertySheetEntryListener listener)
          Adds the given listener to this entry's collection of listeners.
 void applyEditorValue ()
          Apply the current cell editor value.
protected   PropertySheetEntry createChildEntry ()
          Factory method to create a new child PropertySheetEntry instance.
 void dispose ()
          Called when the entry is no longer needed
  String getCategory ()
          Returns the entry's category.
  IPropertySheetEntry[] getChildEntries ()
          Returns the child entries for this entry.
  String getDescription ()
          Return a short description of the property sheet entry.
protected   IPropertyDescriptor getDescriptor ()
          Returns the descriptor for this entry.
  String getDisplayName ()
          Returns the name used to display the property.
  CellEditor getEditor ( Composite parent)
          Return the CellEditor used to edit the property.
protected   Object getEditValue (int index)
          Returns the edit value for the object at the given index.
  String getErrorText ()
          Returns the error text to display if the value is invalid.
  String[] getFilters ()
          Return the filter ids used to group entries into levels such as Expert.
  Object getHelpContextIds ()
          Returns the help context id for this entry, or null if this entry has no help context id.
  Image getImage ()
          Returns the image for the property value, if there is one.
protected   PropertySheetEntry getParent ()
          Returns the parent of this entry.
protected   IPropertySource getPropertySource ( Object object)
          Returns an property source for the given object.
  String getValueAsString ()
          Returns the value of the objects expressed as a String.
  Object[] getValues ()
          Returns the value objects of this entry.
 boolean hasChildEntries ()
          Returns true if the entry has children.
protected  void refreshFromRoot ()
          Refresh the entry tree from the root down.
 void removePropertySheetEntryListener ( IPropertySheetEntryListener listener)
          Removes the given listener from this entry's collection of listeners.
 void resetPropertyValue ()
          Resets the property value to its default value if it has been changed.
 void setPropertySourceProvider ( IPropertySourceProvider provider)
          Sets a property source provider for this entry.
 void setValues ( Object[] objects)
          The PropertySheetEntry implmentation of this method declared onIPropertySheetEntry will obtain an editable value for the given objects and update the child entries.
protected  void valueChanged ( PropertySheetEntry child)
          The value of the given child entry has changed.
 
Methods inherited from class org.eclipse.core.commands.common. EventManager
addListenerObject, clearListeners, getListeners, isListenerAttached, removeListenerObject
 
Methods inherited from class java.lang. Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

PropertySheetEntry

public PropertySheetEntry()
Method Detail

addPropertySheetEntryListener

public void addPropertySheetEntryListener(
IPropertySheetEntryListener listener)
Description copied from interface: IPropertySheetEntry
Adds the given listener to this entry's collection of listeners.

Specified by:
addPropertySheetEntryListener in interface IPropertySheetEntry
Parameters:
listener - the listener to add

applyEditorValue

public void applyEditorValue()
Description copied from interface: IPropertySheetEntry
Apply the current cell editor value.

Specified by:
applyEditorValue in interface IPropertySheetEntry

createChildEntry

protected 
PropertySheetEntry createChildEntry()
Factory method to create a new child PropertySheetEntry instance.

Subclasses may overwrite to create new instances of their own class.

Returns:
a new PropertySheetEntry instance for the descriptor passed in
Since:
3.1

dispose

public void dispose()
Description copied from interface: IPropertySheetEntry
Called when the entry is no longer needed

Specified by:
dispose in interface IPropertySheetEntry

getCategory

public 
String getCategory()
Description copied from interface: IPropertySheetEntry
Returns the entry's category.

Specified by:
getCategory in interface IPropertySheetEntry
Returns:
the entry's category

getChildEntries

public 
IPropertySheetEntry[] getChildEntries()
Description copied from interface: IPropertySheetEntry
Returns the child entries for this entry.

Specified by:
getChildEntries in interface IPropertySheetEntry
Returns:
the child entries for this entry

getDescription

public 
String getDescription()
Description copied from interface: IPropertySheetEntry
Return a short description of the property sheet entry. Typically this description is shown in a status line when the entry is selected.

Specified by:
getDescription in interface IPropertySheetEntry
Returns:
the entry's description

getDescriptor

protected 
IPropertyDescriptor getDescriptor()
Returns the descriptor for this entry.

Returns:
the descriptor for this entry
Since:
3.1 (was previously private)

getDisplayName

public 
String getDisplayName()
Description copied from interface: IPropertySheetEntry
Returns the name used to display the property.

Specified by:
getDisplayName in interface IPropertySheetEntry
Returns:
the name used to display the property

getEditor

public 
CellEditor getEditor(
Composite parent)
Description copied from interface: IPropertySheetEntry
Return the CellEditor used to edit the property.

Specified by:
getEditor in interface IPropertySheetEntry
Parameters:
parent - the parent widget for the editor
Returns:
the CellEditor used to edit the property

getEditValue

protected 
Object getEditValue(int index)
Returns the edit value for the object at the given index.

Parameters:
index - the value object index
Returns:
the edit value for the object at the given index

getErrorText

public 
String getErrorText()
Description copied from interface: IPropertySheetEntry
Returns the error text to display if the value is invalid.

Specified by:
getErrorText in interface IPropertySheetEntry
Returns:
the error text to display when the value is invalid or null

getFilters

public 
String[] getFilters()
Description copied from interface: IPropertySheetEntry
Return the filter ids used to group entries into levels such as Expert. Valid values are defined as constants on this interface.

Specified by:
getFilters in interface IPropertySheetEntry
Returns:
the filter ids used to group entries into levels such as Expert.

getHelpContextIds

public 
Object getHelpContextIds()
Description copied from interface: IPropertySheetEntry
Returns the help context id for this entry, or null if this entry 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.

Specified by:
getHelpContextIds in interface IPropertySheetEntry
Returns:
the help context id for this entry

getImage

public 
Image getImage()
Description copied from interface: IPropertySheetEntry
Returns the image for the property value, if there is one. This image is managed by the entry it came from. Callers of this method must never dispose the returned image.

Specified by:
getImage in interface IPropertySheetEntry
Returns:
the image for this property value or null

getParent

protected 
PropertySheetEntry getParent()
Returns the parent of this entry.

Returns:
the parent entry, or null if it has no parent
Since:
3.1

getPropertySource

protected 
IPropertySource getPropertySource(
Object object)
Returns an property source for the given object.

Parameters:
object - an object for which to obtain a property source or null if a property source is not available
Returns:
an property source for the given object
Since:
3.1 (was previously private)

getValueAsString

public 
String getValueAsString()
Description copied from interface: IPropertySheetEntry
Returns the value of the objects expressed as a String.

Specified by:
getValueAsString in interface IPropertySheetEntry
Returns:
the value of the objects expressed as a String

getValues

public 
Object[] getValues()
Returns the value objects of this entry.

Returns:
the value objects of this entry
Since:
3.1 (was previously private)

hasChildEntries

public boolean hasChildEntries()
Description copied from interface: IPropertySheetEntry
Returns true if the entry has children.

Specified by:
hasChildEntries in interface IPropertySheetEntry
Returns:
true if the entry has children

refreshFromRoot

protected void refreshFromRoot()
Refresh the entry tree from the root down.

Since:
3.1 (was previously private)

removePropertySheetEntryListener

public void removePropertySheetEntryListener(
IPropertySheetEntryListener listener)
Description copied from interface: IPropertySheetEntry
Removes the given listener from this entry's collection of listeners.

Specified by:
removePropertySheetEntryListener in interface IPropertySheetEntry
Parameters:
listener - the listener to remove

resetPropertyValue

public void resetPropertyValue()
Description copied from interface: IPropertySheetEntry
Resets the property value to its default value if it has been changed.

Does nothing if the notion of a default value is not meaningful for the property.

Specified by:
resetPropertyValue in interface IPropertySheetEntry

setPropertySourceProvider

public void setPropertySourceProvider(
IPropertySourceProvider provider)
Sets a property source provider for this entry. This provider is used to obtain an IPropertySource for each of this entries objects. If no provider is set then a default provider is used.

Parameters:
provider - IPropertySourceProvider

setValues

public void setValues(
Object[] objects)
The PropertySheetEntry implmentation of this method declared onIPropertySheetEntry will obtain an editable value for the given objects and update the child entries.

Updating the child entries will typically call this method on the child entries and thus the entire entry tree is updated

Specified by:
setValues in interface IPropertySheetEntry
Parameters:
objects - the new values for this entry

valueChanged

protected void valueChanged(
PropertySheetEntry child)
The value of the given child entry has changed. Therefore we must set this change into our value objects.

We must inform our parent so that it can update its value objects

Subclasses may override to set the property value in some custom way.

Parameters:
child - the child entry that changed its value

Eclipse Platform
Release 3.5

Guidelines for using Eclipse APIs.

Copyright (c) Eclipse contributors and others 2000, 2008. All rights reserved.


 
 
  Published under the terms of the Eclipse Public License Version 1.0 ("EPL") Design by Interspire