summaryrefslogtreecommitdiff
path: root/src/imported
diff options
context:
space:
mode:
authorDaniel Juyung Seo <seojuyung2@gmail.com>2014-03-02 00:51:59 +0900
committerDaniel Juyung Seo <seojuyung2@gmail.com>2014-03-02 00:52:26 +0900
commiteba91ac01f5ba3a0e832d49d0f616f73e30433a9 (patch)
tree2a1dc886512e0b06fba58cf077c1dd3016da9f92 /src/imported
parenta02c47440622ccaf8af2dc536e9e01bad38c03d9 (diff)
elm: removing trailing white space ceremony for 1.9 release.
Diffstat (limited to 'src/imported')
-rw-r--r--src/imported/atspi/atspi-constants.h184
1 files changed, 92 insertions, 92 deletions
diff --git a/src/imported/atspi/atspi-constants.h b/src/imported/atspi/atspi-constants.h
index 7a55169f1..6e0551b31 100644
--- a/src/imported/atspi/atspi-constants.h
+++ b/src/imported/atspi/atspi-constants.h
@@ -91,13 +91,13 @@ extern "C" {
91/** 91/**
92 * AtspiLocaleType: 92 * AtspiLocaleType:
93 * @ATSPI_LOCALE_TYPE_MESSAGES: For localizable natural-language messages. 93 * @ATSPI_LOCALE_TYPE_MESSAGES: For localizable natural-language messages.
94 * @ATSPI_LOCALE_TYPE_COLLATE: For regular expression matching and string 94 * @ATSPI_LOCALE_TYPE_COLLATE: For regular expression matching and string
95 * collation. 95 * collation.
96 * @ATSPI_LOCALE_TYPE_CTYPE: For regular expression matching, character 96 * @ATSPI_LOCALE_TYPE_CTYPE: For regular expression matching, character
97 * classification, conversion, case-sensitive comparison, and wide character 97 * classification, conversion, case-sensitive comparison, and wide character
98 * functions. 98 * functions.
99 * @ATSPI_LOCALE_TYPE_MONETARY: For monetary formatting. 99 * @ATSPI_LOCALE_TYPE_MONETARY: For monetary formatting.
100 * @ATSPI_LOCALE_TYPE_NUMERIC: For number formatting (such as the decimal 100 * @ATSPI_LOCALE_TYPE_NUMERIC: For number formatting (such as the decimal
101 * point and the thousands separator). 101 * point and the thousands separator).
102 * @ATSPI_LOCALE_TYPE_TIME: For time and date formatting. 102 * @ATSPI_LOCALE_TYPE_TIME: For time and date formatting.
103 * 103 *
@@ -124,7 +124,7 @@ typedef enum {
124/** 124/**
125 * AtspiCoordType: 125 * AtspiCoordType:
126 * @ATSPI_COORD_TYPE_SCREEN: Specifies xy coordinates relative to the screen. 126 * @ATSPI_COORD_TYPE_SCREEN: Specifies xy coordinates relative to the screen.
127 * @ATSPI_COORD_TYPE_WINDOW: Specifies xy coordinates relative to the widget's 127 * @ATSPI_COORD_TYPE_WINDOW: Specifies xy coordinates relative to the widget's
128 * top-level window. 128 * top-level window.
129 * 129 *
130 * Enumeration used by #AtspiComponent, #AtspiImage, and #AtspiText interfaces 130 * Enumeration used by #AtspiComponent, #AtspiImage, and #AtspiText interfaces
@@ -178,14 +178,14 @@ typedef enum {
178 178
179/** 179/**
180 * AtspiCollectionMatchType: 180 * AtspiCollectionMatchType:
181 * @ATSPI_Collection_MATCH_INVALID: Indicates an error condition or 181 * @ATSPI_Collection_MATCH_INVALID: Indicates an error condition or
182 * uninitialized value. 182 * uninitialized value.
183 * @ATSPI_Collection_MATCH_ALL: #TRUE if all of the criteria are met. 183 * @ATSPI_Collection_MATCH_ALL: #TRUE if all of the criteria are met.
184 * @ATSPI_Collection_MATCH_ANY: #TRUE if any of the criteria are met. 184 * @ATSPI_Collection_MATCH_ANY: #TRUE if any of the criteria are met.
185 * @ATSPI_Collection_MATCH_NONE: #TRUE if none of the criteria are met. 185 * @ATSPI_Collection_MATCH_NONE: #TRUE if none of the criteria are met.
186 * @ATSPI_Collection_MATCH_EMPTY: Same as @ATSPI_Collection_MATCH_ALL if 186 * @ATSPI_Collection_MATCH_EMPTY: Same as @ATSPI_Collection_MATCH_ALL if
187 * the criteria is non-empty; for empty criteria this rule requires returned 187 * the criteria is non-empty; for empty criteria this rule requires returned
188 * value to also have empty set. 188 * value to also have empty set.
189 * @ATSPI_Collection_MATCH_LAST_DEFINED: Used only to determine the end of the 189 * @ATSPI_Collection_MATCH_LAST_DEFINED: Used only to determine the end of the
190 * enumeration. 190 * enumeration.
191 * 191 *
@@ -244,9 +244,9 @@ typedef enum {
244 * UI #AtspiComponent containers. 244 * UI #AtspiComponent containers.
245 * @ATSPI_LAYER_WIDGET: The layer in which the majority of ordinary 245 * @ATSPI_LAYER_WIDGET: The layer in which the majority of ordinary
246 * 'foreground' widgets reside. 246 * 'foreground' widgets reside.
247 * @ATSPI_LAYER_MDI: A special layer between @ATSPI_LAYER_CANVAS and 247 * @ATSPI_LAYER_MDI: A special layer between @ATSPI_LAYER_CANVAS and
248 * @ATSPI_LAYER_WIDGET, in which the 'pseudo windows' (e.g. the MDI frames) 248 * @ATSPI_LAYER_WIDGET, in which the 'pseudo windows' (e.g. the MDI frames)
249 * reside. See #atspi_component_get_mdi_z_order. 249 * reside. See #atspi_component_get_mdi_z_order.
250 * @ATSPI_LAYER_POPUP: A layer for popup window content, above 250 * @ATSPI_LAYER_POPUP: A layer for popup window content, above
251 * @ATSPI_LAYER_WIDGET. 251 * @ATSPI_LAYER_WIDGET.
252 * @ATSPI_LAYER_OVERLAY: The topmost layer. 252 * @ATSPI_LAYER_OVERLAY: The topmost layer.
@@ -255,23 +255,23 @@ typedef enum {
255 * @ATSPI_LAYER_LAST_DEFINED: Used only to determine the end of the 255 * @ATSPI_LAYER_LAST_DEFINED: Used only to determine the end of the
256 * enumeration. 256 * enumeration.
257 * 257 *
258 * The #AtspiComponentLayer of an #AtspiComponent instance indicates its 258 * The #AtspiComponentLayer of an #AtspiComponent instance indicates its
259 * relative stacking order with respect to the onscreen visual representation 259 * relative stacking order with respect to the onscreen visual representation
260 * of the UI. #AtspiComponentLayer, in combination with #AtspiComponent bounds 260 * of the UI. #AtspiComponentLayer, in combination with #AtspiComponent bounds
261 * information, can be used to compute the visibility of all or part of a 261 * information, can be used to compute the visibility of all or part of a
262 * component. This is important in programmatic determination of 262 * component. This is important in programmatic determination of
263 * region-of-interest for magnification, and in 263 * region-of-interest for magnification, and in
264 * flat screen review models of the screen, as well as 264 * flat screen review models of the screen, as well as
265 * for other uses. Objects residing in two of the #AtspiComponentLayer 265 * for other uses. Objects residing in two of the #AtspiComponentLayer
266 * categories support further z-ordering information, with respect to their 266 * categories support further z-ordering information, with respect to their
267 * peers in the same layer: namely, @ATSPI_LAYER_WINDOW and 267 * peers in the same layer: namely, @ATSPI_LAYER_WINDOW and
268 * @ATSPI_LAYER_MDI. Relative stacking order for other objects within the 268 * @ATSPI_LAYER_MDI. Relative stacking order for other objects within the
269 * same layer is not available; the recommended heuristic is 269 * same layer is not available; the recommended heuristic is
270 * first child paints first. In other words, assume that the 270 * first child paints first. In other words, assume that the
271 * first siblings in the child list are subject to being overpainted by later 271 * first siblings in the child list are subject to being overpainted by later
272 * siblings if their bounds intersect. The order of layers, from bottom to top, 272 * siblings if their bounds intersect. The order of layers, from bottom to top,
273 * is: @ATSPI_LAYER_BACKGROUND, @ATSPI_LAYER_WINDOW, @ATSPI_LAYER_MDI, 273 * is: @ATSPI_LAYER_BACKGROUND, @ATSPI_LAYER_WINDOW, @ATSPI_LAYER_MDI,
274 * @ATSPI_LAYER_CANVAS, @ATSPI_LAYER_WIDGET, @ATSPI_LAYER_POPUP, and 274 * @ATSPI_LAYER_CANVAS, @ATSPI_LAYER_WIDGET, @ATSPI_LAYER_POPUP, and
275 * @ATSPI_LAYER_OVERLAY. 275 * @ATSPI_LAYER_OVERLAY.
276 * 276 *
277 */ 277 */
@@ -296,15 +296,15 @@ typedef enum {
296 296
297/** 297/**
298 * AtspiTextBoundaryType: 298 * AtspiTextBoundaryType:
299 * @ATSPI_TEXT_BOUNDARY_CHAR: An #AtspiText instance is bounded by this 299 * @ATSPI_TEXT_BOUNDARY_CHAR: An #AtspiText instance is bounded by this
300 * character only. Start and end offsets differ by one, by definition, 300 * character only. Start and end offsets differ by one, by definition,
301 * for this value. 301 * for this value.
302 * @ATSPI_TEXT_BOUNDARY_WORD_START: Boundary condition is start of a word; i.e. 302 * @ATSPI_TEXT_BOUNDARY_WORD_START: Boundary condition is start of a word; i.e.
303 * range is from start of one word to the start of another word. 303 * range is from start of one word to the start of another word.
304 * @ATSPI_TEXT_BOUNDARY_WORD_END: Boundary condition is the end of a word; i.e. 304 * @ATSPI_TEXT_BOUNDARY_WORD_END: Boundary condition is the end of a word; i.e.
305 * range is from the end of one word to the end of another. Some locales 305 * range is from the end of one word to the end of another. Some locales
306 * may not distinguish between words and characters or glyphs. In particular, 306 * may not distinguish between words and characters or glyphs. In particular,
307 * those locales which use wholly or partially ideographic character sets. 307 * those locales which use wholly or partially ideographic character sets.
308 * In these cases, characters may be returned in lieu of multi-character 308 * In these cases, characters may be returned in lieu of multi-character
309 * substrings. 309 * substrings.
310 * @ATSPI_TEXT_BOUNDARY_SENTENCE_START: Boundary condition is start of a 310 * @ATSPI_TEXT_BOUNDARY_SENTENCE_START: Boundary condition is start of a
@@ -323,7 +323,7 @@ typedef enum {
323 * generally means that an end-of-line character will appear at the end of 323 * generally means that an end-of-line character will appear at the end of
324 * the range. 324 * the range.
325 * @ATSPI_TEXT_BOUNDARY_LINE_END: Boundary condition is the end of a line; i.e. 325 * @ATSPI_TEXT_BOUNDARY_LINE_END: Boundary condition is the end of a line; i.e.
326 * range is from start of one line to the start of another. This generally 326 * range is from start of one line to the start of another. This generally
327 * means that an end-of-line character will be the first character of the 327 * means that an end-of-line character will be the first character of the
328 * range. 328 * range.
329 * 329 *
@@ -379,7 +379,7 @@ typedef enum {
379 379
380/** 380/**
381 * AtspiStateType: 381 * AtspiStateType:
382 * @ATSPI_STATE_INVALID: Indicates an invalid state - probably an error 382 * @ATSPI_STATE_INVALID: Indicates an invalid state - probably an error
383 * condition. 383 * condition.
384 * @ATSPI_STATE_ACTIVE: Indicates a window is currently the active window, or 384 * @ATSPI_STATE_ACTIVE: Indicates a window is currently the active window, or
385 * is an active subelement within a container or table. 385 * is an active subelement within a container or table.
@@ -396,7 +396,7 @@ typedef enum {
396 * @ATSPI_STATE_ENABLED: Indicates that this object is enabled, i.e. that it 396 * @ATSPI_STATE_ENABLED: Indicates that this object is enabled, i.e. that it
397 * currently reflects some application state. Objects that are "greyed out" 397 * currently reflects some application state. Objects that are "greyed out"
398 * may lack this state, and may lack the @ATSPI_STATE_SENSITIVE if direct 398 * may lack this state, and may lack the @ATSPI_STATE_SENSITIVE if direct
399 * user interaction cannot cause them to acquire @ATSPI_STATE_ENABLED. 399 * user interaction cannot cause them to acquire @ATSPI_STATE_ENABLED.
400 * See @ATSPI_STATE_SENSITIVE. 400 * See @ATSPI_STATE_SENSITIVE.
401 * @ATSPI_STATE_EXPANDABLE: Indicates this object allows progressive 401 * @ATSPI_STATE_EXPANDABLE: Indicates this object allows progressive
402 * disclosure of its children. 402 * disclosure of its children.
@@ -433,10 +433,10 @@ typedef enum {
433 * children that has been selected. 433 * children that has been selected.
434 * @ATSPI_STATE_SENSITIVE: Indicates this object is sensitive, e.g. to user 434 * @ATSPI_STATE_SENSITIVE: Indicates this object is sensitive, e.g. to user
435 * interaction. @ATSPI_STATE_SENSITIVE usually accompanies. 435 * interaction. @ATSPI_STATE_SENSITIVE usually accompanies.
436 * @ATSPI_STATE_ENABLED for user-actionable controls, but may be found in the 436 * @ATSPI_STATE_ENABLED for user-actionable controls, but may be found in the
437 * absence of @ATSPI_STATE_ENABLED if the current visible state of the control 437 * absence of @ATSPI_STATE_ENABLED if the current visible state of the control
438 * is "disconnected" from the application state. In such cases, direct user 438 * is "disconnected" from the application state. In such cases, direct user
439 * interaction can often result in the object gaining @ATSPI_STATE_SENSITIVE, 439 * interaction can often result in the object gaining @ATSPI_STATE_SENSITIVE,
440 * for instance if a user makes an explicit selection using an object whose 440 * for instance if a user makes an explicit selection using an object whose
441 * current state is ambiguous or undefined. See @ATSPI_STATE_ENABLED, 441 * current state is ambiguous or undefined. See @ATSPI_STATE_ENABLED,
442 * @ATSPI_STATE_INDETERMINATE. 442 * @ATSPI_STATE_INDETERMINATE.
@@ -448,19 +448,19 @@ typedef enum {
448 * single line of text. 448 * single line of text.
449 * @ATSPI_STATE_STALE: Indicates that the information returned for this object 449 * @ATSPI_STATE_STALE: Indicates that the information returned for this object
450 * may no longer be synchronized with the application state. This can occur 450 * may no longer be synchronized with the application state. This can occur
451 * if the object has @ATSPI_STATE_TRANSIENT, and can also occur towards the 451 * if the object has @ATSPI_STATE_TRANSIENT, and can also occur towards the
452 * end of the object peer's lifecycle. 452 * end of the object peer's lifecycle.
453 * @ATSPI_STATE_TRANSIENT: Indicates this object is transient. 453 * @ATSPI_STATE_TRANSIENT: Indicates this object is transient.
454 * @ATSPI_STATE_VERTICAL: Indicates the orientation of this object is vertical; 454 * @ATSPI_STATE_VERTICAL: Indicates the orientation of this object is vertical;
455 * for example this state may appear on such objects as scrollbars, text 455 * for example this state may appear on such objects as scrollbars, text
456 * objects (with vertical text flow), separators, etc. 456 * objects (with vertical text flow), separators, etc.
457 * @ATSPI_STATE_VISIBLE: Indicates this object is visible, e.g. has been 457 * @ATSPI_STATE_VISIBLE: Indicates this object is visible, e.g. has been
458 * explicitly marked for exposure to the user. @ATSPI_STATE_VISIBLE is no 458 * explicitly marked for exposure to the user. @ATSPI_STATE_VISIBLE is no
459 * guarantee that the object is actually unobscured on the screen, only that 459 * guarantee that the object is actually unobscured on the screen, only that
460 * it is 'potentially' visible, barring obstruction, being scrolled or clipped 460 * it is 'potentially' visible, barring obstruction, being scrolled or clipped
461 * out of the field of view, or having an ancestor container that has not yet 461 * out of the field of view, or having an ancestor container that has not yet
462 * made visible. A widget is potentially onscreen if it has both 462 * made visible. A widget is potentially onscreen if it has both
463 * @ATSPI_STATE_VISIBLE and @ATSPI_STATE_SHOWING. The absence of 463 * @ATSPI_STATE_VISIBLE and @ATSPI_STATE_SHOWING. The absence of
464 * @ATSPI_STATE_VISIBLE and @ATSPI_STATE_SHOWING is 464 * @ATSPI_STATE_VISIBLE and @ATSPI_STATE_SHOWING is
465 * semantically equivalent to saying that an object is 'hidden'. 465 * semantically equivalent to saying that an object is 'hidden'.
466 * @ATSPI_STATE_MANAGES_DESCENDANTS: Indicates that "active-descendant-changed" 466 * @ATSPI_STATE_MANAGES_DESCENDANTS: Indicates that "active-descendant-changed"
@@ -469,14 +469,14 @@ typedef enum {
469 * in very large containers, like tables. The presence of 469 * in very large containers, like tables. The presence of
470 * @ATSPI_STATE_MANAGES_DESCENDANTS is an indication to the client that the 470 * @ATSPI_STATE_MANAGES_DESCENDANTS is an indication to the client that the
471 * children should not, and need not, be enumerated by the client. 471 * children should not, and need not, be enumerated by the client.
472 * Objects implementing this state are expected to provide relevant state 472 * Objects implementing this state are expected to provide relevant state
473 * notifications to listening clients, for instance notifications of 473 * notifications to listening clients, for instance notifications of
474 * visibility changes and activation of their contained child objects, without 474 * visibility changes and activation of their contained child objects, without
475 * the client having previously requested references to those children. 475 * the client having previously requested references to those children.
476 * @ATSPI_STATE_INDETERMINATE: Indicates that a check box or other boolean 476 * @ATSPI_STATE_INDETERMINATE: Indicates that a check box or other boolean
477 * indicator is in a state other than checked or not checked. This 477 * indicator is in a state other than checked or not checked. This
478 * usually means that the boolean value reflected or controlled by the 478 * usually means that the boolean value reflected or controlled by the
479 * object does not apply consistently to the entire current context. 479 * object does not apply consistently to the entire current context.
480 * For example, a checkbox for the "Bold" attribute of text may have 480 * For example, a checkbox for the "Bold" attribute of text may have
481 * @ATSPI_STATE_INDETERMINATE if the currently selected text contains a mixture 481 * @ATSPI_STATE_INDETERMINATE if the currently selected text contains a mixture
482 * of weight attributes. In many cases interacting with a 482 * of weight attributes. In many cases interacting with a
@@ -495,13 +495,13 @@ typedef enum {
495 * representation becomes static. Some applications, notably content viewers, 495 * representation becomes static. Some applications, notably content viewers,
496 * may not be able to detect all kinds of animated content. Therefore the 496 * may not be able to detect all kinds of animated content. Therefore the
497 * absence of this state should not be taken as 497 * absence of this state should not be taken as
498 * definitive evidence that the object's visual representation is 498 * definitive evidence that the object's visual representation is
499 * static; this state is advisory. 499 * static; this state is advisory.
500 * @ATSPI_STATE_INVALID_ENTRY: This object has indicated an error condition 500 * @ATSPI_STATE_INVALID_ENTRY: This object has indicated an error condition
501 * due to failure of input validation. For instance, a form control may 501 * due to failure of input validation. For instance, a form control may
502 * acquire this state in response to invalid or malformed user input. 502 * acquire this state in response to invalid or malformed user input.
503 * @ATSPI_STATE_SUPPORTS_AUTOCOMPLETION: This state indicates that the object 503 * @ATSPI_STATE_SUPPORTS_AUTOCOMPLETION: This state indicates that the object
504 * in question implements some form of typeahead or 504 * in question implements some form of typeahead or
505 * pre-selection behavior whereby entering the first character of one or more 505 * pre-selection behavior whereby entering the first character of one or more
506 * sub-elements causes those elements to scroll into view or become 506 * sub-elements causes those elements to scroll into view or become
507 * selected. Subsequent character input may narrow the selection further as 507 * selected. Subsequent character input may narrow the selection further as
@@ -514,7 +514,7 @@ typedef enum {
514 * question supports text selection. It should only be exposed on objects 514 * question supports text selection. It should only be exposed on objects
515 * which implement the #AtspiText interface, in order to distinguish this state 515 * which implement the #AtspiText interface, in order to distinguish this state
516 * from @ATSPI_STATE_SELECTABLE, which infers that the object in question is a 516 * from @ATSPI_STATE_SELECTABLE, which infers that the object in question is a
517 * selectable child of an object which implements #AtspiSelection. While 517 * selectable child of an object which implements #AtspiSelection. While
518 * similar, text selection and subelement selection are distinct operations. 518 * similar, text selection and subelement selection are distinct operations.
519 * @ATSPI_STATE_IS_DEFAULT: This state indicates that the object in question is 519 * @ATSPI_STATE_IS_DEFAULT: This state indicates that the object in question is
520 * the 'default' interaction object in a dialog, i.e. the one that gets 520 * the 'default' interaction object in a dialog, i.e. the one that gets
@@ -527,8 +527,8 @@ typedef enum {
527 * as a parameter, it indicates the number of items in the #AtspiStateType 527 * as a parameter, it indicates the number of items in the #AtspiStateType
528 * enumeration. 528 * enumeration.
529 * 529 *
530 * 530 *
531 * Enumeration used by various interfaces indicating every possible state 531 * Enumeration used by various interfaces indicating every possible state
532 * an #AtspiAccesible object can assume. 532 * an #AtspiAccesible object can assume.
533 * 533 *
534 **/ 534 **/
@@ -606,18 +606,18 @@ typedef enum {
606 606
607/** 607/**
608 * AtspiEventType: 608 * AtspiEventType:
609 * @ATSPI_KEY_PRESSED_EVENT: Indicates that a key on a keyboard device was 609 * @ATSPI_KEY_PRESSED_EVENT: Indicates that a key on a keyboard device was
610 * pressed. 610 * pressed.
611 * @ATSPI_KEY_RELEASED_EVENT: Indicates that a key on a keyboard device was 611 * @ATSPI_KEY_RELEASED_EVENT: Indicates that a key on a keyboard device was
612 * released. 612 * released.
613 * @ATSPI_BUTTON_PRESSED_EVENT: Indicates that a button on a non-keyboard 613 * @ATSPI_BUTTON_PRESSED_EVENT: Indicates that a button on a non-keyboard
614 * human interface device (HID) was pressed. 614 * human interface device (HID) was pressed.
615 * @ATSPI_BUTTON_RELEASED_EVENT: Indicates that a button on a non-keyboard 615 * @ATSPI_BUTTON_RELEASED_EVENT: Indicates that a button on a non-keyboard
616 * human interface device (HID) was released. 616 * human interface device (HID) was released.
617 * 617 *
618 * Enumeration used to specify the event types of interest to an 618 * Enumeration used to specify the event types of interest to an
619 * #AtspiEventListener, or 619 * #AtspiEventListener, or
620 * to identify the type of an event for which notification has been sent. 620 * to identify the type of an event for which notification has been sent.
621 * 621 *
622 **/ 622 **/
623typedef enum { 623typedef enum {
@@ -642,13 +642,13 @@ typedef enum {
642 * ofa hardware keyboard key. 642 * ofa hardware keyboard key.
643 * @ATSPI_KEY_SYM: A symbolic key event is generated, without specifying a 643 * @ATSPI_KEY_SYM: A symbolic key event is generated, without specifying a
644 * hardware key. Note: if the keysym is not present in the current keyboard 644 * hardware key. Note: if the keysym is not present in the current keyboard
645 * map, the #AtspiDeviceEventController instance has a limited ability to 645 * map, the #AtspiDeviceEventController instance has a limited ability to
646 * generate such keysyms on-the-fly. Reliability of GenerateKeyboardEvent 646 * generate such keysyms on-the-fly. Reliability of GenerateKeyboardEvent
647 * calls using out-of-keymap keysyms will vary from system to system, and on 647 * calls using out-of-keymap keysyms will vary from system to system, and on
648 * the number of different out-of-keymap being generated in quick succession. 648 * the number of different out-of-keymap being generated in quick succession.
649 * In practice this is rarely significant, since the keysyms of interest to 649 * In practice this is rarely significant, since the keysyms of interest to
650 * AT clients and keyboard emulators are usually part of the current keymap, 650 * AT clients and keyboard emulators are usually part of the current keymap,
651 * i.e. present on the system keyboard for the current locale (even if a 651 * i.e. present on the system keyboard for the current locale (even if a
652 * physical hardware keyboard is not connected. 652 * physical hardware keyboard is not connected.
653 * @ATSPI_KEY_STRING: A string is converted to its equivalent keyboard events 653 * @ATSPI_KEY_STRING: A string is converted to its equivalent keyboard events
654 * and emitted. If the string consists of complex character or composed 654 * and emitted. If the string consists of complex character or composed
@@ -725,7 +725,7 @@ typedef enum {
725 * modifies the state, onscreen location, or other attributes of one or more 725 * modifies the state, onscreen location, or other attributes of one or more
726 * target objects. 726 * target objects.
727 * @ATSPI_RELATION_CONTROLLED_BY: Object state, position, etc. is 727 * @ATSPI_RELATION_CONTROLLED_BY: Object state, position, etc. is
728 * modified/controlled by user interaction with one or more other objects. 728 * modified/controlled by user interaction with one or more other objects.
729 * For instance a viewport or scroll pane may be @ATSPI_RELATION_CONTROLLED_BY 729 * For instance a viewport or scroll pane may be @ATSPI_RELATION_CONTROLLED_BY
730 * scrollbars. 730 * scrollbars.
731 * @ATSPI_RELATION_MEMBER_OF: Object has a grouping relationship (e.g. 'same 731 * @ATSPI_RELATION_MEMBER_OF: Object has a grouping relationship (e.g. 'same
@@ -741,10 +741,10 @@ typedef enum {
741 * object which is not the 'next sibling' in the accessibility hierarchy. 741 * object which is not the 'next sibling' in the accessibility hierarchy.
742 * @ATSPI_RELATION_FLOWS_FROM: Reciprocal of @ATSPI_RELATION_FLOWS_TO. 742 * @ATSPI_RELATION_FLOWS_FROM: Reciprocal of @ATSPI_RELATION_FLOWS_TO.
743 * @ATSPI_RELATION_SUBWINDOW_OF: Object is visually and semantically considered 743 * @ATSPI_RELATION_SUBWINDOW_OF: Object is visually and semantically considered
744 * a subwindow of another object, even though it is not the object's child. 744 * a subwindow of another object, even though it is not the object's child.
745 * Useful when dealing with embedded applications and other cases where the 745 * Useful when dealing with embedded applications and other cases where the
746 * widget hierarchy does not map cleanly to the onscreen presentation. 746 * widget hierarchy does not map cleanly to the onscreen presentation.
747 * @ATSPI_RELATION_EMBEDS: Similar to @ATSPI_RELATION_SUBWINDOW_OF, but 747 * @ATSPI_RELATION_EMBEDS: Similar to @ATSPI_RELATION_SUBWINDOW_OF, but
748 * specifically used for cross-process embedding. 748 * specifically used for cross-process embedding.
749 * @ATSPI_RELATION_EMBEDDED_BY: Reciprocal of @ATSPI_RELATION_EMBEDS. Used to 749 * @ATSPI_RELATION_EMBEDDED_BY: Reciprocal of @ATSPI_RELATION_EMBEDS. Used to
750 * denote content rendered by embedded renderers that live in a separate process 750 * denote content rendered by embedded renderers that live in a separate process
@@ -752,9 +752,9 @@ typedef enum {
752 * @ATSPI_RELATION_POPUP_FOR: Denotes that the object is a transient window or 752 * @ATSPI_RELATION_POPUP_FOR: Denotes that the object is a transient window or
753 * frame associated with another onscreen object. Similar to @ATSPI_TOOLTIP_FOR, 753 * frame associated with another onscreen object. Similar to @ATSPI_TOOLTIP_FOR,
754 * but more general. Useful for windows which are technically toplevels 754 * but more general. Useful for windows which are technically toplevels
755 * but which, for one or more reasons, do not explicitly cause their 755 * but which, for one or more reasons, do not explicitly cause their
756 * associated window to lose 'window focus'. Creation of an @ATSPI_ROLE_WINDOW 756 * associated window to lose 'window focus'. Creation of an @ATSPI_ROLE_WINDOW
757 * object with the @ATSPI_RELATION_POPUP_FOR relation usually requires 757 * object with the @ATSPI_RELATION_POPUP_FOR relation usually requires
758 * some presentation action on the part 758 * some presentation action on the part
759 * of assistive technology clients, even though the previous toplevel 759 * of assistive technology clients, even though the previous toplevel
760 * @ATSPI_ROLE_FRAME object may still be the active window. 760 * @ATSPI_ROLE_FRAME object may still be the active window.
@@ -767,24 +767,24 @@ typedef enum {
767 * descriptive information about this object; more verbose than 767 * descriptive information about this object; more verbose than
768 * @ATSPI_RELATION_LABELLED_BY. 768 * @ATSPI_RELATION_LABELLED_BY.
769 * @ATSPI_RELATION_LAST_DEFINED: Do not use as a parameter value, used to 769 * @ATSPI_RELATION_LAST_DEFINED: Do not use as a parameter value, used to
770 * determine the size of the enumeration. 770 * determine the size of the enumeration.
771 * 771 *
772 * #AtspiRelationType specifies a relationship between objects 772 * #AtspiRelationType specifies a relationship between objects
773 * (possibly one-to-many 773 * (possibly one-to-many
774 * or many-to-one) outside of the normal parent/child hierarchical 774 * or many-to-one) outside of the normal parent/child hierarchical
775 * relationship. It allows better semantic identification of how objects 775 * relationship. It allows better semantic identification of how objects
776 * are associated with one another. For instance the 776 * are associated with one another. For instance the
777 * @ATSPI_RELATION_LABELLED_BY 777 * @ATSPI_RELATION_LABELLED_BY
778 * relationship may be used to identify labelling information that should 778 * relationship may be used to identify labelling information that should
779 * accompany the accessible name property when presenting an object's content or 779 * accompany the accessible name property when presenting an object's content or
780 * identity to the end user. Similarly, 780 * identity to the end user. Similarly,
781 * @ATSPI_RELATION_CONTROLLER_FOR can be used 781 * @ATSPI_RELATION_CONTROLLER_FOR can be used
782 * to further specify the context in which a valuator is useful, and/or the 782 * to further specify the context in which a valuator is useful, and/or the
783 * other UI components which are directly effected by user interactions with 783 * other UI components which are directly effected by user interactions with
784 * the valuator. Common examples include association of scrollbars with the 784 * the valuator. Common examples include association of scrollbars with the
785 * viewport or panel which they control. 785 * viewport or panel which they control.
786 * 786 *
787 * 787 *
788 * Enumeration used to specify 788 * Enumeration used to specify
789 * the type of relation encapsulated in an #AtspiRelation object. 789 * the type of relation encapsulated in an #AtspiRelation object.
790 * 790 *
@@ -862,7 +862,7 @@ typedef enum {
862 * etc. 862 * etc.
863 * @ATSPI_ROLE_GLASS_PANE: A pane that is guaranteed to be painted on top of 863 * @ATSPI_ROLE_GLASS_PANE: A pane that is guaranteed to be painted on top of
864 * all panes beneath it. 864 * all panes beneath it.
865 * @ATSPI_ROLE_HTML_CONTAINER: A document container for HTML, whose children 865 * @ATSPI_ROLE_HTML_CONTAINER: A document container for HTML, whose children
866 * represent the document content. 866 * represent the document content.
867 * @ATSPI_ROLE_ICON: A small fixed size picture, typically used to decorate 867 * @ATSPI_ROLE_ICON: A small fixed size picture, typically used to decorate
868 * components. 868 * components.
@@ -913,7 +913,7 @@ typedef enum {
913 * @ATSPI_ROLE_SCROLL_PANE: An object that allows a user to incrementally view 913 * @ATSPI_ROLE_SCROLL_PANE: An object that allows a user to incrementally view
914 * a large amount of information. @ATSPI_ROLE_SCROLL_PANE objects are usually 914 * a large amount of information. @ATSPI_ROLE_SCROLL_PANE objects are usually
915 * accompanied by @ATSPI_ROLE_SCROLL_BAR controllers, on which the 915 * accompanied by @ATSPI_ROLE_SCROLL_BAR controllers, on which the
916 * @ATSPI_RELATION_CONTROLLER_FOR and @ATSPI_RELATION_CONTROLLED_BY 916 * @ATSPI_RELATION_CONTROLLER_FOR and @ATSPI_RELATION_CONTROLLED_BY
917 * reciprocal relations are set. See #atspi_get_relation_set. 917 * reciprocal relations are set. See #atspi_get_relation_set.
918 * @ATSPI_ROLE_SEPARATOR: An object usually contained in a menu to provide a 918 * @ATSPI_ROLE_SEPARATOR: An object usually contained in a menu to provide a
919 * visible and logical separation of the contents in a menu. 919 * visible and logical separation of the contents in a menu.
@@ -921,7 +921,7 @@ typedef enum {
921 * range. 921 * range.
922 * @ATSPI_ROLE_SPIN_BUTTON: An object which allows one of a set of choices to 922 * @ATSPI_ROLE_SPIN_BUTTON: An object which allows one of a set of choices to
923 * be selected, and which displays the current choice. Unlike 923 * be selected, and which displays the current choice. Unlike
924 * @ATSPI_ROLE_SCROLL_BAR, @ATSPI_ROLE_SLIDER objects need not control 924 * @ATSPI_ROLE_SCROLL_BAR, @ATSPI_ROLE_SLIDER objects need not control
925 * 'viewport'-like objects. 925 * 'viewport'-like objects.
926 * @ATSPI_ROLE_SPLIT_PANE: A specialized panel that presents two other panels 926 * @ATSPI_ROLE_SPLIT_PANE: A specialized panel that presents two other panels
927 * at the same time. 927 * at the same time.
@@ -930,7 +930,7 @@ typedef enum {
930 * @ATSPI_ROLE_TABLE: An object used to repesent information in terms of rows 930 * @ATSPI_ROLE_TABLE: An object used to repesent information in terms of rows
931 * and columns. 931 * and columns.
932 * @ATSPI_ROLE_TABLE_CELL: A 'cell' or discrete child within a Table. Note: 932 * @ATSPI_ROLE_TABLE_CELL: A 'cell' or discrete child within a Table. Note:
933 * Table cells need not have @ATSPI_ROLE_TABLE_CELL, other 933 * Table cells need not have @ATSPI_ROLE_TABLE_CELL, other
934 * #AtspiRoleType values are valid as well. 934 * #AtspiRoleType values are valid as well.
935 * @ATSPI_ROLE_TABLE_COLUMN_HEADER: An object which labels a particular column 935 * @ATSPI_ROLE_TABLE_COLUMN_HEADER: An object which labels a particular column
936 * in an #AtspiTable. 936 * in an #AtspiTable.
@@ -954,7 +954,7 @@ typedef enum {
954 * user. 954 * user.
955 * @ATSPI_ROLE_TREE_TABLE: An object that presents both tabular and 955 * @ATSPI_ROLE_TREE_TABLE: An object that presents both tabular and
956 * hierarchical info to the user. 956 * hierarchical info to the user.
957 * @ATSPI_ROLE_UNKNOWN: The object contains some #AtspiAccessible information, 957 * @ATSPI_ROLE_UNKNOWN: The object contains some #AtspiAccessible information,
958 * but its role is not known. 958 * but its role is not known.
959 * @ATSPI_ROLE_VIEWPORT: An object usually used in a scroll pane, or to 959 * @ATSPI_ROLE_VIEWPORT: An object usually used in a scroll pane, or to
960 * otherwise clip a larger object or content renderer to a specific 960 * otherwise clip a larger object or content renderer to a specific
@@ -966,11 +966,11 @@ typedef enum {
966 * @ATSPI_ROLE_FOOTER: An object that serves as a document footer. 966 * @ATSPI_ROLE_FOOTER: An object that serves as a document footer.
967 * @ATSPI_ROLE_PARAGRAPH: An object which is contains a single paragraph of 967 * @ATSPI_ROLE_PARAGRAPH: An object which is contains a single paragraph of
968 * text content. See also @ATSPI_ROLE_TEXT. 968 * text content. See also @ATSPI_ROLE_TEXT.
969 * @ATSPI_ROLE_RULER: An object which describes margins and tab stops, etc. 969 * @ATSPI_ROLE_RULER: An object which describes margins and tab stops, etc.
970 * for text objects which it controls (should have 970 * for text objects which it controls (should have
971 * @ATSPI_RELATION_CONTROLLER_FOR relation to such). 971 * @ATSPI_RELATION_CONTROLLER_FOR relation to such).
972 * @ATSPI_ROLE_APPLICATION: An object corresponding to the toplevel accessible 972 * @ATSPI_ROLE_APPLICATION: An object corresponding to the toplevel accessible
973 * of an application, which may contain @ATSPI_ROLE_FRAME objects or other 973 * of an application, which may contain @ATSPI_ROLE_FRAME objects or other
974 * accessible objects. Children of #AccessibleDesktop objects are generally 974 * accessible objects. Children of #AccessibleDesktop objects are generally
975 * @ATSPI_ROLE_APPLICATION objects. 975 * @ATSPI_ROLE_APPLICATION objects.
976 * @ATSPI_ROLE_AUTOCOMPLETE: The object is a dialog or list containing items 976 * @ATSPI_ROLE_AUTOCOMPLETE: The object is a dialog or list containing items
@@ -984,13 +984,13 @@ typedef enum {
984 * and for embedding of out-of-process component, "panel applets", etc. 984 * and for embedding of out-of-process component, "panel applets", etc.
985 * @ATSPI_ROLE_ENTRY: The object is a component whose textual content may be 985 * @ATSPI_ROLE_ENTRY: The object is a component whose textual content may be
986 * entered or modified by the user, provided @ATSPI_STATE_EDITABLE is present. 986 * entered or modified by the user, provided @ATSPI_STATE_EDITABLE is present.
987 * A readonly @ATSPI_ROLE_ENTRY object (i.e. where @ATSPI_STATE_EDITABLE is 987 * A readonly @ATSPI_ROLE_ENTRY object (i.e. where @ATSPI_STATE_EDITABLE is
988 * not present) implies a read-only 'text field' in a form, as opposed to a 988 * not present) implies a read-only 'text field' in a form, as opposed to a
989 * title, label, or caption. 989 * title, label, or caption.
990 * @ATSPI_ROLE_CHART: The object is a graphical depiction of quantitative data. 990 * @ATSPI_ROLE_CHART: The object is a graphical depiction of quantitative data.
991 * It may contain multiple subelements whose attributes and/or description 991 * It may contain multiple subelements whose attributes and/or description
992 * may be queried to obtain both the quantitative data and information about 992 * may be queried to obtain both the quantitative data and information about
993 * how the data is being presented. The @ATSPI_LABELLED_BY relation is 993 * how the data is being presented. The @ATSPI_LABELLED_BY relation is
994 * particularly important in interpreting objects of this type, as is the 994 * particularly important in interpreting objects of this type, as is the
995 * accessible description property. See @ATSPI_ROLE_CAPTION. 995 * accessible description property. See @ATSPI_ROLE_CAPTION.
996 * @ATSPI_ROLE_CAPTION: The object contains descriptive information, usually 996 * @ATSPI_ROLE_CAPTION: The object contains descriptive information, usually
@@ -1000,7 +1000,7 @@ typedef enum {
1000 * contains a view of document content. #AtspiDocument frames may occur within 1000 * contains a view of document content. #AtspiDocument frames may occur within
1001 * another #AtspiDocument instance, in which case the second document may be 1001 * another #AtspiDocument instance, in which case the second document may be
1002 * said to be embedded in the containing instance. HTML frames are often 1002 * said to be embedded in the containing instance. HTML frames are often
1003 * @ATSPI_ROLE_DOCUMENT_FRAME: Either this object, or a singleton descendant, 1003 * @ATSPI_ROLE_DOCUMENT_FRAME: Either this object, or a singleton descendant,
1004 * should implement the #AtspiDocument interface. 1004 * should implement the #AtspiDocument interface.
1005 * @ATSPI_ROLE_HEADING: The object serves as a heading for content which 1005 * @ATSPI_ROLE_HEADING: The object serves as a heading for content which
1006 * follows it in a document. The 'heading level' of the heading, if 1006 * follows it in a document. The 'heading level' of the heading, if
@@ -1018,22 +1018,22 @@ typedef enum {
1018 * this role should be ignored by clients, if they are encountered at all. 1018 * this role should be ignored by clients, if they are encountered at all.
1019 * @ATSPI_ROLE_FORM: The object is a containing instance of document content 1019 * @ATSPI_ROLE_FORM: The object is a containing instance of document content
1020 * which has within it components with which the user can interact in order 1020 * which has within it components with which the user can interact in order
1021 * to input information; i.e. the object is a container for pushbuttons, 1021 * to input information; i.e. the object is a container for pushbuttons,
1022 * comboboxes, text input fields, and other 'GUI' components. @ATSPI_ROLE_FORM 1022 * comboboxes, text input fields, and other 'GUI' components. @ATSPI_ROLE_FORM
1023 * should not, in general, be used for toplevel GUI containers or dialogs, 1023 * should not, in general, be used for toplevel GUI containers or dialogs,
1024 * but should be reserved for 'GUI' containers which occur within document 1024 * but should be reserved for 'GUI' containers which occur within document
1025 * content, for instance within Web documents, presentations, or text 1025 * content, for instance within Web documents, presentations, or text
1026 * documents. Unlike other GUI containers and dialogs which occur inside 1026 * documents. Unlike other GUI containers and dialogs which occur inside
1027 * application instances, @ATSPI_ROLE_FORM containers' components are 1027 * application instances, @ATSPI_ROLE_FORM containers' components are
1028 * associated with the current document, rather than the current foreground 1028 * associated with the current document, rather than the current foreground
1029 * application or viewer instance. 1029 * application or viewer instance.
1030 * @ATSPI_ROLE_LINK: The object is a hypertext anchor, i.e. a "link" in a 1030 * @ATSPI_ROLE_LINK: The object is a hypertext anchor, i.e. a "link" in a
1031 * hypertext document. Such objects are distinct from 'inline' content 1031 * hypertext document. Such objects are distinct from 'inline' content
1032 * which may also use the #AtspiHypertext/#AtspiHyperlink interfacesto indicate 1032 * which may also use the #AtspiHypertext/#AtspiHyperlink interfacesto indicate
1033 * the range/location within a text object where an inline or embedded object 1033 * the range/location within a text object where an inline or embedded object
1034 * lies. 1034 * lies.
1035 * @ATSPI_ROLE_INPUT_METHOD_WINDOW: The object is a window or similar viewport 1035 * @ATSPI_ROLE_INPUT_METHOD_WINDOW: The object is a window or similar viewport
1036 * which is used to allow composition or input of a 'complex character', 1036 * which is used to allow composition or input of a 'complex character',
1037 * in other words it is an "input method window". 1037 * in other words it is an "input method window".
1038 * @ATSPI_ROLE_TABLE_ROW: A row in a table. 1038 * @ATSPI_ROLE_TABLE_ROW: A row in a table.
1039 * @ATSPI_ROLE_TREE_ITEM: An object that represents an element of a tree. 1039 * @ATSPI_ROLE_TREE_ITEM: An object that represents an element of a tree.