/* * Copyright (C) 2009 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package android.view.accessibility; import com.android.annotations.NonNull; import android.accessibilityservice.AccessibilityServiceInfo; import android.content.Context; import android.content.pm.ServiceInfo; import android.view.IWindow; import android.view.View; import java.util.Collections; import java.util.List; /** * System level service that serves as an event dispatch for {@link AccessibilityEvent}s. * Such events are generated when something notable happens in the user interface, * for example an {@link android.app.Activity} starts, the focus or selection of a * {@link android.view.View} changes etc. Parties interested in handling accessibility * events implement and register an accessibility service which extends * {@code android.accessibilityservice.AccessibilityService}. * * @see AccessibilityEvent * @see android.content.Context#getSystemService */ @SuppressWarnings("UnusedDeclaration") public final class AccessibilityManager { private static AccessibilityManager sInstance = new AccessibilityManager(null, null, 0); /** * Listener for the accessibility state. */ public interface AccessibilityStateChangeListener { /** * Called back on change in the accessibility state. * * @param enabled Whether accessibility is enabled. */ public void onAccessibilityStateChanged(boolean enabled); } /** * Listener for the system touch exploration state. To listen for changes to * the touch exploration state on the device, implement this interface and * register it with the system by calling * {@link #addTouchExplorationStateChangeListener}. */ public interface TouchExplorationStateChangeListener { /** * Called when the touch exploration enabled state changes. * * @param enabled Whether touch exploration is enabled. */ public void onTouchExplorationStateChanged(boolean enabled); } /** * Listener for the system high text contrast state. To listen for changes to * the high text contrast state on the device, implement this interface and * register it with the system by calling * {@link #addHighTextContrastStateChangeListener}. */ public interface HighTextContrastChangeListener { /** * Called when the high text contrast enabled state changes. * * @param enabled Whether high text contrast is enabled. */ public void onHighTextContrastStateChanged(boolean enabled); } private final IAccessibilityManagerClient.Stub mClient = new IAccessibilityManagerClient.Stub() { public void setState(int state) { } }; /** * Get an AccessibilityManager instance (create one if necessary). * */ public static AccessibilityManager getInstance(Context context) { return sInstance; } /** * Create an instance. * * @param context A {@link Context}. */ public AccessibilityManager(Context context, IAccessibilityManager service, int userId) { } public IAccessibilityManagerClient getClient() { return mClient; } /** * Returns if the {@link AccessibilityManager} is enabled. * * @return True if this {@link AccessibilityManager} is enabled, false otherwise. */ public boolean isEnabled() { return false; } /** * Returns if the touch exploration in the system is enabled. * * @return True if touch exploration is enabled, false otherwise. */ public boolean isTouchExplorationEnabled() { return true; } /** * Returns if the high text contrast in the system is enabled. *
* Note: You need to query this only if you application is * doing its own rendering and does not rely on the platform rendering pipeline. *
* */ public boolean isHighTextContrastEnabled() { return false; } /** * Sends an {@link AccessibilityEvent}. */ public void sendAccessibilityEvent(AccessibilityEvent event) { } /** * Requests interruption of the accessibility feedback from all accessibility services. */ public void interrupt() { } /** * Returns the {@link ServiceInfo}s of the installed accessibility services. * * @return An unmodifiable list with {@link ServiceInfo}s. */ @Deprecated public List