Top   Module   Use   Manual   Index 
 INCLUDED SERVICES | EXPORTED INTERFACES | PROPERTIES' SUMMARY | PROPERTIES' DETAILS 

com :: sun :: star :: sdb ::

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 .


Properties' Summary

Title the title of the (dialog) window
ParentWindow parent window to use for the dialog
SQLException is the exception displayed by the dialog

Properties' Details

Title
 
string Title;
Description
the title of the (dialog) window
ParentWindow
 
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
 
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