Instance Method

accessibilitySetOverrideValue:forAttribute:

Overrides the specified attribute in the receiver or adds it if it does not exist, and sets its value to the specified value.

Declaration

- (BOOL)accessibilitySetOverrideValue:(id)value forAttribute:(NSAccessibilityAttributeName)attribute;

Parameters

value

The attribute value to be set.

attribute

The name of the attribute. See Constants for lists of attribute names.

Return Value

YES if the override was successful; otherwise, NO.

Discussion

This method is for changing the set of attributes on an instance, as an alternative to subclassing.

This method works only on objects whose class already implements the NSAccessibility protocol. If the specified attribute is already supported by the object, the value specified by this method wins.

If the specified attribute does not exist, it is created outside the NSAccessibility protocol, so accessibilityAttributeNames still returns the old list, which does not contain the new attribute. Likewise, accessibilityAttributeValue does not return attributes created by the override process nor does it return their overridden values.

The values of overridden attributes are not settable by accessibility clients.

If you need to undo the effect of using this method, call it again, passing nil for the value.

Ensure that you invoke this method on the actual object that represents the user interface element. For example, for NSButton, use the underlying NSButtonCell object. NSButton itself is ignored by accessibility.

This method works only on an object representing a single user interface element. So, for example, you cannot use it when a single object represents multiple user interface elements, as with NSSegmentedCell, which has only a single object but provides user interface elements for each segment.

See Also

Deprecated Methods

- accessibilityActionDescription:

Returns a localized description of the specified action.

Deprecated
- accessibilityActionNames

Returns an array of action names supported by the accessibility element.

Deprecated
- accessibilityArrayAttributeCount:

Returns the count of the specified accessibility array attribute.

- accessibilityArrayAttributeValues:index:maxCount:

Returns a subarray of values of an accessibility array attribute.

- accessibilityAttributeNames

Returns an array of attribute names supported by the receiver.

Deprecated
- accessibilityAttributeValue:

Returns the value of the specified attribute in the receiver.

Deprecated
- accessibilityAttributeValue:forParameter:

Returns the value of the receiver's parameterized attribute corresponding to the specified attribute name and parameter.

Deprecated
- accessibilityIndexOfChild:

Returns the index of the specified accessibility child in the parent.

- accessibilityIsAttributeSettable:

Returns a Boolean value that indicates whether the value for the specified attribute in the receiver can be set.

Deprecated
- accessibilityIsIgnored

Returns a Boolean value indicating whether the receiver should be ignored in the parent-child accessibility hierarchy.

Deprecated
- accessibilityParameterizedAttributeNames

Returns a list of parameterized attribute names supported by the receiver.

Deprecated
- accessibilityPerformAction:

Performs the action associated with the specified action.

Deprecated
- accessibilitySetValue:forAttribute:

Sets the value of the specified attribute in the receiver to the specified value.

Deprecated