Sophie

Sophie

distrib > Mandriva > current > i586 > media > main-updates > by-pkgid > fc480f9d5aabed8eeaffe8ad3401a94c > files > 5210

openoffice.org-devel-doc-3.2.1-0.3mdv2010.2.i586.rpm

<html>
<head>
<title>Service InteractionHandler</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="navimainnone">Use</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">Constructors' Summary</td>
<td class="navisub">Constructors' Details</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 InteractionHandler</td>
</tr>
<tr>
<td><dl>
<dt><b>Supported Interface</b></dt>
<dd>::com::sun::star::<a href="../task/module-ix.html">task</a>::<a href="../task/XInteractionHandler.html">XInteractionHandler</a></dd>
</dl>
</td>
</tr>
<tr>
<td><dl>
<dt><b>Description</b></dt>
<dd>is a service for user interaction for databases.
 </dd>
<dd><p>
 interaction requests that the handler can provide are:
 <ul>
 <li><b>database related errors</b><br/>
 The general structure to transport such errors is the 
 ::com::sun::star::<a href="../sdbc/module-ix.html">sdbc</a>::<a href="../sdbc/SQLException.html">SQLException</a>
 , and if your 
 ::com::sun::star::<a href="../task/module-ix.html">task</a>::<a href="../task/XInteractionRequest.html">XInteractionRequest</a>
 supplies such a 
 ::com::sun::star::<a href="../sdbc/module-ix.html">sdbc</a>::<a href="../sdbc/SQLException.html">SQLException</a>
 (or an instance of any derived class), 
 the handler will display a generic error dialog, which is able
 to travel the object chain which may be contained in the exception.
 </li>
 <li><b>authentication</b><br/>
 If your 
 ::com::sun::star::<a href="../task/module-ix.html">task</a>::<a href="../task/XInteractionRequest.html">XInteractionRequest</a>
 (see 
 ::com::sun::star::<a href="../task/module-ix.html">task</a>::<a href="../task/XInteractionHandler.html">XInteractionHandler</a>::<a href="../task/XInteractionHandler.html#handle">handle()</a>
 ) supplies a
 ::com::sun::star::<a href="../ucb/module-ix.html">ucb</a>::<a href="../ucb/AuthenticationRequest.html">AuthenticationRequest</a>
 , the handler will open a standard login
 dialog to allow user authentication.
 <br/>
 Besides the using the members of the AuthenticationRequest in the usual manner, the member <em>Server</em>
 (if not empty) is interpreted as datasource name, thus leading to a slightly different message when
 requesting the user to enter it's login data.
 <br/>
 In the case you want to use this authentication feature, you should supply a special authentication
 continuation (
 ::com::sun::star::<a href="../ucb/module-ix.html">ucb</a>::<a href="../ucb/XInteractionSupplyAuthentication.html">XInteractionSupplyAuthentication</a>
 ) as well, so the
 handler can return to you, the entered information.
 </li>
 <li><b>parameter requests</b><br/>
 If your 
 ::com::sun::star::<a href="../task/module-ix.html">task</a>::<a href="../task/XInteractionRequest.html">XInteractionRequest</a>
 supplies an
 <a href="ParametersRequest.html">ParametersRequest</a>
 , the handler will open a standard dialog asking
 the user to fill in parameter values.
 <br/>
 In the case you want to use this feature of the handler, you should supply a special continuation
 (
 <a href="XInteractionSupplyParameters.html">XInteractionSupplyParameters</a>
 ) as well, so the
 handler can return to you, the entered information.
 </li>
 </ul>
 </p>
</dd>
</dl>
</td>
</tr>
</table>
<hr>
<hr>
<br>&nbsp;<a href="#_top_">Top of Page</a><hr size="3"><p class="copyright" align="center">Copyright &copy; 2011, Oracle and/or its affiliates. All rights reserved. Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.</p>

</div> <!-- id="adc-idlref" -->
</body>

</html>