Overview | Module | Use | Devguide | Index

Included Services | Exported Interfaces | Properties' Summary | Properties' Details

:: com :: sun :: star :: sdb ::
service InteractionHandler
Description is a service for user interaction for databases. interaction requests that the handler can provide are: database related errors The general structure to transport such errors is the ::com::sun::star::sdbc::SQLException , and if your ::com::sun::star::task::XInteractionRequest supplies such a ::com::sun::star::sdbc::SQLException (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. authentication If your ::com::sun::star::task::XInteractionRequest (see ::com::sun::star::task::XInteractionHandler::handle() ) supplies a ::com::sun::star::ucb::AuthenticationRequest , the handler will open a standard login dialog to allow user authentication. Besides the using the members of the AuthenticationRequest in the usual manner, the member Server (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. In the case you want to use this authentication feature, you should supply a special authentication continuation ( ::com::sun::star::ucb::XInteractionSupplyAuthentication ) as well, so the handler can return to you, the entered information. parameter requests If your ::com::sun::star::task::XInteractionRequest supplies an ParametersRequest , the handler will open a standard dialog asking the user to fill in parameter values. In the case you want to use this feature of the handler, you should supply a special continuation ( XInteractionSupplyParameters ) as well, so the handler can return to you, the entered information.

Exported Interfaces
::com::sun::star::task::XInteractionHandler | Description handles interaction requests

Top of Page

Copyright © 2003 Sun Microsystems, Inc.