offapi/com/sun/star/accessibility/XAccessibleTextAttributes.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 /** Implement this interface to give access to the attributes of a text.
  23
  24     @since OOo 2.0.4
  25 */
  26 interface XAccessibleTextAttributes
  27 {
  28     /** Get the default attribute set for the text.
  29
  30         <p>Returns a set of all default paragraph and default character
  31         attributes that are associated for the text. To prevent the method
  32         from returning possibly large sets of attributes that the caller
  33         is not interested in the caller can provide a list of attributes
  34         that he wants to be returned.</p>
  35
  36         @param RequestedAttributes
  37             This string sequence defines the set of attributes that the
  38             caller is interested in. When there are requested attributes
  39             that are not defined for the text then they are ignored.
  40
  41             <p>When the sequence is empty all attributes are returned.</p>
  42
  43         @return
  44             Returns the requested attributes of the text. Each attribute
  45             is represented by a ::com::sun::star::beans::PropertyValue
  46             object.
  47     */
  48     sequence<::com::sun::star::beans::PropertyValue>
  49         getDefaultAttributes ( [in] sequence<string> RequestedAttributes )
  50         raises ( ::com::sun::star::beans::UnknownPropertyException );
  51
  52     /** Get the run attribute set for the specified position.
  53
  54         <p>Returns a set of character attributes that are associated for
  55         the character at the given index and are directly set or are set
  56         via a character style. To prevent the method from returning all of
  57         these attributes the caller can provide a list of attributes
  58         that he wants to be returned.</p>
  59
  60         @param Index
  61             The index of the character for which to return its attributes.
  62             The valid range is 0..length of text-1.
  63
  64         @param RequestedAttributes
  65             This string sequence defines the set of attributes that the
  66             caller is interested in. When there are requested attributes
  67             that are not defined for the text then they are ignored.
  68
  69             <p>When the sequence is empty all attributes are returned.</p>
  70
  71         @return
  72             Returns the requested attributes of the specified character.
  73             Each attribute is represented by a
  74             ::com::sun::star::beans::PropertyValue object.
  75
  76         @throws ::com::sun::star::lang::IndexOutOfBoundsException
  77             if the index is invalid
  78     */
  79     sequence<::com::sun::star::beans::PropertyValue>
  80         getRunAttributes ( [in] long Index,
  81                            [in] sequence<string> RequestedAttributes )
  82         raises (::com::sun::star::beans::UnknownPropertyException,
  83                 ::com::sun::star::lang::IndexOutOfBoundsException);
  84
  85 };
  86
  87 }; }; }; };
  88
  89 /* vim:set shiftwidth=4 softtabstop=4 expandtab: */