2 * AT-SPI - Assistive Technology Service Provider Interface
3 * (Gnome Accessibility Project; http://developer.gnome.org/projects/gap)
5 * Copyright 2001 Sun Microsystems Inc.
7 * This library is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Library General Public
9 * License as published by the Free Software Foundation; either
10 * version 2 of the License, or (at your option) any later version.
12 * This library is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Library General Public License for more details.
17 * You should have received a copy of the GNU Library General Public
18 * License along with this library; if not, write to the
19 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
20 * Boston, MA 02111-1307, USA.
23 #include <Bonobo_Unknown.idl>
25 #ifndef _ACCESSIBILITY_LOGIN_HELPER_IDL_
26 #define _ACCESSIBILITY_LOGIN_HELPER_IDL_
28 module Accessibility {
30 interface LoginHelper : Bonobo::Unknown {
36 typedef sequence<WindowInfo> WindowList;
52 typedef sequence<DeviceReq> DeviceReqList;
57 * Request a LoginHelper to enter "safe" mode, or
58 * inform LoginHelper that "safe" mode may be exited.
59 * If @safe_mode is %TRUE, but the return value is %FALSE,
60 * the requesting client may wish to deny services to the
61 * %LoginHelper, for instance avoid raising its toplevels.
63 * Returns: whether the %LoginHelper is now "safe" or not.
65 boolean setSafe (in boolean safe_mode);
70 * Query a @LoginHelper for the types of
71 * device I/O it requires, in order to do its job.
72 * For instance, a @LoginHelper which needs to receive keyboard
74 * Accessibility_LoginHelper_CORE_KEYBOARD in this list.
76 * Returns: A sequence of @LoginHelper_DeviceFlags indicating
77 * the device I/O required.
79 DeviceReqList getDeviceReqs ();
84 * Get a list of window IDs that need raising on login.
86 * Returns: a sequence containing window IDS for toplevels which
87 * need to be raised/made visible during user authentication.
89 WindowList getRaiseWindows ();
94 * placeholders for future expansion.
96 void unImplemented ();
97 void unImplemented2 ();
98 void unImplemented3 ();
99 void unImplemented4 ();