:: com :: sun :: star :: sdb ::

service InteractionHandler
Supported Interface
::com::sun::star::task::XInteractionHandler
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 ::com::sun::star::sdb::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 ( ::com::sun::star::sdb::XInteractionSupplyParameters ) as well, so the handler can return to you, the entered information.




 Top of Page