Interface IProgressConstants
- All Known Subinterfaces:
IProgressConstants2
The four constants define property keys that are used to associate UI related
information with Jobs (org.eclipse.core.runtime.jobs.Job
).
- Since:
- 3.0
- See Also:
-
Field Summary
Modifier and TypeFieldDescriptionstatic final QualifiedName
This property is used to associate anIAction
with a Job.static final QualifiedName
This property is used to associate anImageDescriptor
with a Job.static final QualifiedName
This property provides a hint to the progress UI to keep Jobs in the UI after they have finished.static final QualifiedName
The KEEPONE_PROPERTY is an extension to the KEEP_PROPERTY, that provides a hint to the progress UI to ensure that only a single Job of a Job family is kept in the set of kept Jobs.static final QualifiedName
This property provides a hint to the progress UI to not prompt on errors immediately but instead make the errors available through the progress UI.static final String
Constant for the progress view id.static final QualifiedName
This is a property set on a user job if the user has not decided to run the job in the background.static final String
Common prefix for properties defined in this interface.
-
Field Details
-
PROPERTY_PREFIX
Common prefix for properties defined in this interface.- See Also:
-
KEEP_PROPERTY
This property provides a hint to the progress UI to keep Jobs in the UI after they have finished. This can be used to communicate results of a Job back to the user.The property must be of type
Boolean
and the hint is used if its value istrue
. -
KEEPONE_PROPERTY
The KEEPONE_PROPERTY is an extension to the KEEP_PROPERTY, that provides a hint to the progress UI to ensure that only a single Job of a Job family is kept in the set of kept Jobs. That is, whenever a Job that has the KEEPONE_PROPERTY starts or finishes, all other kept Jobs of the same family are removed first.Membership to family is determined using a Job's
belongsTo
method. The progress service will pass each job that currently exists in the view to thebelongsTo
method of a newly added job. Clients who set theKEEPONE_PROPERTY
must implement abelongsTo
method that determines if the passed job is of the same family as their job and returntrue
if it is.Please note that other Jobs of the same family are only removed if they have finished. Non finished jobs of the same family are left alone.
-
ACTION_PROPERTY
This property is used to associate anIAction
with a Job. If the Job is shown in the UI, the action might be represented as a button or hyper link to allow the user to trigger a job specific action, like showing the Job's results.The progress UI will track the enabled state of the action and its tooltip text.
If the action implements
ActionFactory.IWorkbenchAction
, itsdispose
method will be called as soon as the Job is finally removed from the set of kept jobs.Note: Only one of
ACTION_PROPERTY
orCOMMAND_PROPERTY
should be used- See Also:
-
ICON_PROPERTY
This property is used to associate anImageDescriptor
with a Job. If the Job is shown in the UI, this descriptor is used to create an icon that represents the Job.Please note, that this property is only used if no
ImageDescriptor
has been registered for the Job family with theIProgressService
.- See Also:
-
PROGRESS_VIEW_ID
Constant for the progress view id.- See Also:
-
PROPERTY_IN_DIALOG
This is a property set on a user job if the user has not decided to run the job in the background. The value is set totrue
when the job starts and set tofalse
if the user subsequently decides to complete the job in the background.This property is not intended to be set by clients.
- See Also:
-
NO_IMMEDIATE_ERROR_PROMPT_PROPERTY
This property provides a hint to the progress UI to not prompt on errors immediately but instead make the errors available through the progress UI.The property must be of type
Boolean
and the hint is used if its value istrue
.- Since:
- 3.1
-