xml/org.freedesktop.atspi.Relation.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <node xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0" name="/node">
   3
   4
   5
   6
   7
   8 <tp:enum name="RelationType" type="u">
   9   <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
  10     <p>RelationType specifies a relationship between objects (possibly one-to-many or many-to-one)
  11       outside of the normal parent/child hierarchical relationship.  It allows better semantic
  12       identification of how objects are associated with one another.
  13       For instance the RELATION_LABELLED_BY relationship may be used to identify labelling information
  14       that should accompany the accessibleName property when presenting an object's content or identity
  15       to the end user.  Similarly, RELATION_CONTROLLER_FOR can be used to further specify the context
  16       in which a valuator is useful, and/or the other UI components which are directly effected by
  17       user interactions with the valuator.  Common examples include association of scrollbars with
  18       the viewport or panel which they control.</p>
  19   </tp:docstring>
  20   <tp:enumvalue suffix="RELATION_NULL">
  21   <tp:docstring>
  22     Not a meaningful relationship; clients should not normally encounter this RelationType value.
  23   </tp:docstring>
  24   </tp:enumvalue>
  25   <tp:enumvalue suffix="RELATION_LABEL_FOR" value="1">
  26   <tp:docstring>
  27     Object is a label for one or more other objects.
  28   </tp:docstring>
  29   </tp:enumvalue>
  30   <tp:enumvalue suffix="RELATION_LABELLED_BY" value="2">
  31   <tp:docstring>
  32     Object is labelled by one or more other objects.
  33   </tp:docstring>
  34   </tp:enumvalue>
  35   <tp:enumvalue suffix="RELATION_CONTROLLER_FOR" value="3">
  36   <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
  37     <p>Object is an interactive object which modifies the state, onscreen location, or other attributes
  38       of one or more target objects. </p>
  39   </tp:docstring>
  40   </tp:enumvalue>
  41   <tp:enumvalue suffix="RELATION_CONTROLLED_BY" value="4">
  42   <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
  43     <p>Object state, position, etc. is modified/controlled by user interaction with one or
  44       more other objects.   For instance a viewport or scroll pane may be CONTROLLED_BY scrollbars. </p>
  45   </tp:docstring>
  46   </tp:enumvalue>
  47   <tp:enumvalue suffix="RELATION_MEMBER_OF" value="5">
  48   <tp:docstring>
  49     Object has a grouping relationship (e.g. ¨same group as¨) to one or more other objects.
  50   </tp:docstring>
  51   </tp:enumvalue>
  52   <tp:enumvalue suffix="RELATION_TOOLTIP_FOR" value="6">
  53   <tp:docstring>
  54     Object is a tooltip associated with another object.
  55   </tp:docstring>
  56   </tp:enumvalue>
  57   <tp:enumvalue suffix="RELATION_NODE_CHILD_OF" value="7">
  58   <tp:docstring>
  59     Reserved for future use.
  60   </tp:docstring>
  61   </tp:enumvalue>
  62   <tp:enumvalue suffix="RELATION_EXTENDED" value="8">
  63   <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
  64     <p>Used to indicate that a relationship exists, but its type is not specified in the enumeration
  65       and must be obtained via a call to getRelationTypeName.  </p>
  66   </tp:docstring>
  67   </tp:enumvalue>
  68   <tp:enumvalue suffix="RELATION_FLOWS_TO" value="9">
  69   <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
  70     <p>Object renders content which flows logically to another object.
  71       For instance, text in a paragraph may flow to another object which is not the
  72       ¨next sibling¨ in the accessibility hierarchy. </p>
  73   </tp:docstring>
  74   </tp:enumvalue>
  75   <tp:enumvalue suffix="RELATION_FLOWS_FROM" value="10">
  76   <tp:docstring>
  77     Reciprocal of RELATION_FLOWS_TO.
  78   </tp:docstring>
  79   </tp:enumvalue>
  80   <tp:enumvalue suffix="RELATION_SUBWINDOW_OF" value="11">
  81   <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
  82     <p>Object is visually and semantically considered a subwindow of another object, even though
  83       it is not the object's child.  Useful when dealing with embedded applications and other cases
  84       where the widget hierarchy does not map cleanly to the onscreen presentation.  </p>
  85   </tp:docstring>
  86   </tp:enumvalue>
  87   <tp:enumvalue suffix="RELATION_EMBEDS" value="12">
  88   <tp:docstring>
  89     Similar to SUBWINDOW_OF, but specifically used for cross-process embedding.
  90   </tp:docstring>
  91   </tp:enumvalue>
  92   <tp:enumvalue suffix="RELATION_EMBEDDED_BY" value="13">
  93   <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
  94     <p>Reciprocal of RELATION_EMBEDS; Used to denote content rendered by embedded renderers that
  95       live in a separate process space from the embedding context.  </p>
  96   </tp:docstring>
  97   </tp:enumvalue>
  98   <tp:enumvalue suffix="RELATION_POPUP_FOR" value="14">
  99   <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
 100     <p>Denotes that the object is a transient window or frame associated with another onscreen object.
 101       Similar to TOOLTIP_FOR, but more general.  Useful for windows which are technically
 102       toplevels but which, for one or more reasons, do not explicitly cause their associated
 103       window to lose ¨window focus¨.   Creation of a ROLE_WINDOW object with the POPUP_FOR relation
 104       usually requires some presentation action on the part of assistive technology clients, even though
 105       the previous toplevel ROLE_FRAME object may still be the active window.  </p>
 106   </tp:docstring>
 107   </tp:enumvalue>
 108   <tp:enumvalue suffix="RELATION_PARENT_WINDOW_OF" value="15">
 109   <tp:docstring>
 110     This is the reciprocal relation to RELATION_POPUP_FOR.
 111   </tp:docstring>
 112   </tp:enumvalue>
 113   <tp:enumvalue suffix="RELATION_DESCRIPTION_FOR" value="16">
 114   <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
 115     <p>Indicates that an object provides descriptive information
 116       about another object; more verbose than RELATION_LABEL_FOR. </p>
 117   </tp:docstring>
 118   </tp:enumvalue>
 119   <tp:enumvalue suffix="RELATION_DESCRIBED_BY" value="17">
 120   <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
 121     <p>Indicates that another object provides descriptive information
 122       about this object; more verbose than RELATION_LABELLED_BY. </p>
 123   </tp:docstring>
 124   </tp:enumvalue>
 125   <tp:enumvalue suffix="RELATION_LAST_DEFINED" value="18">
 126   <tp:docstring>
 127     Do not use as a parameter value, used to determine the size of the enumeration.
 128   </tp:docstring>
 129   </tp:enumvalue>
 130 </tp:enum>
 131 </node>