service ErrorMessageDialog in module com::sun::star::sdb::

(Global Index)

Syntax

service ErrorMessageDialog;

Description

provides a dialog for displaying database related exceptions.

If applications use any of the functionality provided in the modules sdbc , sdbcx and sdb , they will - sooner or later - encounter SQLException 's.
These exceptions can be chained, so the information wrapped in one single SQLException can be rather complex (e.g., every instance where such an exception is passing before it is finally caught, could append a SQLContext to explain what it was doing), and they should be presented to the user in a consistent way.
This can be reached by using this service.

See also

com.sun.star.sdb.InteractionHandler

Exported Interfaces

com::sun::star::beans::XPropertySet

Description

allows access to the properties of the object


com::sun::star::ui::dialogs::XExecutableDialog

Description

allows starting execution of the dialog


com::sun::star::lang::XInitialization

Description

allows initializing the dialog

You do not need to call the initialize method directly, instead you may use the createInstanceWithArguments method of your XMultiServiceFactory .

You specify a parameter by passing one (or more) PropertyValue object(s) to the initialize method, where the Name field contains a string describing which aspect you want to affect, and the Value field containing a value.
Imagine the initialization values, as if you use XPropertySet::setPropertyValue() of the XPropertySet interface ...
allowed parameters are

  • Title
    String describing the initial title of the dialog. If not specified, a default title is used.
  • ParentWindow
    XWindow describing the parent window to use for the dialog.
  • SQLException
    SQLException describing the error which is beeing displayed.
    When initializing this value, you may use any derivative of SQLException .


Property Summary

Title the title of the (dialog) window

ParentWindow parent window to use for the dialog

SQLException is the exception displayed by the dialog

Property Details



Title

Syntax

string Title;

Description

the title of the (dialog) window


ParentWindow

Syntax

com::sun::star::awt::XWindow ParentWindow;

Description

parent window to use for the dialog

This property can't be set while the dialog is being displayed.


SQLException

Syntax

any SQLException;

Description

is the exception displayed by the dialog

This should contain a SQLException instance, or an instance of any class derived from this exception.

This property can't be set while the dialog is being displayed.

Top of Page