addStatusAdapter

public void addStatusAdapter(
StatusAdapter statusAdapter,
                             boolean modal)

Adds a new StatusAdapter to the status adapters list in the dialog.

If the dialog is already visible, the status adapter will be shown immediately. Otherwise, the dialog with the added status adapter will show up, if all conditions below are false.

• the status adapter has IProgressConstants.NO_IMMEDIATE_ERROR_PROMPT_PROPERTY set to true

All not shown status adapters will be displayed as soon as the dialog shows up.

Parameters:

modal - true if the dialog should be modal, false otherwise

statusAdapter - the status adapter

enableDefaultSupportArea

public void enableDefaultSupportArea(boolean enable)

Enables the default support area that shows stack trace of the exception contained in the selected status.

Parameters:

enable - true enables, false disables default support

getStatusAdapters

public 
Collection getStatusAdapters()

Gets a collection of status adapters that were passed to the dialog.

Returns:

collection of StatusAdapter objects

setDetailsAreaProvider

public void setDetailsAreaProvider(
AbstractStatusAreaProvider provider)

Sets the details area provider. If null is set, the default area provider will be used.

Parameters:

provider - A details area provider to be set.

setStatusListLabelProvider

public void setStatusListLabelProvider(
ITableLabelProvider labelProvider)

Deprecated. As of 3.5 setMessageDecorator(org.eclipse.jface.viewers.ILabelDecorator) is recommended.

Sets new label provider for the status list. This label provider is used also to display the second message on the dialog if only one status is available.

This method is no longer recommended to use as it is impossible to achieve consistent behavior after changing only one label provider.

Parameters:

labelProvider - a label provider to be used when displaying status adapters.

setSupportAreaProvider

public void setSupportAreaProvider(
AbstractStatusAreaProvider provider)

Sets the support provider. The policy for choosing support provider is:

1. use the support provider set by this method, if set
2. use the support provider set in JFace Policy, if set
3. use the default support area, if enabled

Parameters:

provider - Support provider to be set.

setMessageDecorator

public void setMessageDecorator(
ILabelDecorator decorator)

This methods sets up the decorator, which is used to modify displayed strings extracted from StatusAdapter. The decorator should be used to remove technical codes from the dialog, f.e. following message "ERR2008 Invalid password" can be translated into "Invalid password".

The decorator will be applied only to messages extracted from StatusAdapter (predefined messages like "This status has children statuses. See 'Details' for more information." are not affected.

This method should not be used together with setStatusListLabelProvider(ITableLabelProvider).

Parameters:

decorator - - the decorator to be set. Only ILabelDecorator.decorateText(String, Object) method will be used. This method should return null if and only if the first argument is null. StatusAdapter is passed as second parameter. Other methods should have default behavior as they may be used in future versions of the dialog.

Since:

3.5

setProperty

public void setProperty(
Object key,
                        
Object value)

This method sets various properties on the manager.

Parameters:

key - a key of the property to be set.

value - a value of the property to be set. The value must be of type specified by the property key. null should never be passed unless the property key javadoc allows for that.

Since:

3.5

getProperty

public 
Object getProperty(
Object key)

This method gets various dialog properties.

Parameters:

key - a key of the property to be get.

Returns:

a value of the property. The value will be of type specified by the property key. null can be returned.

Since:

3.5

enableErrorDialogCompatibility

public void enableErrorDialogCompatibility()

This method makes the dialog to be similar to the JFace ErrorDialog. The dialog handles StatusAdapters wrapping IStatus with severity IStatus.OK, does not display the link to the error log, does not display the link to the support area but always opens it.

Since:

3.5

See Also:

ErrorDialog