service InteractionHandler in module com::sun::star::task:: |
service InteractionHandler;
An interaction request handler that lets the user handle a number of well known requests via GUI dialogs (and the com::sun::star::task::PasswordContainer service).
The well known requests handled by this service include com::sun::star::java::WrongJavaVersionException * , com::sun::star::sync2::BadPartnershipException * , com::sun::star::task::PasswordRequest , com::sun::star::ucb::AuthenticationRequest , com::sun::star::ucb::HandleCookiesRequest , com::sun::star::ucb::InteractiveAugmentedIOException * , com::sun::star::ucb::InteractiveCHAOSException * , com::sun::star::ucb::InteractiveFileIOException * , com::sun::star::ucb::InteractiveIOException * , com::sun::star::ucb::InteractiveNetworkConnectException * , com::sun::star::ucb::InteractiveNetworkException * , com::sun::star::ucb::InteractiveNetworkGeneralException * , com::sun::star::ucb::InteractiveNetworkOffLineException * , com::sun::star::ucb::InteractiveNetworkReadException * , com::sun::star::ucb::InteractiveNetworkResolveNameException * , com::sun::star::ucb::InteractiveNetworkWriteException * , and com::sun::star::ucb::InteractiveWrongMediumException * . The requests marked with an asterisk are only handled if (a) their continuations match certain restrictions (see below), and (b) the necessary resource strings are available (this can be exploited by applications that carry only a subset of all resource files with them).
The continuation restrictions are as follows: Let C be the subset of the provided continuations that are of type com::sun::star::task::XInteractionApprove , com::star::task::XInteractionDisapprove , com::star::task::XInteractionRetry , or com::star::task::XInteractionAbort (or of a derived type). All other continuations are ignored for these requests. The request is only handled if the set C is any of the following:
A com::sun::star::ucb::InteractiveAugmentedIOException carries with it a sequence of arguments, which should be com::sun::star::beans::PropertyValue s. The following details which properties are interpreted by the interaction handler, depending on the request's com::sun::star::ucb::IOErrorCode :
"Uri"
string
). "ResourceName"
string
) that might be more
meaningful to the user than the URI. For example, a
(platform-dependent) path notation for file system resources. "ResourceType"
string
). Currently understood values are
"volume"
(e.g., a file system volume) and
"folder"
(i.e., a resource that contains other
resources). "Removable"
boolean
). "Folder"
string
). "Volume"
and "OtherVolume"
string
s).Exported Interfaces |
Handle an interaction request.
Initialize the interaction handler.
The arguments must be a sequence of com::sun::star::beans::PropertyValue s. The currently supported properties are:
"Parent"
of type
com::sun::star::awt::XWindow denotes the parent
window for any GUI dialogs the interaction handler pops up; it is
strongly recommended that this property is supplied; "Context"
of type string
is a textual
description of the current context (used, e.g., as a first line of
text in error boxes); this property is optional.Copyright 2002 Sun Microsystems, Inc., 901 San Antonio Road, Palo Alto, CA 94303 USA.