public static final class AccessibilityService.MagnificationController
extends Object
java.lang.Object | |
↳ | android.accessibilityservice.AccessibilityService.MagnificationController |
用于控制和查询显示放大倍数的状态。
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
|
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 |
void addListener (AccessibilityService.MagnificationController.OnMagnificationChangedListener listener)
将指定的更改侦听器添加到放大更改侦听器的列表中。 回调将发生在服务的主线程上。
Parameters | |
---|---|
listener |
AccessibilityService.MagnificationController.OnMagnificationChangedListener : the listener to add, must be non-null |
float getCenterX ()
返回放大区域的焦点中心的未缩放屏幕相对X坐标。 这是缩放发生的时间点,并保证位于放大的区域内。
注意:如果服务尚未连接(例如,尚未呼叫 onServiceConnected()
)或服务已断开连接,则此方法将返回默认值 0.0f
。
Returns | |
---|---|
float |
the unscaled screen-relative X coordinate of the center of the magnified region |
float getCenterY ()
返回放大区域焦点中心的缩放屏幕相对Y坐标。 这是缩放发生的时间点,并保证位于放大的区域内。
注意:如果服务尚未连接(例如,尚未呼叫 onServiceConnected()
)或服务已断开连接,则此方法将返回默认值 0.0f
。
Returns | |
---|---|
float |
the unscaled screen-relative Y coordinate of the center of the magnified region |
Region getMagnificationRegion ()
返回当前放大倍数的屏幕区域。 放大比例和中心的更改只会影响屏幕的这一部分。 屏幕的其余部分,例如输入法,不能被放大。 该区域相对于未缩放的屏幕,并且与比例和中心点无关。
如果放大倍数未激活,返回的区域将为空。 如果启用了放大手势或正在运行可控制放大率的服务,则放大功能处于活动状态。
注意:如果服务尚未连接(例如,尚未调用 onServiceConnected()
)或服务已断开连接,则此方法将返回空白区域。
Returns | |
---|---|
Region |
the region of the screen currently active for magnification, or an empty region if magnification is not active. |
float getScale ()
返回当前的放大比例。
注意:如果服务尚未连接(例如,尚未呼叫 onServiceConnected()
)或服务已断开连接,则此方法将返回默认值 1.0f
。
Returns | |
---|---|
float |
the current magnification scale |
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 |
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 |
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 |
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 |