LibreOffice
LibreOffice 25.8 SDK API Reference
Loading...
Searching...
No Matches
ErrorMessageDialog Service Referencepublished

provides a dialog for displaying database related exceptions. More...

import "ErrorMessageDialog.idl";

Inheritance diagram for ErrorMessageDialog:
XExecutableDialog XInterface

Public Member Functions

 create ([in] string initialTitle, [in] com::sun::star::awt::XWindow parentWindow, [in] any sqlException)
 allows initializing the dialog
Public Member Functions inherited from XExecutableDialog
void setTitle ([in] string aTitle)
 Sets the title of the dialog.
short execute ()
 Executes (shows) the dialog.
Public Member Functions inherited from XInterface
any queryInterface ([in] type aType)
 queries for a new interface to an existing UNO object.
void acquire ()
 increases the reference counter by one.
void release ()
 decreases the reference counter by one.

Detailed Description

provides a dialog for displaying database related exceptions.

If applications use any of the functionality provided in the modules com.sun.star::sdbc, com.sun.star::sdbcx and com.sun.star::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 com::sun::star::sdb::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

Member Function Documentation

◆ create()

create ( [in] string initialTitle,
[in] com::sun::star::awt::XWindow parentWindow,
[in] any sqlException )

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 com::sun::star::beans">XPropertySet::setPropertyValue() of the com::sun::star::beans::XPropertySet interface ...
allowed parameters are


The documentation for this service was generated from the following file: