javax.accessibility

## Class AccessibleRelation

- java.lang.Object
- - javax.accessibility.AccessibleBundle
  - - javax.accessibility.AccessibleRelation

-     public class AccessibleRelation
      extends AccessibleBundle

  Class AccessibleRelation describes a relation between the object that implements the AccessibleRelation and one or more other objects. The actual relations that an object has with other objects are defined as an AccessibleRelationSet, which is a composed set of AccessibleRelations.

  The toDisplayString method allows you to obtain the localized string for a locale independent key from a predefined ResourceBundle for the keys defined in this class.

  The constants in this class present a strongly typed enumeration of common object roles. If the constants in this class are not sufficient to describe the role of an object, a subclass should be generated from this class and it should provide constants in a similar manner.

  Since:
    1.3

- - ### Field Summary

    Fields
    Modifier and Type | Field and Description
    --- | ---
    `static String` | `CHILD_NODE_OF` Indicates that an object is a child node of one or more objects.
    `static String` | `CHILD_NODE_OF_PROPERTY` Indicates the CHILD_NODE_OF relation between two or more objects has changed.
    `static String` | `CONTROLLED_BY` Indicates an object is controlled by one or more target objects.
    `static String` | `CONTROLLED_BY_PROPERTY` Identifies that the target object that is doing the controlling has changed
    `static String` | `CONTROLLER_FOR` Indicates an object is a controller for one or more target objects.
    `static String` | `CONTROLLER_FOR_PROPERTY` Identifies that the controller for the target object has changed
    `static String` | `EMBEDDED_BY` Indicates that an object is embedded in one or more objects.
    `static String` | `EMBEDDED_BY_PROPERTY` Indicates the EMBEDDED_BY relation between two or more objects has changed.
    `static String` | `EMBEDS` Indicates that an object has one or more objects embedded in it.
    `static String` | `EMBEDS_PROPERTY` Indicates the EMBEDS relation between two or more objects has changed.
    `static String` | `FLOWS_FROM` Indicates an object is logically contiguous with a second object where the second object occurs before the object.
    `static String` | `FLOWS_FROM_PROPERTY` Indicates the FLOWS_FROM relation between two objects has changed.
    `static String` | `FLOWS_TO` Indicates an object is logically contiguous with a second object where the second object occurs after the object.
    `static String` | `FLOWS_TO_PROPERTY` Indicates the FLOWS_TO relation between two objects has changed.
    `static String` | `LABEL_FOR` Indicates an object is a label for one or more target objects.
    `static String` | `LABEL_FOR_PROPERTY` Identifies that the target group for a label has changed
    `static String` | `LABELED_BY` Indicates an object is labeled by one or more target objects.
    `static String` | `LABELED_BY_PROPERTY` Identifies that the objects that are doing the labeling have changed
    `static String` | `MEMBER_OF` Indicates an object is a member of a group of one or more target objects.
    `static String` | `MEMBER_OF_PROPERTY` Identifies that group membership has changed.
    `static String` | `PARENT_WINDOW_OF` Indicates that an object is a parent window of one or more objects.
    `static String` | `PARENT_WINDOW_OF_PROPERTY` Indicates the PARENT_WINDOW_OF relation between two or more objects has changed.
    `static String` | `SUBWINDOW_OF` Indicates that an object is a subwindow of one or more objects.
    `static String` | `SUBWINDOW_OF_PROPERTY` Indicates the SUBWINDOW_OF relation between two or more objects has changed.

    - ### Fields inherited from class javax.accessibility.AccessibleBundle

      `key`

  - ### Constructor Summary

    Constructors
    Constructor and Description
    `AccessibleRelation(String key)` Create a new AccessibleRelation using the given locale independent key.
    `AccessibleRelation(String key, Object target)` Creates a new AccessibleRelation using the given locale independent key.
    `AccessibleRelation(String key, Object[] target)` Creates a new AccessibleRelation using the given locale independent key.

  - ### Method Summary

    Methods
    Modifier and Type | Method and Description
    --- | ---
    `String` | `getKey()` Returns the key for this relation
    `Object[]` | `getTarget()` Returns the target objects for this relation
    `void` | `setTarget(Object target)` Sets the target object for this relation
    `void` | `setTarget(Object[] target)` Sets the target objects for this relation

    - ### Methods inherited from class javax.accessibility.AccessibleBundle

      `toDisplayString, toDisplayString, toDisplayString, toString`

    - ### Methods inherited from class java.lang.Object

      `clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait`

