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
::com::sun::star::sdbc::SQLException
's.
These exceptions can be chained, so the information wrapped in one single
::com::sun::star::sdbc::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.
You do not need to call the initialize method directly, instead you may use the createInstanceWithArguments
method of your
::com::sun::star::lang::XMultiServiceFactory
.
You specify a parameter by passing one (or more)
::com::sun::star::beans::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
::com::sun::star::beans::XPropertySet
interface ...
allowed parameters are
Title
String describing the initial title of the dialog. If not specified, a default title is used.
ParentWindow
::com::sun::star::awt::XWindow
describing the parent window to use for the dialog.
SQLException
::com::sun::star::sdbc::SQLException
describing the error which is beeing displayed.
When initializing this value, you may use any derivative of
::com::sun::star::sdbc::SQLException
.
