offapi/com/sun/star/accessibility/XAccessibleAction.idl

   1 /* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
   2 /*
   3  * This file is part of the LibreOffice project.
   4  *
   5  * This Source Code Form is subject to the terms of the Mozilla Public
   6  * License, v. 2.0. If a copy of the MPL was not distributed with this
   7  * file, You can obtain one at http://mozilla.org/MPL/2.0/.
   8  *
   9  * This file incorporates work covered by the following license notice:
  10  *
  11  *   Licensed to the Apache Software Foundation (ASF) under one or more
  12  *   contributor license agreements. See the NOTICE file distributed
  13  *   with this work for additional information regarding copyright
  14  *   ownership. The ASF licenses this file to you under the Apache
  15  *   License, Version 2.0 (the "License"); you may not use this file
  16  *   except in compliance with the License. You may obtain a copy of
  17  *   the License at http://www.apache.org/licenses/LICENSE-2.0 .
  18  */
  19
  20 module com { module sun { module star { module accessibility {
  21
  22  interface XAccessibleKeyBinding;
  23
  24 /** Implement this interface to give access to actions that can be executed
  25     for accessible objects.
  26
  27     <p>Every accessible object that can be manipulated beyond its methods
  28     exported over the accessibility API should support this interface to
  29     expose all actions that it can perform.  Each action can be performed or
  30     be queried for a description or associated key bindings.</p>
  31
  32     @since OOo 1.1.2
  33 */
  34 interface XAccessibleAction : ::com::sun::star::uno::XInterface
  35 {
  36     /** Returns the number of accessible actions available in this object.
  37
  38         <p>If there are more than one, the first one is considered the
  39         "default" action of the object.</p>
  40
  41         @return
  42             The returned value of the number of actions is zero if there are
  43             no actions.
  44     */
  45     long getAccessibleActionCount ();
  46
  47     /** Perform the specified Action on the object.
  48
  49         @param nIndex
  50             This index specifies the action to perform.
  51         @return
  52             Returns `TRUE` if the action was successfully performed.  If
  53             the action could not be performed successfully `FALSE` is
  54             returned.
  55
  56         @throws IndexOutOfBoundsException
  57             If no action with the given index exists then an
  58             ::com::sun::star::lang::IndexOutOfBoundsException
  59             exception is thrown.
  60     */
  61     boolean doAccessibleAction ([in] long nIndex)
  62         raises (::com::sun::star::lang::IndexOutOfBoundsException);
  63
  64     /** Returns a description of the specified action of the object.
  65
  66         @param nIndex
  67             This index specifies the action of which to return a
  68             description.
  69
  70         @return
  71             The returned value is a localized string of the specified action.
  72
  73         @throws IndexOutOfBoundsException
  74             If the given index does not lie in the valid range then a
  75             ::com::sun::star::lang::IndexOutOfBoundsException
  76             exception is thrown.
  77     */
  78     string getAccessibleActionDescription ([in] long nIndex)
  79         raises (::com::sun::star::lang::IndexOutOfBoundsException);
  80
  81     /** Returns a key binding object, if there is one, associated with the
  82         specified action.  Note that there can be several alternative key
  83         bindings for an action.  See XAccessibleKeyBinding for
  84         more information about how key bindings are represented.
  85
  86         @param nIndex
  87             This index specifies the action for which to return the key
  88             binding.
  89
  90         @return
  91             The returned object describes a set of key bindings associated
  92             with the specified action.
  93
  94         @throws IndexOutOfBoundsException
  95             if the given index is not valid.
  96     */
  97     XAccessibleKeyBinding getAccessibleActionKeyBinding ([in] long nIndex)
  98         raises (::com::sun::star::lang::IndexOutOfBoundsException);
  99 };
 100
 101 }; }; }; };
 102
 103 /* vim:set shiftwidth=4 softtabstop=4 expandtab: */