- - ### Field Detail

    - #### LABEL_FOR

          public static final String LABEL_FOR

      Indicates an object is a label for one or more target objects.
      See Also:
        `getTarget()`, `CONTROLLER_FOR`, `CONTROLLED_BY`, `LABELED_BY`, `MEMBER_OF`

    - #### LABELED_BY

          public static final String LABELED_BY

      Indicates an object is labeled by one or more target objects.
      See Also:
        `getTarget()`, `CONTROLLER_FOR`, `CONTROLLED_BY`, `LABEL_FOR`, `MEMBER_OF`

    - #### MEMBER_OF

          public static final String MEMBER_OF

      Indicates an object is a member of a group of one or more target objects.
      See Also:
        `getTarget()`, `CONTROLLER_FOR`, `CONTROLLED_BY`, `LABEL_FOR`, `LABELED_BY`

    - #### CONTROLLER_FOR

          public static final String CONTROLLER_FOR

      Indicates an object is a controller for one or more target objects.
      See Also:
        `getTarget()`, `CONTROLLED_BY`, `LABEL_FOR`, `LABELED_BY`, `MEMBER_OF`

    - #### CONTROLLED_BY

          public static final String CONTROLLED_BY

      Indicates an object is controlled by one or more target objects.
      See Also:
        `getTarget()`, `CONTROLLER_FOR`, `LABEL_FOR`, `LABELED_BY`, `MEMBER_OF`

    - #### FLOWS_TO

          public static final String FLOWS_TO

      Indicates an object is logically contiguous with a second object where the second object occurs after the object. An example is a paragraph of text that runs to the end of a page and continues on the next page with an intervening text footer and/or text header. The two parts of the paragraph are separate text elements but are related in that the second element is a continuation of the first element. In other words, the first element "flows to" the second element.
      Since:
        1.5
      See Also:
        Constant Field Values

    - #### FLOWS_FROM

          public static final String FLOWS_FROM

      Indicates an object is logically contiguous with a second object where the second object occurs before the object. An example is a paragraph of text that runs to the end of a page and continues on the next page with an intervening text footer and/or text header. The two parts of the paragraph are separate text elements but are related in that the second element is a continuation of the first element. In other words, the second element "flows from" the second element.
      Since:
        1.5
      See Also:
        Constant Field Values

    - #### SUBWINDOW_OF

          public static final String SUBWINDOW_OF

      Indicates that an object is a subwindow of one or more objects.
      Since:
        1.5
      See Also:
        Constant Field Values

    - #### PARENT_WINDOW_OF

          public static final String PARENT_WINDOW_OF

      Indicates that an object is a parent window of one or more objects.
      Since:
        1.5
      See Also:
        Constant Field Values

    - #### EMBEDS

          public static final String EMBEDS

      Indicates that an object has one or more objects embedded in it.
      Since:
        1.5
      See Also:
        Constant Field Values

    - #### EMBEDDED_BY

          public static final String EMBEDDED_BY

      Indicates that an object is embedded in one or more objects.
      Since:
        1.5
      See Also:
        Constant Field Values

    - #### CHILD_NODE_OF

          public static final String CHILD_NODE_OF

      Indicates that an object is a child node of one or more objects.
      Since:
        1.5
      See Also:
        Constant Field Values

    - #### LABEL_FOR_PROPERTY

          public static final String LABEL_FOR_PROPERTY

      Identifies that the target group for a label has changed
      See Also:
        Constant Field Values

    - #### LABELED_BY_PROPERTY

          public static final String LABELED_BY_PROPERTY

      Identifies that the objects that are doing the labeling have changed
      See Also:
        Constant Field Values

    - #### MEMBER_OF_PROPERTY

          public static final String MEMBER_OF_PROPERTY

      Identifies that group membership has changed.
      See Also:
        Constant Field Values

    - #### CONTROLLER_FOR_PROPERTY

          public static final String CONTROLLER_FOR_PROPERTY

      Identifies that the controller for the target object has changed
      See Also:
        Constant Field Values

    - #### CONTROLLED_BY_PROPERTY

          public static final String CONTROLLED_BY_PROPERTY

      Identifies that the target object that is doing the controlling has changed
      See Also:
        Constant Field Values

    - #### FLOWS_TO_PROPERTY

          public static final String FLOWS_TO_PROPERTY

      Indicates the FLOWS_TO relation between two objects has changed.
      Since:
        1.5
      See Also:
        Constant Field Values

    - #### FLOWS_FROM_PROPERTY

          public static final String FLOWS_FROM_PROPERTY

      Indicates the FLOWS_FROM relation between two objects has changed.
      Since:
        1.5
      See Also:
        Constant Field Values

    - #### SUBWINDOW_OF_PROPERTY

          public static final String SUBWINDOW_OF_PROPERTY

      Indicates the SUBWINDOW_OF relation between two or more objects has changed.
      Since:
        1.5
      See Also:
        Constant Field Values

    - #### PARENT_WINDOW_OF_PROPERTY

          public static final String PARENT_WINDOW_OF_PROPERTY

      Indicates the PARENT_WINDOW_OF relation between two or more objects has changed.
      Since:
        1.5
      See Also:
        Constant Field Values

    - #### EMBEDS_PROPERTY

          public static final String EMBEDS_PROPERTY

      Indicates the EMBEDS relation between two or more objects has changed.
      Since:
        1.5
      See Also:
        Constant Field Values

    - #### EMBEDDED_BY_PROPERTY

          public static final String EMBEDDED_BY_PROPERTY

      Indicates the EMBEDDED_BY relation between two or more objects has changed.
      Since:
        1.5
      See Also:
        Constant Field Values

    - #### CHILD_NODE_OF_PROPERTY

          public static final String CHILD_NODE_OF_PROPERTY

      Indicates the CHILD_NODE_OF relation between two or more objects has changed.
      Since:
        1.5
      See Also:
        Constant Field Values

  - ### Constructor Detail

    - #### AccessibleRelation

          public AccessibleRelation(String key)

      Create a new AccessibleRelation using the given locale independent key. The key String should be a locale independent key for the relation. It is not intended to be used as the actual String to display to the user. To get the localized string, use toDisplayString.
      Parameters:
        `key` - the locale independent name of the relation.
      See Also:
        `AccessibleBundle.toDisplayString(java.lang.String, java.util.Locale)`

    - #### AccessibleRelation

          public AccessibleRelation(String key,
                            Object target)

      Creates a new AccessibleRelation using the given locale independent key. The key String should be a locale independent key for the relation. It is not intended to be used as the actual String to display to the user. To get the localized string, use toDisplayString.
      Parameters:
        `key` - the locale independent name of the relation.
        `target` - the target object for this relation
      See Also:
        `AccessibleBundle.toDisplayString(java.lang.String, java.util.Locale)`

    - #### AccessibleRelation

          public AccessibleRelation(String key,
                            Object[] target)

      Creates a new AccessibleRelation using the given locale independent key. The key String should be a locale independent key for the relation. It is not intended to be used as the actual String to display to the user. To get the localized string, use toDisplayString.
      Parameters:
        `key` - the locale independent name of the relation.
        `target` - the target object(s) for this relation
      See Also:
        `AccessibleBundle.toDisplayString(java.lang.String, java.util.Locale)`

  - ### Method Detail

    - #### getKey

          public String getKey()

      Returns the key for this relation
      Returns:
        the key for this relation
      See Also:
        `CONTROLLER_FOR`, `CONTROLLED_BY`, `LABEL_FOR`, `LABELED_BY`, `MEMBER_OF`

    - #### getTarget

          public Object[] getTarget()

      Returns the target objects for this relation
      Returns:
        an array containing the target objects for this relation

    - #### setTarget

          public void setTarget(Object target)

      Sets the target object for this relation
      Parameters:
        `target` - the target object for this relation

    - #### setTarget

          public void setTarget(Object[] target)

      Sets the target objects for this relation
      Parameters:
        `target` - an array containing the target objects for this relation

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.

Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.