AccessibilityButtonController
public
final
class
AccessibilityButtonController
extends Object
java.lang.Object | |
↳ | android.accessibilityservice.AccessibilityButtonController |
Controller for the accessibility button within the system's navigation area
This class may be used to query the accessibility button's state and register
callbacks for interactions with and state changes to the accessibility button when
AccessibilityServiceInfo.FLAG_REQUEST_ACCESSIBILITY_BUTTON
is set.
Note: This class and
AccessibilityServiceInfo.FLAG_REQUEST_ACCESSIBILITY_BUTTON
should not be used as
the sole means for offering functionality to users via an AccessibilityService
.
Some device implementations may choose not to provide a software-rendered system
navigation area, making this affordance permanently unavailable.
Note: On device implementations where the accessibility button is
supported, it may not be available at all times, such as when a foreground application uses
View.SYSTEM_UI_FLAG_HIDE_NAVIGATION
. A user may also choose to assign
this button to another accessibility service or feature. In each of these cases, a
registered AccessibilityButtonCallback
's
AccessibilityButtonCallback.onAvailabilityChanged(AccessibilityButtonController, boolean)
method will be invoked to provide notifications of changes in the accessibility button's
availability to the registering service.
Summary
Nested classes | |
---|---|
class |
AccessibilityButtonController.AccessibilityButtonCallback
Callback for interaction with and changes to state of the accessibility button within the system's navigation area. |
Public methods | |
---|---|
boolean
|
isAccessibilityButtonAvailable()
Retrieves whether the accessibility button in the system's navigation area is available to the calling service. |
void
|
registerAccessibilityButtonCallback(AccessibilityButtonController.AccessibilityButtonCallback callback, Handler handler)
Registers the provided |
void
|
registerAccessibilityButtonCallback(AccessibilityButtonController.AccessibilityButtonCallback callback)
Registers the provided |
void
|
unregisterAccessibilityButtonCallback(AccessibilityButtonController.AccessibilityButtonCallback callback)
Unregisters the provided |
Inherited methods | |
---|---|
Public methods
isAccessibilityButtonAvailable
public boolean isAccessibilityButtonAvailable ()
Retrieves whether the accessibility button in the system's navigation area is available to the calling service.
Note: If the service is not yet connected (e.g.
AccessibilityService.onServiceConnected()
has not yet been called) or the
service has been disconnected, this method will have no effect and return false
.
Returns | |
---|---|
boolean |
true if the accessibility button in the system's navigation area is
available to the calling service, false otherwise |
registerAccessibilityButtonCallback
public void registerAccessibilityButtonCallback (AccessibilityButtonController.AccessibilityButtonCallback callback, Handler handler)
Registers the provided AccessibilityButtonCallback
for interaction and state
change callbacks related to the accessibility button. The callback will occur on the
specified Handler
's thread, or on the services's main thread if the handler is
null
.
Parameters | |
---|---|
callback |
AccessibilityButtonController.AccessibilityButtonCallback : the callback to add, must be non-null |
handler |
Handler : the handler on which the callback should execute, must be non-null |
registerAccessibilityButtonCallback
public void registerAccessibilityButtonCallback (AccessibilityButtonController.AccessibilityButtonCallback callback)
Registers the provided AccessibilityButtonCallback
for interaction and state
changes callbacks related to the accessibility button.
Parameters | |
---|---|
callback |
AccessibilityButtonController.AccessibilityButtonCallback : the callback to add, must be non-null |
unregisterAccessibilityButtonCallback
public void unregisterAccessibilityButtonCallback (AccessibilityButtonController.AccessibilityButtonCallback callback)
Unregisters the provided AccessibilityButtonCallback
for interaction and state
change callbacks related to the accessibility button.
Parameters | |
---|---|
callback |
AccessibilityButtonController.AccessibilityButtonCallback : the callback to remove, must be non-null |
Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
Last updated 2024-12-18 UTC.
pFad - (p)hone/(F)rame/(a)nonymizer/(d)eclutterfier! Saves Data!
--- a PPN by Garber Painting Akron. With Image Size Reduction included!
Fetched URL: http://developer.android.com/reference/android/accessibilityservice/AccessibilityButtonController
Alternative Proxies: