Lines Matching refs:of
15 * 1. Redistributions of source code must retain the above copyright
16 * notice, this list of conditions and the following disclaimer.
19 * copyright notice, this list of conditions and the following
23 * 3. Neither the name of the Linux Foundation nor the names of its
46 * IAccessible2 is a trademark of the Linux Foundation. The IAccessible2
72 * 1. Redistributions of source code must retain the above copyright
73 * notice, this list of conditions and the following disclaimer.
76 * copyright notice, this list of conditions and the following
80 * 3. Neither the name of the Linux Foundation nor the names of its
103 * IAccessible2 is a trademark of the Linux Foundation. The IAccessible2
109 /** These constants control the scrolling of an object or substring into a window.
115 /** Scroll the top left corner of the object or substring such that the top left
116 corner (and as much as possible of the rest of the object or substring) is within
118 the top level window, the placement of the object or substring is dependent on
121 where there is a hierarchy of nested scrollable controls, more than one control
126 /** Scroll the bottom right corner of the object or substring such that the bottom right
127 corner (and as much as possible of the rest of the object or substring) is within
129 the top level window, the placement of the object or substring is dependent on
132 where there is a hierarchy of nested scrollable controls, more than one control
137 /** Scroll the top edge of the object or substring such that the top edge
138 (and as much as possible of the rest of the object or substring) is within the
140 the top level window, the placement of the object or substring is dependent on
143 where there is a hierarchy of nested scrollable controls, more than one control
148 /** Scroll the bottom edge of the object or substring such that the bottom edge
149 (and as much as possible of the rest of the object or substring) is within the
151 the top level window, the placement of the object or substring is dependent on
154 where there is a hierarchy of nested scrollable controls, more than one control
159 /** Scroll the left edge of the object or substring such that the left edge
160 (and as much as possible of the rest of the object or substring) is within the
162 the top level window, the placement of the object or substring is dependent on
165 where there is a hierarchy of nested scrollable controls, more than one control
170 /** Scroll the right edge of the object or substring such that the right edge
171 (and as much as possible of the rest of the object or substring) is within the
173 the top level window, the placement of the object or substring is dependent on
176 where there is a hierarchy of nested scrollable controls, more than one control
181 /** Scroll the object or substring such that as much as possible of the
182 object or substring is within the top level window. The placement of
201 /** The coordinates are relative to the upper left corner of the bounding box
202 of the immediate parent.
215 …IA2_TEXT_OFFSET_LENGTH = -1, /**< This offset is equivalent to the length of the string. It elimi…
218 of the caret should be used. */
221 /** These constants specify the kind of change made to a table.
232 /** A structure defining the type of and extents of changes made to a table
235 In the case of an insertion or change the row and column offsets define the boundaries
236 of the inserted or changed subtable after the operation. In the case of a deletion
237 the row and column offsets define the boundaries of the subtable being removed before
263 * 1. Redistributions of source code must retain the above copyright
264 * notice, this list of conditions and the following disclaimer.
267 * copyright notice, this list of conditions and the following
271 * 3. Neither the name of the Linux Foundation nor the names of its
294 * IAccessible2 is a trademark of the Linux Foundation. The IAccessible2
324 /** Some attribute of this object is affected by a target object. */
327 /** This object is interactive and controls some attribute of a target object. */
367 /** This object is a member of a group of one or more objects. When
377 /** This object is a logical child of a target object. This relation is the reciprocal
378 of the IA2_RELATION_NODE_PARENT_OF relation. In some cases an application's accessible
380 different from the hierarchy of the accessible tree. */
383 /** This object is a logical parent of a target object. This relation is the reciprocal
384 of the IA2_RELATION_NODE_CHILD_OF relation. In some cases an application's accessible
386 different from the hierarchy of the accessible tree. */
389 /** This object is a parent window of the target object. */
400 /** This object is a sub window of a target object. */
405 /** This interface gives access to an object's set of relations.
410 /** @brief Returns the type of the relation.
412 The strings returned are defined @ref grpRelations "in this section of the documentation".
420 /** @brief Returns a localized version of the relation type.
429 /** @brief Returns the number of targets for this relation.
454 maximum size of the array allocated by the client
456 The array of target objects. Note that this array is to be allocated by the
461 actual number of targets in the returned array (not more than maxTargets)
490 * 1. Redistributions of source code must retain the above copyright
491 * notice, this list of conditions and the following disclaimer.
494 * copyright notice, this list of conditions and the following
498 * 3. Neither the name of the Linux Foundation nor the names of its
521 * IAccessible2 is a trademark of the Linux Foundation. The IAccessible2
543 Any form of content generation that requires
544 synchronization with an AT would require use of this
545 action. One example is the generation of text describing
548 may take more time than the related length of silence
560 methods available either in the MSAA IAccessible interface or in the set of
577 /** @brief Returns the number of accessible actions available in this object.
580 "default" action of the object.
582 The returned value of the number of actions is zero if there are
586 method is named nActions in generated C++ code instead of get_nActions.
607 /** @brief Returns a description of the specified action of the object.
612 The returned value is a localized string of the specified action.
623 /** @brief Returns an array of BSTRs describing one or more key bindings, if
632 that would be redundant with the standard MSAA programming practice of
636 provide alternative means of activation.
638 Note: the client allocates and passes in an array of pointers. The server
640 the array of pointers allocated by the client. The client is responsible
649 An array of BSTRs, allocated by the server, one for each key binding.
652 The number of key bindings returned; the size of the returned array.
665 /** @brief Returns the non-localized name of specified action.
679 /** @brief Returns the localized name of specified action.
710 * 1. Redistributions of source code must retain the above copyright
711 * notice, this list of conditions and the following disclaimer.
714 * copyright notice, this list of conditions and the following
718 * 3. Neither the name of the Linux Foundation nor the names of its
741 * IAccessible2 is a trademark of the Linux Foundation. The IAccessible2
749 /** Collection of roles
751 This enumerator defines an extended set of accessible roles of objects implementing
787 versions of those internal frames. Also refer to ::IA2_ROLE_INTERNAL_FRAME.
792 and select the contents of a directory. May be used by a file chooser.
806 /// Text that is used as an endnote (footnote at the end of a chapter or section).
811 or specify a filename. May use the directory pane to show the contents of
822 /** Footer of a document page.
830 /** A container of form controls. An example of the use of this role is to
837 ::IA2_ROLE_CANVAS and the MSAA roles of dialog and window.
841 /** A glass pane. A pane that is guaranteed to be painted on top of all panes
847 /** Header of a document page.
859 each hotspot can be activated resulting in the loading of another document
860 or section of a document.
864 /** An object which is used to allow input of characters not found on a keyboard,
865 such as the input of Chinese characters on a Western keyboard.
880 in layers, providing a form of stacking order. This is usually the pane that
881 holds the menu bar as well as the pane that contains most of the visual
888 of the resource.
897 /** An object representing a page of document content. It is used in documents
902 /// A paragraph of text.
926 amount of information. Its children can include scroll bars and a viewport.
931 /** A container of document content. An example of the use of this role is to
933 group of elements that together form a perceivable unit. A region does not
934 necessarily follow the logical structure of the content, but follows the
935 perceivable structure of the page. A region may have an attribute in the set
936 of IAccessible2::attributes which indicates that it is "live". A live region
951 /** An object that forms part of a menu system but which can be "undocked"
959 /// Collection of objects that constitute a logical text entity.
964 Also refer to MSAA's roles of push button, check box, and radio button.
971 portion of the entire data that the user can see. As the user manipulates
972 the scroll bars, the contents of the viewport can change.
977 /** An object containing content which is complementary to the main content of
979 are various types of content that would appropriately have this role. For example,
1005 * 1. Redistributions of source code must retain the above copyright
1006 * notice, this list of conditions and the following disclaimer.
1009 * copyright notice, this list of conditions and the following
1013 * 3. Neither the name of the Linux Foundation nor the names of its
1036 * IAccessible2 is a trademark of the Linux Foundation. The IAccessible2
1074 something about the state of the interface, for example, code operating asynchronously
1091 /** Indicates the orientation of this object is horizontal. */
1119 /** Indicates this text object can contain multiple lines of text. */
1127 An example of when this state is used is when a field in a form must be filled
1138 /** Indicates that this text object can contain only a single line of text. */
1144 represents the state of the object which it is representing such as when an
1145 object is transient or when an object has been or is in the process of being
1152 This state indicates that a text control will respond to the input of
1163 object may exist only while the cell has focus. However, from the perspective of an
1165 result it is likely that this state is not of use to an assistive technology, but it
1166 is provided in case an assistive technology determines that knowledge of the transient
1167 nature of the object is useful and also for harmony with the Linux accessibility API.
1173 /** Indicates the orientation of this object is vertical. */
1182 an object has a role which is not one of the previously mentioned roles. An
1214 * 1. Redistributions of source code must retain the above copyright
1215 * notice, this list of conditions and the following disclaimer.
1218 * copyright notice, this list of conditions and the following
1222 * 3. Neither the name of the Linux Foundation nor the names of its
1245 * IAccessible2 is a trademark of the Linux Foundation. The IAccessible2
1285 …::IA2TableModelChangeType values describe the kinds of changes made to a table (insert, delete, up…
1308 1. Redistributions of source code must retain the above copyright
1309 notice, this list of conditions and the following disclaimer.
1312 copyright notice, this list of conditions and the following
1316 3. Neither the name of the Linux Foundation nor the names of its
1339 %IAccessible2 is a trademark of the Linux Foundation. The %IAccessible2
1383 client at end of life; the same is true when BSTRs are used in structs or
1388 with Release at end of life.
1395 of the November 1996 edition of the Microsoft Systems Journal.
1401 There are several methods which return arrays. In the case of IAccessible2::relations
1421 extraneous [in] parameter for the caller to specify the max size of the array.
1431 IAccessibleText and IAccessibleEditableText can use one or more of the following
1433 @li Using ::IA2_TEXT_OFFSET_LENGTH (-1) as an offset in any of the IAccessibleText or
1434 IAccessibleEditableText methods is the same as specifying the length of the string.
1437 text related to the physical location of the caret should be used. This is needed for
1438 applications that consider the character offset of the end of one line (as reached by
1439 pressing the End key) the same as the offset of the first character on the next line.
1443 @section _dicoveringInterfaces Discovery of Interfaces
1469 of the interfaces in the set of IAccessible2 interfaces. Although the IAccessible2
1470 IDL is coded such that IAccessible2 is a subclass of MSAA's IAccessible, none of
1479 Why use QueryService instead of just using QueryInterface to get IAccessibleEx
1500 between a reference to an MSAA IAccessible interface and any of the IAccessible2 interfaces.
1502 Regarding switching between any of the IAccessible2 interfaces, applications implementing
1505 the IAccessible2 interfaces on separate objects would require the use of QueryService.
1519 for an object that implements any of the IAccessible2 interfaces.
1524 between an IAccessibleEx and an {IAccessible, Child ID} pair. A future version of
1534 @section _iaaction-iahyperlink IAccessibleHyperlink as subclass of IAccessibleAction
1535 In this version of the IDL, IAccessibleHyperlink is a subclass of IAccessibleAction.
1537 an image map of smart tags, it doesn't make sense because such an image map doesn't
1540 a later version of the IDL.
1543 The names of actual companies and products mentioned herein may be the trademarks of
1545 are trademarks of the Microsoft group of companies in the U.S.A. and/or other countries.
1556 /** A structure defining the locale of an accessible object.
1563 BSTR variant; ///< Application specific variant of the locale
1566 /** @brief This interface exposes the primary set of information about an
1570 portion of the collection of the %IAccessible2 interfaces.
1573 for special considerations related to use of the MSAA IAccessible interface and
1574 the set of %IAccessible2 interfaces.
1580 /** @brief Returns the number of accessible relations for this object.
1604 maximum size of the array allocated by the client
1606 The array of accessible relation objects. Note that this array is to be
1610 actual number of relations in the returned array (not more than maxRelations)
1623 /** @brief Returns the role of an %IAccessible2 object.
1625 The role of an %IAccessible2 object.
1636 method is named role in generated C++ code instead of get_role.
1654 /** @brief Moves the top left of an object to a specified location.
1675 Also used for collections of non-text objects.
1687 @note This method is meant to describe the nature of an object's containment
1692 of its contents. Normally an AT will get that information from its child list
1694 such that the list is a child of the combo box, this method is implemented on
1741 /** @brief Returns the number of extended states.
1750 /** @brief Returns the extended states (array of strings).
1761 The number of extended states returned; the size of the returned array.
1772 /** @brief Returns the localized extended states (array of strings).
1780 The number of localized extended states returned; the size of the returned array.
1794 current window, and remains the same for the lifetime of the accessible
1806 An example of when this value is useful is if the AT wants to build a cache.
1809 Thus, if there's a REORDER/SHOW/HIDE event the AT knows which part of the
1816 Another use of this value by an AT is to identify when a grouping object has
1820 One means of implementing this would be to create a factory with a 32 bit number
1844 Without the availability of windowHandle, the AT would have to get the window handle
1857 /** @brief Returns the index of this object in its parent object.
1869 /** @brief Returns the IA2Locale of the accessible object.
1906 * 1. Redistributions of source code must retain the above copyright
1907 * notice, this list of conditions and the following disclaimer.
1910 * copyright notice, this list of conditions and the following
1914 * 3. Neither the name of the Linux Foundation nor the names of its
1937 * IAccessible2 is a trademark of the Linux Foundation. The IAccessible2
1948 /** @brief This interface exposes the primary set of information about an
1952 portion of the collection of the %IAccessible2 interfaces.
1955 for special considerations related to use of the MSAA IAccessible interface and
1956 the set of %IAccessible2 interfaces.
1961 /** @brief Returns the attribute value of a specified attribute specific to this object.
1978 …/** @brief Returns the deepest hypertext accessible in the subtree of this object, and the caret o…
1982 …@retval S_FALSE returned if there is no caret in any of the objects in the subtree, [out] accessib…
1994 The number of targets requested. 0 indicates that all targets should be returned.
1998 The number of targets returned; the size of the returned array.
2029 * 1. Redistributions of source code must retain the above copyright
2030 * notice, this list of conditions and the following disclaimer.
2033 * copyright notice, this list of conditions and the following
2037 * 3. Neither the name of the Linux Foundation nor the names of its
2060 * IAccessible2 is a trademark of the Linux Foundation. The IAccessible2
2079 to retrieve information concerning the graphical representation of an object.
2080 Coordinates used by the functions of this interface are specified in
2082 that of the screen coordinate system. In other words all coordinates
2086 corner of the current screen.</li>
2087 <li>The origin of the parent coordinate system is the upper left corner
2088 of the parent's bounding box. With no parent the screen coordinate
2096 /** @brief Returns the location of the upper left corner of the object's
2099 The coordinates of the bounding box are given relative to the parent's
2100 coordinate system. The coordinates of the returned position are relative
2115 /** @brief Returns the foreground color of this object.
2117 The returned color is the foreground color of this object or, if
2126 /** @brief Returns the background color of this object.
2128 The returned color is the background color of this object or, if
2153 * 1. Redistributions of source code must retain the above copyright
2154 * notice, this list of conditions and the following disclaimer.
2157 * copyright notice, this list of conditions and the following
2161 * 3. Neither the name of the Linux Foundation nor the names of its
2184 * IAccessible2 is a trademark of the Linux Foundation. The IAccessible2
2205 /** @brief Returns the value of this object as a number.
2220 /** @brief Sets the value of this object to the given number.
2229 The new value represented by this object. The set of admissible types for
2240 The type of the returned value is implementation dependent. It does not have
2257 The type of the returned value is implementation dependent. It does not have
2289 * 1. Redistributions of source code must retain the above copyright
2290 * notice, this list of conditions and the following disclaimer.
2293 * copyright notice, this list of conditions and the following
2297 * 3. Neither the name of the Linux Foundation nor the names of its
2320 * IAccessible2 is a trademark of the Linux Foundation. The IAccessible2
2336 BSTR text; ///< A copy of a segment of text taken from an enclosing paragraph.
2337 long start; ///< Index of the first character of the segment in the enclosing text.
2338 …long end; ///< Index of the character following the last character of the segment in the enclosin…
2346 how screen readers have handled the reading of sentences this boundary type
2347 could be implemented and screen readers could use the application's version of a
2350 The rest of the boundary types must be supported.
2361 … of the caret. Note that after the caret moves, the caret offset changes
2362 … by the number of characters in the field, e.g. by 8 characters in the
2366 … Typically this is from the start of one word to the start of the next, but
2367 … various applications are inconsistent in the handling of the end of a line. */
2368 …IA2_TEXT_BOUNDARY_SENTENCE, ///< Range is from start of one sentence to the start of another sen…
2369 …IA2_TEXT_BOUNDARY_PARAGRAPH, ///< Range is from start of one paragraph to the start of another pa…
2370 …IA2_TEXT_BOUNDARY_LINE, /**< Range is from start of one line to the start of another line. T…
2371 … often means that an end-of-line character will appear at the end of the
2372 … range. However in the case of some applications an end-of-line character
2373 … indicates the end of a paragraph and the lines composing the paragraph,
2374 … other than the last line, do not contain an end of line character. */
2382 text entry fields, or text portions of the document window. The interface
2385 of the IAccessibleEditableText interface.
2387 The text length, i.e. the number of characters in the text, is
2413 Offset of first character after new selection (0 based).
2432 The starting offset of the character range over which all text attributes match
2433 those of offset. (0 based)
2435 The offset of the first character past the character range over which all text
2436 attributes match those of offset. (0 based)
2438 A string of attributes describing the text. The attributes are described in the
2453 /** @brief Returns the position of the caret.
2455 Returns the 0-based offset of the caret within the text. If the text is
2456 implemented as a tree of text objects with embed characters in higher levels
2457 representing substrings of child text objects and the caret is in one of the
2469 The caret position/offset is that of the character logically following it, e.g.
2470 to the right of it in a left to right language, or to the left of it in a right
2477 @note S_FALSE (and an offset of -1) will not be returned if the caret is somewhere
2478 in the text object or one of its descendants.
2486 /** @brief Returns the bounding box of the specified position.
2488 The virtual character after the last character of the represented
2493 roughly equivalent to the bounding box of some character when inserted at the
2494 end of the text. Its height typically being the maximal height of all the
2495 characters in the text or the height of the preceding character, its width being
2504 Index of the character for which to return its bounding box. The valid range
2511 X coordinate of the top left corner of the bounding box of the referenced character.
2513 Y coordinate of the top left corner of the bounding box of the referenced character.
2515 Width of the bounding box of the referenced character.
2517 Height of the bounding box of the referenced character.
2532 /** @brief Returns the number of active non-contiguous selections
2543 Given a point return the zero-based index of the character under that
2550 The position's x value for which to look up the index of the character that
2553 The position's y value for which to look up the index of the character that
2558 Index of the character under the given point or -1 if the point
2573 /** @brief Returns the character offsets of Nth active text selection
2575 Returns the 0-based starting and ending offsets of the Nth selection. If the
2576 text is implemented as a tree of text objects with embed characters in higher
2577 levels representing substrings of child text objects, consider the following.
2578 If the starting selection offset is in one of the child text objects, then the
2581 If the ending selection offset is in one of the child text objects, then the
2593 Selection offsets are that of the character logically following it, e.g.
2594 to the right of it in a left to right language or to the left of it in a right to left language.
2596 Index of selection (0 based).
2598 0 based offset of first selected character
2600 0 based offset of one past the last selected character.
2622 Index of the first character to include in the returned string. The valid range
2625 Index of the last character to exclude in the returned string. The valid range
2649 Returns the substring of the specified text type that is located before the
2650 given character and does not include it. The result of this method should be
2658 values of 0, 0, and a NULL pointer. This would happen for boundary types other
2659 than character when the text consists entirely of whitespace.
2662 Index of the character for which to return the text part before it. The index
2663 character will not be part of the returned string. The valid range is 0..length.
2668 The type of the text portion to return. See ::IA2TextBoundaryType for the
2671 0 based offset of first character.
2673 0 based offset of one past the last character.
2694 Returns the substring of the specified text type that is located after the
2695 given character and does not include it. The result of this method should be
2703 values of 0, 0, and a NULL pointer. This would happen for boundary types other
2704 than character when the text consists entirely of whitespace.
2707 Index of the character for which to return the text part after it. The index
2708 character will not be part of the returned string. The valid range is 0..length.
2713 The type of the text portion to return. See ::IA2TextBoundaryType for the complete
2716 0 based offset of first character.
2718 0 based offset of one past the last character.
2745 last characters of a word are considered inside the word. Boundary types of
2749 values of 0, 0, and a NULL pointer. This would happen for boundary types other
2750 than character when the text consists entirely of whitespace.
2753 Index of the character for which to return the text part it belongs to. The valid
2759 The type of the text portion to return. See ::IA2TextBoundaryType for the complete
2762 0 based offset of first character.
2764 0 based offset of one past the last character.
2783 /** @brief Unselects a range of text.
2785 Index of selection to remove (0 based).
2794 /** @brief Sets the position of the caret.
2796 The caret position/offset is that of the character logically following it,
2797 e.g. to the right of it in a left to right language.
2800 change of the selection is notified to the accessibility event listeners with
2803 When the new caret position differs from the old one (which, of course, is the
2807 The new index of the caret. This caret is actually placed to the left side of
2808 the character with that index. An index of 0 places the caret so that the next
2809 insertion goes before the first character. An index of IAccessibleText::nCharacters
2822 /** @brief Changes the bounds of an existing selection.
2824 Index of selection to change (0 based)
2828 …New ending offset (0 based) - the offset of the character just past the last character of the sele…
2842 /** @brief Returns total number of characters.
2844 Note that this may be different than the total number of bytes required to store the
2854 /** @brief Makes a specific part of string visible on screen.
2858 … 0 based character offset - the offset of the character just past the last character of the string.
2874 /** @brief Moves the top left of a substring to a specified location.
2879 … 0 based character offset - the offset of the character just past the last character of the string.
2908 continues. Once the handler has returned, the validity of the data depends on
2909 how the server manages the life cycle of its objects. Also, note that the server
2912 a large number of children and thus it's possible that the child objects for those
2914 strategy as this will be of interest to assistive technology or script engines
2915 accessing data out of process or from other threads. Servers only need to save the
2916 last inserted block of text and a scope of the entire application is adequate.
2921 @retval S_FALSE If there is nothing to return, the values of IA2TextSegment
2935 continues. Once the handler has returned, the validity of the data depends on
2936 how the server manages the life cycle of its objects. Also, note that the server
2939 a large number of children and thus it's possible that the child objects for those
2941 strategy as this will be of interest to assistive technology or script engines
2942 accessing data out of process or from other threads. Servers only need to save the
2943 last removed block of text and a scope of the entire application is adequate.
2948 @retval S_FALSE If there is nothing to return, the values of IA2TextSegment
2973 * 1. Redistributions of source code must retain the above copyright
2974 * notice, this list of conditions and the following disclaimer.
2977 * copyright notice, this list of conditions and the following
2981 * 3. Neither the name of the Linux Foundation nor the names of its
3004 * IAccessible2 is a trademark of the Linux Foundation. The IAccessible2
3018 The %IAccessibleText2 interface extends the functionality of the
3025 /** @brief Returns the range and of the specified set of attributes.
3035 The starting (0-based) offset of the text containing the specified attributes.
3037 The (0-based) offset one past the last character of the text containing the
3040 The values of the requested attributes.
3071 * 1. Redistributions of source code must retain the above copyright
3072 * notice, this list of conditions and the following disclaimer.
3075 * copyright notice, this list of conditions and the following
3079 * 3. Neither the name of the Linux Foundation nor the names of its
3102 * IAccessible2 is a trademark of the Linux Foundation. The IAccessible2
3116 interface and complements that interface with the additional capability of
3142 Start index of the text to moved into the clipboard.
3145 End index of the text to moved into the clipboard.
3161 /** @brief Deletes a range of text.
3167 Start index of the text to be deleted.
3170 End index of the text to be deleted.
3208 /** @brief Deletes a range of text and copies it to the clipboard.
3214 Start index of the text to be deleted.
3217 End index of the text to be deleted.
3267 Start index of the text to be replaced.
3270 End index of the text to be replaced.
3288 /** @brief Replaces the attributes of a text range by the given set of attributes.
3291 attributes are replaced by the new list of attributes.
3294 Start index of the text whose attributes are modified.
3297 End index of the text whose attributes are modified.
3300 Set of attributes that replaces the old list of attributes of
3333 * 1. Redistributions of source code must retain the above copyright
3334 * notice, this list of conditions and the following disclaimer.
3337 * copyright notice, this list of conditions and the following
3341 * 3. Neither the name of the Linux Foundation nor the names of its
3364 * IAccessible2 is a trademark of the Linux Foundation. The IAccessible2
3378 of text or single non-text object. Non-text objects can have either a
3379 single link or a collection of links such as when the non-text object is
3384 maximum value for the indices used with the methods of this interface.
3392 An example is an image map which is an image with multiple links each of which is
3393 associated with a separate non-overlapping area of the image. This interface could
3394 also be applied to other kinds of objects with multiple actions such as "smart tags"
3399 actions, e.g. an image map of smart tags. In this case you would have to implement
3400 two levels of accessible hyperlinks. The first level hyperlinks would only implement
3403 of the IAccessibleAction methods would be implemented on the first level hyperlink
3409 to derive from IAccessibleAction. As a result it may be removed in a later version of
3420 A 0 based index identifies the anchor when, as in the case of an image map,
3425 method could return the substring of the containing string where the substring
3438 /** @brief Returns an object representing the target of the link, as appropriate
3441 A 0 based index identifies the anchor when, as in the case of an image map,
3446 return a BSTR VARIANT of the URI. Alternatively this method could return an
3447 IUnknown VARIANT of a COM interface representing a target object to be
3459 …/** @brief Returns the 0 based character offset at which the textual representation of the hyperli…
3461 The returned value is related to the IAccessibleText interface of the object that
3471 …/** @brief Returns the 0 based character offset at which the textual representation of the hyperli…
3473 The returned value is related to the IAccessibleText interface of the object that
3474 owns this hyperlink. The character at the index is not part of the hypertext.
3488 This has also been used to indicate whether or not the URI of the anchorTarget
3492 If false, one or more of the object's links are invalid.
3493 If true, all of the object's links are valid.
3497 used. It is likely that this method will be removed in a later version of the IDL.
3520 * 1. Redistributions of source code must retain the above copyright
3521 * notice, this list of conditions and the following disclaimer.
3524 * copyright notice, this list of conditions and the following
3528 * 3. Neither the name of the Linux Foundation nor the names of its
3551 * IAccessible2 is a trademark of the Linux Foundation. The IAccessible2
3568 this interface on the smallest text object such as a paragraph of text.
3574 /** @brief Returns the number of links and link groups contained within this hypertext
3577 The number of links and link groups within this hypertext paragraph.
3589 provides several kinds of information describing it.
3594 of links minus one, a reference to the specified hyperlink object is returned.
3605 /** @brief Returns the index of the hyperlink that is associated with this character index.
3609 A 0 based index of the character for which to return the link index. If
3612 lower than the number of characters in the text.
3614 Returns the 0 based index of the hyperlink that is associated with this
3643 * 1. Redistributions of source code must retain the above copyright
3644 * notice, this list of conditions and the following disclaimer.
3647 * copyright notice, this list of conditions and the following
3651 * 3. Neither the name of the Linux Foundation nor the names of its
3674 * IAccessible2 is a trademark of the Linux Foundation. The IAccessible2
3688 The %IAccessibleHypertext2 interface extends the functinality of the
3698 provides several kinds of information describing it.
3703 The number of links returned; the size of the returned array.
3730 * 1. Redistributions of source code must retain the above copyright
3731 * notice, this list of conditions and the following disclaimer.
3734 * copyright notice, this list of conditions and the following
3738 * 3. Neither the name of the Linux Foundation nor the names of its
3761 * IAccessible2 is a trademark of the Linux Foundation. The IAccessible2
3775 Typically all accessible objects that represent cells or cell-clusters of a table
3776 will be at the same time children of the table. In this case IAccessible2::indexInParent
3780 However, in some cases that kind of implementation will not be possible. When
3781 the table cells are not direct children of a table, the object representing
3785 attribute can be used just like a child index of the typical case. ATs should
3786 first test for the presence of the "table-cell-index" attribute and if it is not
3788 where cells are direct children of the table.
3790 The range of valid coordinates for this interface are implementation dependent.
3810 object is returned that represents the requested cell regardless of whether
3841 Returns the 0 based index of the cell at the specified row and column indexes.
3844 @note The returned value is not necessarily a child index of the immediate parent.
3845 In cases where the table cells are not direct children of the table the index
3847 array of cells laid out in row order.
3856 /** @brief Returns the description text of the specified column in the table.
3858 The 0 based index of the column for which to retrieve the description.
3860 Returns the description text of the specified column in the table if such a
3872 /** @brief Returns the number of columns occupied by the accessible object
3877 0 based row index of the accessible for which to return the column extent.
3879 0 based column index of the accessible for which to return the column extent.
3881 Returns the 1 based column extent of the specified cell.
3894 Content and size of the returned table are implementation dependent.
3910 0 based index of the cell in the parent or closest ancestor table. Typically this
3912 table cells are not direct children of the table this is the cell index specified
3916 Returns the 0 based column index of the cell of the specified child or the index of
3927 /** @brief Returns the total number of columns in table
3929 Number of columns in table (including columns outside the current viewport)
3937 /** @brief Returns the total number of rows in table
3939 Number of rows in table (including rows outside the current viewport)
3947 /** @brief Returns the total number of selected cells
3949 Number of cells currently selected
3957 /** @brief Returns the total number of selected columns
3959 Number of columns currently selected
3967 /** @brief Returns the total number of selected rows
3969 Number of rows currently selected
3977 /** @brief Returns the description text of the specified row in the table.
3979 The 0 based index of the row for which to retrieve the description.
3981 Returns the description text of the specified row in the table if such a
3993 /** @brief Returns the number of rows occupied by the accessible object
3998 0 based row index of the accessible for which to return the row extent.
4000 0 based column index of the accessible for which to return the row extent.
4002 Returns the row extent of the specified cell.
4015 Content and size of the returned table are implementation dependent.
4031 0 based index of the cell in the parent or closest ancestor table. Typically this
4033 table cells are not direct children of the table this is the cell index specified
4047 /** @brief Returns a list of cell indexes currently selected (0 based).
4052 An array of cell indexes of selected cells (each index is 0 based),
4055 The number of cell indexes returned; the size of the returned array.
4066 /** @brief Returns a list of column indexes currently selected (0 based).
4071 An array of column indexes of selected columns (each index is 0 based), allocated
4074 The number of column indexes returned; the size of the returned array.
4085 /** @brief Returns a list of row indexes currently selected (0 based).
4090 An array of row indexes of selected rows (each index is 0 based), allocated
4093 The number of row indexes returned; the size of the returned array.
4104 /** @brief Returns the summary description of the table. The returned object could be
4121 0 based index of the column for which to determine whether it is selected.
4136 0 based index of the row for which to determine whether it is selected.
4150 0 based index of the row for the cell to determine whether it is selected.
4152 0 based index of the column for the cell to determine whether it is selected.
4167 0 based index of the row to be selected.
4178 0 based index of the column to be selected.
4189 0 based index of the row to be unselected.
4200 0 based index of the column to be unselected.
4209 /** @brief Given a cell index, gets the row and column indexes and extents of a cell
4214 0 based index of this cell in the table.
4220 Number of cells spanned by this cell in this row.
4222 Number of cells spanned by this cell in this column.
4243 continues. Once the handler has returned, the validity of the data depends on
4244 how the server manages the life cycle of its objects. Also, note that the server
4247 a large number of children and thus it's possible that the child objects for those
4249 strategy as this will be of interest to assistive technology or script engines
4250 accessing data out of process or from other threads. Servers only need to save the
4251 most recent row and column values associated with the change and a scope of the
4255 A struct of (type(insert, delete, update), firstRow, lastRow, firstColumn, lastColumn).
4281 * 1. Redistributions of source code must retain the above copyright
4282 * notice, this list of conditions and the following disclaimer.
4285 * copyright notice, this list of conditions and the following
4289 * 3. Neither the name of the Linux Foundation nor the names of its
4312 * IAccessible2 is a trademark of the Linux Foundation. The IAccessible2
4343 object is returned that represents the requested cell regardless of whether
4369 /** @brief Returns the description text of the specified column in the table.
4371 The 0 based index of the column for which to retrieve the description.
4373 Returns the description text of the specified column in the table if such a
4386 /** @brief Returns the total number of columns in table
4388 Number of columns in table (including columns outside the current viewport)
4396 /** @brief Returns the total number of rows in table
4398 Number of rows in table (including rows outside the current viewport)
4406 /** @brief Returns the total number of selected cells
4408 Number of cells currently selected
4416 /** @brief Returns the total number of selected columns
4418 Number of columns currently selected
4426 /** @brief Returns the total number of selected rows
4428 Number of rows currently selected
4436 /** @brief Returns the description text of the specified row in the table.
4438 The 0 based index of the row for which to retrieve the description.
4440 Returns the description text of the specified row in the table if such a
4452 /** @brief Returns a list of accessibles currently selected.
4454 Pointer to an array of references to selected accessibles. The array is
4458 The number of accessibles returned; the size of the returned array.
4468 /** @brief Returns a list of column indexes currently selected (0 based).
4470 A pointer to an array of column indexes of selected columns (each index is
4474 The number of column indexes returned; the size of the returned array.
4484 /** @brief Returns a list of row indexes currently selected (0 based).
4486 An array of row indexes of selected rows (each index is 0 based). The array
4490 The number of row indexes returned; the size of the returned array.
4500 /** @brief Returns the summary description of the table. The returned object could be
4518 0 based index of the column for which to determine whether it is selected.
4533 0 based index of the row for which to determine whether it is selected.
4547 The behavior should mimic that of the application, but for those applications
4548 which do not have a means in the GUI to select a full row of cells the behavior
4550 the entire row of cells for the specified row is selected. If any of the
4554 0 based index of the row to be selected.
4565 The behavior should mimic that of the application, but for those applications
4566 which do not have a means in the GUI to select a full column of cells the behavior
4568 the entire column of cells for the specified column is selected. If any of the
4572 0 based index of the column to be selected.
4583 The behavior should mimic that of the application, but for those applications
4584 which do not have a means in the GUI to unselect a full row of cells the
4585 behavior should be as follows: The entire row of cells for the specified
4586 row is unselected. If any of the cells in the selected row span additional
4589 0 based index of the row to be unselected.
4600 The behavior should mimic that of the application, but for those applications
4601 which do not have a means in the GUI to unselect a full column of cells the
4602 behavior should be as follows: The entire column of cells for the specified
4603 column is unselected. If any of the cells in the selected column span additional
4606 0 based index of the column to be unselected.
4620 continues. Once the handler has returned, the validity of the data depends on
4621 how the server manages the life cycle of its objects. Also, note that the server
4624 a large number of children and thus it's possible that the child objects for those
4626 strategy as this will be of interest to assistive technology or script engines
4627 accessing data out of process or from other threads. Servers only need to save the
4628 most recent row and column values associated with the change and a scope of the
4632 A struct of (type(insert, delete, update), firstRow, lastRow, firstColumn, lastColumn).
4658 * 1. Redistributions of source code must retain the above copyright
4659 * notice, this list of conditions and the following disclaimer.
4662 * copyright notice, this list of conditions and the following
4666 * 3. Neither the name of the Linux Foundation nor the names of its
4689 * IAccessible2 is a trademark of the Linux Foundation. The IAccessible2
4700 /** @brief This interface gives access to the cells of a two-dimensional table.
4709 /** @brief Returns the number of columns occupied by this cell accessible.
4713 Returns the 1 based column extent of the specified cell.
4721 /** @brief Returns the column headers as an array of cell accessibles.
4724 Pointer to an array of references to cell accessibles. The array is allocated
4727 The number of accessibles returned; the size of the returned array.
4740 Returns the 0 based column index of the cell of the specified cell or the index of
4749 /** @brief Returns the number of rows occupied by this cell accessible.
4752 Returns the row extent of the specified cell.
4760 /** @brief Returns the row headers as an array of cell accessibles.
4763 Pointer to an array of references to cell accessibles. The array is allocated
4766 The number of accessibles returned; the size of the returned array.
4779 Returns the 0 based row index of the specified cell or the index of
4799 /** @brief Gets the row and column indexes and extents of this cell accessible
4808 Number of cells spanned by this cell in this row.
4810 Number of cells spanned by this cell in this column.
4824 /** @brief Returns a reference to the accessbile of the containing table.
4827 Returns a reference to the IUnknown of the containing table.
4852 * 1. Redistributions of source code must retain the above copyright
4853 * notice, this list of conditions and the following disclaimer.
4856 * copyright notice, this list of conditions and the following
4860 * 3. Neither the name of the Linux Foundation nor the names of its
4883 * IAccessible2 is a trademark of the Linux Foundation. The IAccessible2
4896 This interface is used for a representation of images like icons on buttons.
4902 behavior of an actionable image and the image itself conveys semantically
4911 /** @brief Returns the localized description of the image.
4921 /** @brief Returns the coordinates of the image.
4935 /** @brief Returns the size of the image in units specified by parent's coordinate system.
4963 * 1. Redistributions of source code must retain the above copyright
4964 * notice, this list of conditions and the following disclaimer.
4967 * copyright notice, this list of conditions and the following
4971 * 3. Neither the name of the Linux Foundation nor the names of its
4994 * IAccessible2 is a trademark of the Linux Foundation. The IAccessible2
5007 /** The change of the number or attributes of actions of an accessible
5008 object is signaled by events of this type.
5012 /** <b>Deprecated.</b> The active descendant of a component has changed.
5020 /** The active descendant of a component has changed. The active descendant
5033 /** The document wide attributes of the document object have changed.
5037 /** The contents of the document have changed.
5041 /** The loading of the document has completed.
5045 /** The loading of the document was interrupted.
5053 /** The ending index of this link within the containing string has changed.
5057 /** The number of anchors associated with this hyperlink object has changed.
5066 /** One of the links associated with the hypertext object has been activated.
5070 /** One of the links associated with the hypertext object has been selected.
5074 /** The starting index of this link within the containing string has changed.
5084 /** The number of hyperlinks associated with a hypertext object changed
5162 /** The text selection changed. Later versions of Microsoft development environments
5170 /** A visible data event indicates the change of the visual appearance
5171 of an accessible object. This includes for example most of the
5193 * 1. Redistributions of source code must retain the above copyright
5194 * notice, this list of conditions and the following disclaimer.
5197 * copyright notice, this list of conditions and the following
5201 * 3. Neither the name of the Linux Foundation nor the names of its
5224 * IAccessible2 is a trademark of the Linux Foundation. The IAccessible2
5238 this application from other applications, from other versions of this
5239 application, or from other versions of this application running on different
5240 versions of an accessibility bridge or accessibility toolkit.
5312 * 1. Redistributions of source code must retain the above copyright
5313 * notice, this list of conditions and the following disclaimer.
5316 * copyright notice, this list of conditions and the following
5320 * 3. Neither the name of the Linux Foundation nor the names of its
5343 * IAccessible2 is a trademark of the Linux Foundation. The IAccessible2
5355 This interface is used for a representation of documents.
5363 of this method is to fetch the anchor target within an HTML document. In this
5392 * 1. Redistributions of source code must retain the above copyright
5393 * notice, this list of conditions and the following disclaimer.
5396 * copyright notice, this list of conditions and the following
5400 * 3. Neither the name of the Linux Foundation nor the names of its
5423 * IAccessible2 is a trademark of the Linux Foundation. The IAccessible2
5429 // This is not a standalone file. It is to be appended to the end of the