X-Git-Url: http://review.tizen.org/git/?a=blobdiff_plain;f=cspi%2Fspi_action.c;h=7136b45fb7f6f32678aa66adfa151591aaa5b8dc;hb=4946775a4aa19df13d8950f0c5e0fb438546bc84;hp=9ce42a79a720b909002f3a4177e12ba5759a5143;hpb=d35cd400a36b0f1393c17ce47015bf753327ccae;p=platform%2Fcore%2Fuifw%2Fat-spi2-atk.git diff --git a/cspi/spi_action.c b/cspi/spi_action.c index 9ce42a7..7136b45 100644 --- a/cspi/spi_action.c +++ b/cspi/spi_action.c @@ -1,3 +1,26 @@ +/* + * AT-SPI - Assistive Technology Service Provider Interface + * (Gnome Accessibility Project; http://developer.gnome.org/projects/gap) + * + * Copyright 2001, 2002 Sun Microsystems Inc., + * Copyright 2001, 2002 Ximian, Inc. + * + * This library is free software; you can redistribute it and/or + * modify it under the terms of the GNU Library General Public + * License as published by the Free Software Foundation; either + * version 2 of the License, or (at your option) any later version. + * + * This library is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + * Library General Public License for more details. + * + * You should have received a copy of the GNU Library General Public + * License along with this library; if not, write to the + * Free Software Foundation, Inc., 59 Temple Place - Suite 330, + * Boston, MA 02111-1307, USA. + */ + #include /** @@ -5,9 +28,6 @@ * @obj: a pointer to the #AccessibleAction on which to operate. * * Increment the reference count for an #AccessibleAction. - * - * Returns: 0 (no return code implemented yet). - * **/ void AccessibleAction_ref (AccessibleAction *obj) @@ -20,9 +40,6 @@ AccessibleAction_ref (AccessibleAction *obj) * @obj: a pointer to the #AccessibleAction on which to operate. * * Decrement the reference count for an #AccessibleAction. - * - * Returns: 0 (no return code implemented yet). - * **/ void AccessibleAction_unref (AccessibleAction *obj) @@ -37,15 +54,20 @@ AccessibleAction_unref (AccessibleAction *obj) * Get the number of actions invokable on an #AccessibleAction implementor. * * Returns: a #long integer indicatin the number of invokable actions. - * **/ long AccessibleAction_getNActions (AccessibleAction *obj) { - return (long) - Accessibility_Action__get_nActions (CSPI_OBJREF (obj), cspi_ev ()); -} + dbus_int32_t retval; + + cspi_return_val_if_fail (obj != NULL, -1); + cspi_dbus_get_property (obj, spi_interface_action, "nActions", NULL, "i", &retval); + + cspi_return_val_if_ev ("getNActions", -1); + + return retval; +} /** * AccessibleAction_getDescription: @@ -56,16 +78,20 @@ AccessibleAction_getNActions (AccessibleAction *obj) * object implementing #AccessibleAction. * * Returns: a UTF-8 string describing the '@i-th' invokable action. - * **/ char * AccessibleAction_getDescription (AccessibleAction *obj, - long int i) + long int i) { - return (char *) - Accessibility_Action_getDescription (CSPI_OBJREF (obj), - (CORBA_long) i, - cspi_ev ()); + dbus_int32_t d_i = i; + char *retval; + cspi_return_val_if_fail (obj != NULL, NULL); + + cspi_dbus_call (obj, spi_interface_action, "getDescription", NULL, "i=>s", d_i, &retval); + + cspi_return_val_if_ev ("getDescription", NULL); + + return retval; } /** @@ -75,22 +101,43 @@ AccessibleAction_getDescription (AccessibleAction *obj, * * Get the keybindings for the @i-th action invokable on an * object implementing #AccessibleAction, if any are defined. + * The keybindings string format is as follows: + * there are multiple parts to a keybinding string (typically 3). + * They are delimited with ";". The first is the action's + * keybinding which is usable if the object implementing the action + * is currently posted to the screen, e.g. if a menu is posted + * then these keybindings for the corresponding menu-items are + * available. The second keybinding substring is the full key sequence + * necessary to post the action's widget and activate it, e.g. for + * a menu item such as "File->Open" it would both post the menu and + * activate the item. Thus the second keybinding string is available + * during the lifetime of the containing toplevel window as a whole, + * whereas the first keybinding string only works while the object + * implementing AtkAction is posted. The third (and optional) + * keybinding string is the "keyboard shortcut" which invokes the + * action without posting any menus. + * Meta-keys are indicated by the conventional strings + * "", "", "", "", + * etc. (we use the same string as gtk_accelerator_name() in + * gtk+-2.X. * * Returns: a UTF-8 string which can be parsed to determine the @i-th * invokable action's keybindings. - * **/ char * AccessibleAction_getKeyBinding (AccessibleAction *obj, - long int i) + long int i) { - return (char *) - Accessibility_Action_getKeyBinding (CSPI_OBJREF (obj), - (CORBA_long) i, - cspi_ev ()); -} + dbus_int32_t d_i = i; + char *retval; + cspi_return_val_if_fail (obj != NULL, NULL); + cspi_dbus_call (obj, spi_interface_action, "getKeyBinding", NULL, "i=>s", d_i, &retval); + cspi_return_val_if_ev ("getKeyBinding", NULL); + + return retval; +} /** * AccessibleAction_getName: @@ -101,18 +148,21 @@ AccessibleAction_getKeyBinding (AccessibleAction *obj, * object implementing #AccessibleAction. * * Returns: the 'event type' name of the action, as a UTF-8 string. - * **/ char * AccessibleAction_getName (AccessibleAction *obj, - long int i) + long int i) { - return (char *) - Accessibility_Action_getName (CSPI_OBJREF (obj), - (CORBA_long) i, - cspi_ev ()); -} + dbus_int32_t d_i = i; + char *retval; + cspi_return_val_if_fail (obj != NULL, NULL); + + cspi_dbus_call (obj, spi_interface_action, "getName", NULL, "i=>s", d_i, &retval); + cspi_return_val_if_ev ("getName", NULL); + + return retval; +} /** * AccessibleAction_doAction: @@ -122,16 +172,19 @@ AccessibleAction_getName (AccessibleAction *obj, * Invoke the action indicated by #index. * * Returns: #TRUE if the action is successfully invoked, otherwise #FALSE. - * **/ SPIBoolean AccessibleAction_doAction (AccessibleAction *obj, long int i) { - return (SPIBoolean) - Accessibility_Action_doAction (CSPI_OBJREF (obj), - (CORBA_long) i, - cspi_ev ()); -} + dbus_int32_t d_i = i; + dbus_bool_t retval; + cspi_return_val_if_fail (obj != NULL, FALSE); + cspi_dbus_call (obj, spi_interface_action, "doAction", NULL, "i=>b", d_i, &retval); + + cspi_return_val_if_ev ("doAction", FALSE); + + return retval; +}