新增 setWindowLocation 方法来代替 setGravity、setXOffset、setYOffset 方法

Author: getActivity

README.md

@@ -267,12 +267,9 @@ easyWindow.setWidth(int width);
 // 设置悬浮窗高度
 easyWindow.setHeight(int height);
 
-// 设置悬浮窗显示的重心
-easyWindow.setGravity(int gravity);
-// 设置水平偏移量
-easyWindow.setXOffset(int px);
-// 设置垂直偏移量
-easyWindow.setYOffset(int px);
+// 设置悬浮窗的位置
+easyWindow.setWindowLocation(@Px int x, @Px int y);
+easyWindow.setWindowLocation(@GravityFlag int gravity, @Px int x, @Px int y);
 
 // 设置悬浮窗外层是否可触摸
 easyWindow.setOutsideTouchable(boolean touchable);

app/src/main/java/com/hjq/window/demo/MainActivity.java

@@ -371,13 +371,12 @@ public void onDenied(@NonNull List<String> permissions, boolean doNotAskAgain) {
         } else if (viewId == R.id.btn_main_utils) {
 
             EasyWindow.with(this)
-                    .setWindowDuration(1000)
                     // 将 Toaster 中的 View 转移给 EasyWindow 来显示
                     .setContentView(Toaster.getStyle().createView(this))
+                    .setWindowLocation(Gravity.BOTTOM, 0, 100)
+                    .setWindowDuration(1000)
                     .setAnimStyle(R.style.ScaleAnimStyle)
                     .setTextByTextView(android.R.id.message, "就问你溜不溜")
-                    .setGravity(Gravity.BOTTOM)
-                    .setYOffset(100)
                     .show();
         }
     }
@@ -422,8 +421,7 @@ public void onWindowDraggingStop(@NonNull EasyWindow<?> easyWindow) {
         // 传入 Application 表示这个是一个全局的 Toast
         EasyWindow.with(application)
                 .setContentView(R.layout.window_phone)
-                .setGravity(Gravity.END | Gravity.BOTTOM)
-                .setYOffset(200)
+                .setWindowLocation(Gravity.END | Gravity.BOTTOM, 0, 200)
                 // 设置指定的拖拽规则
                 .setWindowDraggableRule(springBackWindowDraggableRule)
                 .setOnClickListenerByView(android.R.id.icon, new OnWindowViewClickListener<ImageView>() {

app/src/main/java/com/hjq/window/demo/SemiStealthWindow.java

@@ -44,9 +44,7 @@ protected void initWindow(@NonNull Context context) {
 
         setContentView(R.layout.window_semi_stealth);
 
-        setGravity(Gravity.START | Gravity.TOP);
-        setXOffset(0);
-        setYOffset(200);
+        setWindowLocation(0, 200);
 
         SpringBackWindowDraggableRule springBackWindowDraggableRule = new SpringBackWindowDraggableRule(
             SpringBackWindowDraggableRule.ORIENTATION_HORIZONTAL);

library/src/main/java/com/hjq/window/EasyWindow.java

@@ -553,8 +553,37 @@ public X setHeight(int height) {
         return (X) this;
     }
 
+    /**
+     * 设置窗口位置
+     *
+     * @param gravity           窗口重心
+     * @param x                 x 坐标
+     * @param y                 y 坐标
+     */
+    public X setWindowLocation(@GravityFlag int gravity, @Px int x, @Px int y) {
+        mWindowParams.gravity = gravity;
+        mWindowParams.x = x;
+        mWindowParams.y = y;
+        postUpdate();
+        post(() -> {
+            if (mWindowDraggableRule != null) {
+                mWindowDraggableRule.refreshLocationCoordinate();
+            }
+        });
+        return (X) this;
+    }
+
+    public X setWindowLocation(@Px int x, @Px int y) {
+        // 默认设置屏幕的重心为左上角，需要注意的一个点是，这里不能设置成 Gravity.START | Gravity.TOP，
+        // 在 Android 中，无论是否设置布局方向（如 RTL 右到左布局 ），屏幕坐标系的原点始终是屏幕左上角，
+        // 布局方向的调整主要影响的是视图的排列顺序、绘制顺序等逻辑，不会改变基础坐标系的原点位置。
+        return setWindowLocation(Gravity.LEFT | Gravity.TOP, x, y);
+    }
+
     /**
      * 设置悬浮窗显示的重心
+     *
+     * @deprecated           该 API 已经过时，随时会被删除，请尽早迁移到 {@link #setWindowLocation(int, int, int)}
      */
     public X setGravity(@GravityFlag int gravity) {
         mWindowParams.gravity = gravity;
@@ -569,6 +598,8 @@ public X setGravity(@GravityFlag int gravity) {
 
     /**
      * 设置水平偏移量
+     *
+     * @deprecated           该 API 已经过时，随时会被删除，请尽早迁移到 {@link #setWindowLocation(int, int)}
      */
     public X setXOffset(@Px int px) {
         mWindowParams.x = px;
@@ -583,6 +614,8 @@ public X setXOffset(@Px int px) {
 
     /**
      * 设置垂直偏移量
+     *
+     * @deprecated           该 API 已经过时，随时会被删除，请尽早迁移到 {@link #setWindowLocation(int, int)}
      */
     public X setYOffset(@Px int px) {
         mWindowParams.y = px;