类: Rect

ui_object.Rect

矩形类。表示一个矩形范围。通常用于表示 UI 控件的位置和大小，或 OCR 识别结果的位置范围。

目录

Constructors

• constructor

Properties

• bottom
• left
• right
• top

Accessors

• centerX
• centerY
• height
• width

方法

• fromJava
• sort

Constructors

constructor

• new Rect(left, top, right, bottom): Rect

构造矩形对象。

示例

"nodejs";
const { Rect } = require("ui_object");

// 创建一个矩形，表示从 (10, 20) 到 (100, 200) 的区域
const rect = new Rect(10, 20, 100, 200);
console.log(`矩形宽度: ${rect.width}, 高度: ${rect.height}`);
console.log(`中心点: (${rect.centerX}, ${rect.centerY})`);

参数

名称	类型	描述
left	number	矩形左上角的 X 坐标
top	number	矩形左上角的 Y 坐标
right	number	矩形右下角的 X 坐标
bottom	number	矩形右下角的 Y 坐标

返回值

Rect

返回创建的矩形对象。

Properties

left

• left: number

矩形左上角的 X 坐标。

示例

"nodejs";
const { Rect } = require("ui_object");

const rect = new Rect(10, 20, 100, 200);
console.log(`左边距: ${rect.left}`); // 输出: 左边距: 10

---

top

• top: number

矩形左上角的 Y 坐标。

示例

"nodejs";
const { Rect } = require("ui_object");

const rect = new Rect(10, 20, 100, 200);
console.log(`上边距: ${rect.top}`); // 输出: 上边距: 20

---

right

• right: number

矩形右下角的 X 坐标。

示例

"nodejs";
const { Rect } = require("ui_object");

const rect = new Rect(10, 20, 100, 200);
console.log(`右边距: ${rect.right}`); // 输出: 右边距: 100

---

bottom

• bottom: number

矩形右下角的 Y 坐标。

示例

"nodejs";
const { Rect } = require("ui_object");

const rect = new Rect(10, 20, 100, 200);
console.log(`下边距: ${rect.bottom}`); // 输出: 下边距: 200

Accessors

width

• get width(): number

获取矩形的宽度。计算方式为 right - left。

示例

"nodejs";
const { Rect } = require("ui_object");

const rect = new Rect(10, 20, 100, 200);
console.log(`宽度: ${rect.width}`); // 输出: 宽度: 90

返回值

number

矩形的宽度（像素）。

---

height

• get height(): number

获取矩形的高度。计算方式为 bottom - top。

示例

"nodejs";
const { Rect } = require("ui_object");

const rect = new Rect(10, 20, 100, 200);
console.log(`高度: ${rect.height}`); // 输出: 高度: 180

返回值

number

矩形的高度（像素）。

---

centerX

• get centerX(): number

获取矩形的中心点 X 坐标。计算方式为 (left + right) / 2。

示例

"nodejs";
const { Rect } = require("ui_object");

const rect = new Rect(10, 20, 100, 200);
console.log(`中心 X: ${rect.centerX}`); // 输出: 中心 X: 55

返回值

number

矩形中心点的 X 坐标。

---

centerY

• get centerY(): number

获取矩形的中心点 Y 坐标。计算方式为 (top + bottom) / 2。

示例

"nodejs";
const { Rect } = require("ui_object");

const rect = new Rect(10, 20, 100, 200);
console.log(`中心 Y: ${rect.centerY}`); // 输出: 中心 Y: 110

返回值

number

矩形中心点的 Y 坐标。

方法

sort

▸ sort(): Rect

排序矩形属性。当 left 值大于 right 值，或者 top 值大于 bottom 值时，将其交换。

示例

"nodejs";
const { Rect } = require("ui_object");

// 创建一个坐标顺序错误的矩形
const rect = new Rect(100, 200, 10, 20);
console.log(`排序前: left=${rect.left}, right=${rect.right}`); // left=100, right=10

// 排序矩形
const sortedRect = rect.sort();
console.log(`排序后: left=${sortedRect.left}, right=${sortedRect.right}`); // left=10, right=100

返回值

Rect

排序后的矩形对象。

---

fromJava

▸ Static fromJava(javaRect): Rect

从 Java 矩形对象构造矩形。

示例

"nodejs";
const { Rect } = require("ui_object");

// 假设有一个 Java Rect 对象
const javaRect = /* ... */;
const rect = Rect.fromJava(javaRect);
console.log(`矩形: (${rect.left}, ${rect.top}) - (${rect.right}, ${rect.bottom})`);

参数

名称	类型	描述
javaRect	any	Java 矩形对象（android.graphics.Rect）

返回值

Rect

返回创建的矩形对象。