<html> <head> <title>Service ErrorMessageDialog</title> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <link rel="stylesheet" type="text/css" href="../../../../idl.css"> </head> <body> <div id="adc-idlref"> <a name="_top_"> </a><table class="navimain" border="0" cellpadding="3"> <tr> <td class="navimain"><a href="../module-ix.html" class="navimain">Overview</a></td> <td class="navimain"><a href="module-ix.html" class="navimain">Module</a></td> <td class="navimain"><a href="ErrorMessageDialog-xref.html" class="navimain">Use</a></td> <td class="navimainnone">Devguide</td> <td class="navimain"><a href="../../../../index-files/index-1.html" class="navimain">Index</a></td> </tr> </table> <table class="navisub" border="0" cellpadding="0"> <tr> <td class="navisub">Included Services</td> <td class="navisub"><a href="#ExportedInterfaces" class="navisub">Exported Interfaces</a></td> <td class="navisub"><a href="#PropertiesSummary" class="navisub">Properties' Summary</a></td> <td class="navisub"><a href="#PropertiesDetails" class="navisub">Properties' Details</a></td> </tr> </table> <hr> <table border="0" width="100%" cellpadding="5" cellspacing="3" class="title-table" style="margin-bottom:6pt;"> <tr> <td><p class="namechain"><a href="../../../../module-ix.html" class="namechain">::</a> <a href="../../../module-ix.html" class="namechain">com</a> :: <a href="../../module-ix.html" class="namechain">sun</a> :: <a href="../module-ix.html" class="namechain">star</a> :: <a href="module-ix.html" class="namechain">sdb</a> :: </p> </td> </tr> <tr> <td class="title">service ErrorMessageDialog</td> </tr> <tr> <td><dl> <dt><b>Description</b></dt> <dd>provides a dialog for displaying database related exceptions. </dd> <dd><p> If applications use any of the functionality provided in the modules <module scope="com.sun.star"> sdbc </module> , <module scope="com.sun.star"> sdbcx </module> and <module scope="com.sun.star"> sdb </module> , they will - sooner or later - encounter ::com::sun::star::<a href="../sdbc/module-ix.html">sdbc</a>::<a href="../sdbc/SQLException.html">SQLException</a> 's. <br/> These exceptions can be chained, so the information wrapped in one single ::com::sun::star::<a href="../sdbc/module-ix.html">sdbc</a>::<a href="../sdbc/SQLException.html">SQLException</a> can be rather complex (e.g., every instance where such an exception is passing before it is finally caught, could append a <a href="SQLContext.html">SQLContext</a> to explain what it was doing), and they should be presented to the user in a consistent way. <br/> This can be reached by using this service. </dd> <dt><b>See also</b></dt> <dd><a href="ErrorMessageDialog.html#com.sun.star.sdb.InteractionHandler">com.sun.star.sdb.InteractionHandler</a><br> </p> </dd> </dl> </td> </tr> </table> <hr> <a name="ExportedInterfaces"/><table border="1" width="100%" cellpadding="5" cellspacing="0" class="subtitle"> <tr> <td class="subtitle" colspan="2">Exported Interfaces</td> </tr> <tr> <td class="imsum_left">::com::sun::star::<a href="../beans/module-ix.html">beans</a>::<a href="../beans/XPropertySet.html">XPropertySet</a></td> <td class="imsum_right"><dl> <dt><b>Description</b></dt> <dd>allows access to the properties of the object </dd> </dl> </td> </tr> <tr> <td class="imsum_left">::com::sun::star::ui::<a href="../ui/dialogs/module-ix.html">dialogs</a>::<a href="../ui/dialogs/XExecutableDialog.html">XExecutableDialog</a></td> <td class="imsum_right"><dl> <dt><b>Description</b></dt> <dd>allows starting execution of the dialog </dd> </dl> </td> </tr> <tr> <td class="imsum_left">::com::sun::star::<a href="../lang/module-ix.html">lang</a>::<a href="../lang/XInitialization.html">XInitialization</a></td> <td class="imsum_right"><dl> <dt><b>Description</b></dt> <dd>allows initializing the dialog </dd> <dd><p> You do not need to call the initialize method directly, instead you may use the createInstanceWithArguments method of your ::com::sun::star::<a href="../lang/module-ix.html">lang</a>::<a href="../lang/XMultiServiceFactory.html">XMultiServiceFactory</a> . </p> <p> You specify a parameter by passing one (or more) ::com::sun::star::<a href="../beans/module-ix.html">beans</a>::<a href="../beans/PropertyValue.html">PropertyValue</a> object(s) to the initialize method, where the <em>Name</em> field contains a string describing which aspect you want to affect, and the <em>Value</em> field containing a value. <br/> Imagine the initialization values, as if you use <method scope="com::sun::star::beans">XPropertySet::setPropertyValue() </method> of the ::com::sun::star::<a href="../beans/module-ix.html">beans</a>::<a href="../beans/XPropertySet.html">XPropertySet</a> interface ... <br/> allowed parameters are <ul> <li><b>Title</b><br/> String describing the initial title of the dialog. If not specified, a default title is used. </li> <li><b>ParentWindow</b><br/> ::com::sun::star::<a href="../awt/module-ix.html">awt</a>::<a href="../awt/XWindow.html">XWindow</a> describing the parent window to use for the dialog. </li> <li><b>SQLException</b><br/> ::com::sun::star::<a href="../sdbc/module-ix.html">sdbc</a>::<a href="../sdbc/SQLException.html">SQLException</a> describing the error which is beeing displayed.<br/> When initializing this value, you may use any derivative of ::com::sun::star::<a href="../sdbc/module-ix.html">sdbc</a>::<a href="../sdbc/SQLException.html">SQLException</a> . </li> </ul> </p> </dd> </dl> </td> </tr> </table> <a name="PropertiesSummary"/><table border="1" width="100%" cellpadding="5" cellspacing="0" class="subtitle"> <tr> <td class="subtitle" colspan="2">Properties' Summary</td> </tr> <tr> <td class="imsum_left">string<br> <a href="#Title">Title</a></td> <td class="imsum_right">the title of the (dialog) window </td> </tr> <tr> <td class="imsum_left">::com::sun::star::<a href="../awt/module-ix.html">awt</a>::<a href="../awt/XWindow.html">XWindow</a><br> <a href="#ParentWindow">ParentWindow</a></td> <td class="imsum_right">parent window to use for the dialog </td> </tr> <tr> <td class="imsum_left">any<br> <a href="#SQLException">SQLException</a></td> <td class="imsum_right">is the exception displayed by the dialog </td> </tr> </table> <a name="PropertiesDetails"/><table border="1" width="100%" cellpadding="5" cellspacing="0" class="subtitle"> <tr> <td class="subtitle">Properties' Details</td> </tr> <tr> <td class="imdetail"><a name="Title" class="membertitle">Title</a><table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-data" bgcolor="#ffffff" align="center"> <tr> <td>string <b>Title</b>;<hr> <dl> <dt><b>Description</b></dt> <dd>the title of the (dialog) window </dd> </dl> </td> </tr> </table> </td> </tr> <tr> <td class="imdetail"><a name="ParentWindow" class="membertitle">ParentWindow</a><table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-data" bgcolor="#ffffff" align="center"> <tr> <td>::com::sun::star::<a href="../awt/module-ix.html">awt</a>::<a href="../awt/XWindow.html">XWindow</a> <b>ParentWindow</b>;<hr> <dl> <dt><b>Description</b></dt> <dd>parent window to use for the dialog </dd> <dd><p> This property can't be set while the dialog is being displayed. </p> </dd> </dl> </td> </tr> </table> </td> </tr> <tr> <td class="imdetail"><a name="SQLException" class="membertitle">SQLException</a><table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-data" bgcolor="#ffffff" align="center"> <tr> <td>any <b>SQLException</b>;<hr> <dl> <dt><b>Description</b></dt> <dd>is the exception displayed by the dialog </dd> <dd><p> This should contain a ::com::sun::star::<a href="../sdbc/module-ix.html">sdbc</a>::<a href="../sdbc/SQLException.html">SQLException</a> instance, or an instance of any class derived from this exception. </p> <p> This property can't be set while the dialog is being displayed. </p> </dd> </dl> </td> </tr> </table> </td> </tr> </table> <br> <a href="#_top_">Top of Page</a><hr size="3"><p class="copyright" align="center">Copyright © 2008 Sun Microsystems, Inc.</p> </div> <!-- id="adc-idlref" --> </body> </html>