Most visited

Recently visited

Added in API level 24

AccessibilityService.MagnificationController

public static final class AccessibilityService.MagnificationController
extends Object

java.lang.Object
   ↳ android.accessibilityservice.AccessibilityService.MagnificationController


用于控制和查询显示放大倍数的状态。

Summary

Nested classes

interface AccessibilityService.MagnificationController.OnMagnificationChangedListener

听众对放大状态的改变。

Public methods

void addListener(AccessibilityService.MagnificationController.OnMagnificationChangedListener listener, Handler handler)

将指定的更改侦听器添加到放大更改侦听器的列表中。

void addListener(AccessibilityService.MagnificationController.OnMagnificationChangedListener listener)

将指定的更改侦听器添加到放大更改侦听器的列表中。

float getCenterX()

返回放大区域的焦点中心的未缩放屏幕相对X坐标。

float getCenterY()

返回放大区域焦点中心的缩放屏幕相对Y坐标。

Region getMagnificationRegion()

返回当前放大倍数的屏幕区域。

float getScale()

返回当前的放大比例。

boolean removeListener(AccessibilityService.MagnificationController.OnMagnificationChangedListener listener)

从放大更改侦听器列表中删除指定更改侦听器的所有实例。

boolean reset(boolean animate)

将放大比例和中心重置为其默认值(例如,

boolean setCenter(float centerX, float centerY, boolean animate)

设置放大视口的中心。

boolean setScale(float scale, boolean animate)

设置放大比例。

Inherited methods

From class java.lang.Object

Public methods

addListener

Added in API level 24
void addListener (AccessibilityService.MagnificationController.OnMagnificationChangedListener listener, 
                Handler handler)

将指定的更改侦听器添加到放大更改侦听器的列表中。 回调将发生在指定的Handler的线程上,或者如果处理程序为null在服务的主线程上null

Parameters
listener AccessibilityService.MagnificationController.OnMagnificationChangedListener: the listener to add, must be non-null
handler Handler: the handler on which the callback should execute, or null to execute on the service's main thread

addListener

Added in API level 24
void addListener (AccessibilityService.MagnificationController.OnMagnificationChangedListener listener)

将指定的更改侦听器添加到放大更改侦听器的列表中。 回调将发生在服务的主线程上。

Parameters
listener AccessibilityService.MagnificationController.OnMagnificationChangedListener: the listener to add, must be non-null

getCenterX

Added in API level 24
float getCenterX ()

返回放大区域的焦点中心的未缩放屏幕相对X坐标。 这是缩放发生的时间点,并保证位于放大的区域内。

注意:如果服务尚未连接(例如,尚未呼叫 onServiceConnected() )或服务已断开连接,则此方法将返回默认值 0.0f

Returns
float the unscaled screen-relative X coordinate of the center of the magnified region

getCenterY

Added in API level 24
float getCenterY ()

返回放大区域焦点中心的缩放屏幕相对Y坐标。 这是缩放发生的时间点,并保证位于放大的区域内。

注意:如果服务尚未连接(例如,尚未呼叫 onServiceConnected() )或服务已断开连接,则此方法将返回默认值 0.0f

Returns
float the unscaled screen-relative Y coordinate of the center of the magnified region

getMagnificationRegion

Added in API level 24
Region getMagnificationRegion ()

返回当前放大倍数的屏幕区域。 放大比例和中心的更改只会影响屏幕的这一部分。 屏幕的其余部分,例如输入法,不能被放大。 该区域相对于未缩放的屏幕,并且与比例和中心点无关。

如果放大倍数未激活,返回的区域将为空。 如果启用了放大手势或正在运行可控制放大率的服务,则放大功能处于活动状态。

注意:如果服务尚未连接(例如,尚未调用 onServiceConnected() )或服务已断开连接,则此方法将返回空白区域。

Returns
Region the region of the screen currently active for magnification, or an empty region if magnification is not active.

getScale

Added in API level 24
float getScale ()

返回当前的放大比例。

注意:如果服务尚未连接(例如,尚未呼叫 onServiceConnected() )或服务已断开连接,则此方法将返回默认值 1.0f

Returns
float the current magnification scale

removeListener

Added in API level 24
boolean removeListener (AccessibilityService.MagnificationController.OnMagnificationChangedListener listener)

从放大更改侦听器列表中删除指定更改侦听器的所有实例。

Parameters
listener AccessibilityService.MagnificationController.OnMagnificationChangedListener: the listener to remove, must be non-null
Returns
boolean true if at least one instance of the listener was removed

reset

Added in API level 24
boolean reset (boolean animate)

将放大比例和中心重置为默认值(例如,不放大)。

注意:如果服务尚未连接(例如 onServiceConnected()尚未被呼叫)或服务已断开连接,则此方法不起作用并返回 false

Parameters
animate boolean: true to animate from the current scale and center or false to reset the scale and center immediately
Returns
boolean true on success, false on failure

setCenter

Added in API level 24
boolean setCenter (float centerX, 
                float centerY, 
                boolean animate)

设置放大视口的中心。

注意:如果服务尚未连接(例如,尚未呼叫 onServiceConnected() )或服务已断开连接,则此方法将不起作用并返回 false

Parameters
centerX float: the unscaled screen-relative X coordinate on which to center the viewport
centerY float: the unscaled screen-relative Y coordinate on which to center the viewport
animate boolean: true to animate from the current viewport center or false to set the center immediately
Returns
boolean true on success, false on failure

setScale

Added in API level 24
boolean setScale (float scale, 
                boolean animate)

设置放大比例。

注意:如果服务尚未连接(例如,尚未呼叫 onServiceConnected() )或服务已断开连接,则此方法将不起作用并返回 false

Parameters
scale float: the magnification scale to set, must be >= 1 and <= 5
animate boolean: true to animate from the current scale or false to set the scale immediately
Returns
boolean true on success, false on failure

Hooray!