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

service ErrorMessageDialog
Supported Interface
::com::sun::star::ui::dialogs::XExecutableDialog
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 ::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.

See also
com.sun.star.sdb.InteractionHandler



Constructors' Summary
create allows initializing the dialog  
Constructors' Details
create
create( [in] string  initialTitle,
[in] ::com::sun::star::awt::XWindow  parentWindow,
[in] any  sqlException );

Description
allows initializing the dialog

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 being displayed.
    When initializing this value, you may use any derivative of ::com::sun::star::sdbc::SQLException .


 
Top of Page