provides a dialog for displaying database related exceptions. More...
import"ErrorMessageDialog.idl";
Public Member Functions | |
| create ([in] string initialTitle, [in] com::sun::star::awt::XWindow parentWindow, [in] any sqlException) | |
| allows initializing the dialog More... | |
 Public Member Functions inherited from XExecutableDialog | |
| void | setTitle ([in] string aTitle) |
| Sets the title of the dialog. More... | |
| short | execute () |
| Executes (shows) the dialog. More... | |
| Public Member Functions inherited from XInterface | |
| any | queryInterface ([in] type aType) |
| queries for a new interface to an existing UNO object. More... | |
| void | acquire () |
| increases the reference counter by one. More... | |
| void | release () |
| decreases the reference counter by one. More... | |
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.
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
-
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.
The documentation for this service was generated from the following file:
- com/sun/star/sdb/ErrorMessageDialog.idl
