输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
CTRL+K
文档管理中心
全部文档
指南
API
开放能力API
高级筛选
API version全部版本
设备全部
元服务API集不筛选
您当前正在浏览HarmonyOS最新文档，覆盖已发布的所有API版本，可在API参考中筛选您使用的API版本。详细的版本配套关系请参考版本说明。
开发与测试开放能力API图形ArkGraphics 2D（方舟2D图形服务）ArkTS API@ohos.graphics.drawing (绘制模块)Class (RectUtils)

Class (RectUtils)

Phone20+PC/2in120+Tablet20+TV20+Wearable20+
更新时间: 2026-08-29 09:41
本文导读
展开章节

提供处理矩形的工具，支持矩形的快速构建与基本属性获取、边界计算与调整、平移与状态判断、边界规范化等功能。

主要的使用场景：

  1. 矩形快速构建与获取基本属性，如构造新矩形、拷贝矩形、获取矩形的宽高以及中心点等。

  2. 边界计算与调整，如判断包含关系、计算与更新矩形之间交集和并集，更新边界值等。

  3. 矩形平移与状态判断，如对矩形进行平移、将矩形平移到指定位置、判断矩形是否为空以及判断两个矩形是否相等。

  4. 矩形边界规范化，如对存在反转情况的矩形边界值进行交换排序等。

说明

  • 本模块首批接口从API version 11开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

  • 本Class首批接口从API version 20开始支持。

  • 本模块使用屏幕物理像素单位px。

  • 本模块为单线程模型策略，需要调用方自行管理线程安全和上下文状态的切换。

导入模块

收起
自动换行
深色代码主题
复制
  1. import { drawing } from '@kit.ArkGraphics2D';

makeEmpty20+

Phone20+PC/2in120+Tablet20+TV20+Wearable20+

static makeEmpty(): common2D.Rect

创建一个上下左右边界坐标都是0的矩形。

系统能力： SystemCapability.Graphics.Drawing

返回值：

展开
类型 说明
common2D.Rect 创建的矩形对象。

示例：

收起
自动换行
深色代码主题
复制
  1. import { drawing } from '@kit.ArkGraphics2D';
  2. 

  3. let rect = drawing.RectUtils.makeEmpty();

makeLtrb20+

Phone20+PC/2in120+Tablet20+TV20+Wearable20+

static makeLtrb(left: number, top: number, right: number, bottom: number): common2D.Rect

创建指定上下左右边界的矩形。

系统能力： SystemCapability.Graphics.Drawing

参数：

展开
参数名 类型 必填 说明
left number 是 矩形的左上角x轴坐标，该参数为浮点数。0表示坐标原点，负数表示位于坐标原点左侧，正数表示位于坐标原点右侧。单位为物理像素px。
top number 是 矩形的左上角y轴坐标，该参数为浮点数。0表示坐标原点，负数表示位于坐标原点上侧，正数表示位于坐标原点下侧。单位为物理像素px。
right number 是 矩形的右下角x轴坐标，该参数为浮点数。0表示坐标原点，负数表示位于坐标原点左侧，正数表示位于坐标原点右侧。单位为物理像素px。
bottom number 是 矩形的右下角y轴坐标，该参数为浮点数。0表示坐标原点，负数表示位于坐标原点上侧，正数表示位于坐标原点下侧。单位为物理像素px。

返回值：

展开
类型 说明
common2D.Rect 创建的矩形。

示例：

收起
自动换行
深色代码主题
复制
  1. import { drawing } from '@kit.ArkGraphics2D';
  2. 

  3. let rect = drawing.RectUtils.makeLtrb(10, 10, 20, 20);

makeCopy20+

Phone20+PC/2in120+Tablet20+TV20+Wearable20+

static makeCopy(src: common2D.Rect): common2D.Rect

拷贝一个矩形。

系统能力： SystemCapability.Graphics.Drawing

参数：

展开
参数名 类型 必填 说明
src common2D.Rect 是 用于拷贝的矩形。

返回值：

展开
类型 说明
common2D.Rect 创建的新矩形。

示例：

收起
自动换行
深色代码主题
复制
  1. import { drawing } from '@kit.ArkGraphics2D';
  2. 

  3. let rect = drawing.RectUtils.makeLtrb(10, 10, 20, 20);
  4. let rect2 = drawing.RectUtils.makeCopy(rect);
  5. console.info('rect2.left: ', rect2.left);
  6. console.info('rect2.top: ', rect2.top);
  7. console.info('rect2.right: ', rect2.right);
  8. console.info('rect2.bottom: ', rect2.bottom);

getWidth20+

Phone20+PC/2in120+Tablet20+TV20+Wearable20+

static getWidth(rect: common2D.Rect): number

获取矩形的宽度。

系统能力： SystemCapability.Graphics.Drawing

参数：

展开
参数名 类型 必填 说明
rect common2D.Rect 是 需要获取宽度的矩形对象。

返回值：

展开
类型 说明
number 返回矩形的宽。如果矩形的左边界大于右边界，获取的宽度为负值，左边界小于右边界则为正值。单位为物理像素px。

示例：

收起
自动换行
深色代码主题
复制
  1. import { drawing } from '@kit.ArkGraphics2D';
  2. 

  3. let rect = drawing.RectUtils.makeLtrb(10, 10, 20, 20);
  4. let width = drawing.RectUtils.getWidth(rect);
  5. console.info('width:', width);

getHeight20+

Phone20+PC/2in120+Tablet20+TV20+Wearable20+

static getHeight(rect: common2D.Rect): number

获取矩形的高度。

系统能力： SystemCapability.Graphics.Drawing

参数：

展开
参数名 类型 必填 说明
rect common2D.Rect 是 需要获取高度的矩形对象。

返回值：

展开
类型 说明
number 返回矩形的高。如果矩形的上边界大于下边界，获取的高度为负值，上边界小于下边界则为正值。单位为物理像素px。

示例：

收起
自动换行
深色代码主题
复制
  1. import { drawing } from '@kit.ArkGraphics2D';
  2. 

  3. let rect = drawing.RectUtils.makeLtrb(10, 10, 20, 20);
  4. let height = drawing.RectUtils.getHeight(rect);

centerX20+

Phone20+PC/2in120+Tablet20+TV20+Wearable20+

static centerX(rect: common2D.Rect): number

获取矩形中心的x轴坐标，中心x轴坐标为矩形左边界与右边界之和的一半。

系统能力： SystemCapability.Graphics.Drawing

参数：

展开
参数名 类型 必填 说明
rect common2D.Rect 是 需要获取中心x轴坐标的矩形对象。

返回值：

展开
类型 说明
number 返回矩形中心的x轴坐标。单位为物理像素px。

示例：

收起
自动换行
深色代码主题
复制
  1. import { drawing } from '@kit.ArkGraphics2D';
  2. 

  3. let rect = drawing.RectUtils.makeLtrb(20, 30, 30, 40);
  4. let x = drawing.RectUtils.centerX(rect);

centerY20+

Phone20+PC/2in120+Tablet20+TV20+Wearable20+

static centerY(rect: common2D.Rect): number

获取矩形中心的y轴坐标，中心y轴坐标为矩形上边界与下边界之和的一半。

系统能力： SystemCapability.Graphics.Drawing

参数：

展开
参数名 类型 必填 说明
rect common2D.Rect 是 需要获取中心y轴坐标的矩形对象。

返回值：

展开
类型 说明
number 返回矩形中心的y轴坐标。单位为物理像素px。

示例：

收起
自动换行
深色代码主题
复制
  1. import { drawing } from '@kit.ArkGraphics2D';
  2. 

  3. let rect = drawing.RectUtils.makeLtrb(20, 30, 30, 40);
  4. let y = drawing.RectUtils.centerY(rect);

contains20+

Phone20+PC/2in120+Tablet20+TV20+Wearable20+

static contains(rect: common2D.Rect, other: common2D.Rect): boolean

判断一个矩形是否完全包含另外一个矩形。

系统能力： SystemCapability.Graphics.Drawing

参数：

展开
参数名 类型 必填 说明
rect common2D.Rect 是 用于判断是否包含其他矩形的矩形对象。
other common2D.Rect 是 判断是否被包含的矩形对象。

返回值：

展开
类型 说明
boolean 返回矩形是否完全包含另一个矩形的结果。true表示other在rect内部或者两者相等；false表示other矩形不完全在rect内部（即存在部分区域在rect外部），或者rect、other任一为空矩形。左边界和上边界属于矩形内部，右边界和下边界不属于矩形内部。

示例：

收起
自动换行
深色代码主题
复制
  1. import { drawing } from '@kit.ArkGraphics2D';
  2. 

  3. let rect = drawing.RectUtils.makeLtrb(10, 10, 20, 20);
  4. let rect2 = drawing.RectUtils.makeLtrb(0, 0, 40, 40);
  5. let isContains = drawing.RectUtils.contains(rect2, rect);
  6. console.info('isContains: ', isContains);

contains20+

Phone20+PC/2in120+Tablet20+TV20+Wearable20+

static contains(rect: common2D.Rect, left: number, top: number, right: number, bottom: number): boolean

判断一个矩形是否完全包含另外一个矩形（另一个矩形分别用左上右下坐标表示）。

系统能力： SystemCapability.Graphics.Drawing

参数：

展开
参数名 类型 必填 说明
rect common2D.Rect 是 用于判断是否包含由左上右下坐标组成的矩形的原矩形对象。
left number 是 矩形的左上角x轴坐标，该参数为浮点数。0表示坐标原点，负数表示位于坐标原点左侧，正数表示位于坐标原点右侧。单位为物理像素px。
top number 是 矩形的左上角y轴坐标，该参数为浮点数。0表示坐标原点，负数表示位于坐标原点上侧，正数表示位于坐标原点下侧。单位为物理像素px。
right number 是 矩形的右下角x轴坐标，该参数为浮点数。0表示坐标原点，负数表示位于坐标原点左侧，正数表示位于坐标原点右侧。单位为物理像素px。
bottom number 是 矩形的右下角y轴坐标，该参数为浮点数。0表示坐标原点，负数表示位于坐标原点上侧，正数表示位于坐标原点下侧。单位为物理像素px。

返回值：

展开
类型 说明
boolean 返回矩形是否完全包含由左上右下坐标组成的矩形的结果。true表示由left、top、right、bottom组成的矩形完全在rect矩形内部，或两个矩形完全相等。false表示该矩形不完全在rect内部（即存在部分区域在rect外部），或者rect、该矩形任一为空矩形。

示例：

收起
自动换行
深色代码主题
复制
  1. import { drawing } from '@kit.ArkGraphics2D';
  2. 

  3. let rect = drawing.RectUtils.makeLtrb(0, 0, 100, 100);
  4. let isContains = drawing.RectUtils.contains(rect, 10, 20, 30, 40);
  5. console.info('isContains: ', isContains);

contains20+

Phone20+PC/2in120+Tablet20+TV20+Wearable20+

static contains(rect: common2D.Rect, x: number, y: number): boolean

判断一个矩形是否完全包含一个点。

系统能力： SystemCapability.Graphics.Drawing

参数：

展开
参数名 类型 必填 说明
rect common2D.Rect 是 用于判断是否包含指定点的原矩形对象。
x number 是 要判断点的x轴坐标，该参数为浮点数。0表示坐标原点，负数表示位于坐标原点左侧，正数表示位于坐标原点右侧。单位为物理像素px。
y number 是 要判断点的y轴坐标，该参数为浮点数。0表示坐标原点，负数表示位于坐标原点上侧，正数表示位于坐标原点下侧。单位为物理像素px。

返回值：

展开
类型 说明
boolean 返回矩形是否完全包含x、y组成的点的结果。true表示矩形完全包含x、y组成的点，false表示矩形不完全包含x、y组成的点。左边界和上边界属于矩形内部，右边界和下边界不属于矩形内部。空的矩形不包含任何点。

示例：

收起
自动换行
深色代码主题
复制
  1. import { drawing } from '@kit.ArkGraphics2D';
  2. 

  3. let rect = drawing.RectUtils.makeLtrb(0, 0, 100, 100);
  4. let isContains = drawing.RectUtils.contains(rect, 10, 20);
  5. console.info('isContains: ', isContains);

inset20+

Phone20+PC/2in120+Tablet20+TV20+Wearable20+

static inset(rect: common2D.Rect, left: number, top: number, right: number, bottom: number): void

将指定矩形的左边界、上边界、右边界和下边界分别和传入的“左上右下”的值相加。

系统能力： SystemCapability.Graphics.Drawing

参数：

展开
参数名 类型 必填 说明
rect common2D.Rect 是 需要进行边界调整的原矩形对象。
left number 是 添加到矩形左边界的值（矩形左上角x轴坐标），该参数为浮点数。0表示不进行任何运算，正数表示进行相加运算，负数表示相减运算。单位为物理像素px。
top number 是 添加到矩形上边界的值（矩形左上角y轴坐标），该参数为浮点数。0表示不进行任何运算，正数表示进行相加运算，负数表示相减运算。单位为物理像素px。
right number 是 添加到矩形右边界的值（矩形右下角x轴坐标），该参数为浮点数。0表示不进行任何运算，正数表示进行相加运算，负数表示相减运算。单位为物理像素px。
bottom number 是 添加到矩形下边界的值（矩形右下角y轴坐标），该参数为浮点数。0表示不进行任何运算，正数表示进行相加运算，负数表示相减运算。单位为物理像素px。

示例：

收起
自动换行
深色代码主题
复制
  1. import { drawing } from '@kit.ArkGraphics2D';
  2. 

  3. let rect = drawing.RectUtils.makeLtrb(10, 10, 20, 20);
  4. drawing.RectUtils.inset(rect, 10, -20, 30, 60);
  5. console.info('rect.left: ', rect.left);
  6. console.info('rect.top: ', rect.top);
  7. console.info('rect.right: ', rect.right);
  8. console.info('rect.bottom: ', rect.bottom);

intersect20+

Phone20+PC/2in120+Tablet20+TV20+Wearable20+

static intersect(rect: common2D.Rect, other: common2D.Rect): boolean

计算两个矩形的交集区域，并将交集结果更新到第一个入参代表的矩形区域。

系统能力： SystemCapability.Graphics.Drawing

参数：

展开
参数名 类型 必填 说明
rect common2D.Rect 是 用于计算交集的原矩形。
other common2D.Rect 是 用于计算交集的另一个矩形。

返回值：

展开
类型 说明
boolean 返回两个矩形是否相交。true表示两矩形相交，false表示两矩形不相交，或仅边重叠、点相交。

示例：

收起
自动换行
深色代码主题
复制
  1. import { drawing } from '@kit.ArkGraphics2D';
  2. 

  3. let rect = drawing.RectUtils.makeLtrb(0, 0, 20, 20);
  4. let rect2 = drawing.RectUtils.makeLtrb(10, 10, 40, 40);
  5. let isIntersect = drawing.RectUtils.intersect(rect, rect2);
  6. console.info('isIntersect: ', isIntersect);
  7. console.info('rect.left: ', rect.left);
  8. console.info('rect.top: ', rect.top);
  9. console.info('rect.right: ', rect.right);
  10. console.info('rect.bottom: ', rect.bottom);

isIntersect20+

Phone20+PC/2in120+Tablet20+TV20+Wearable20+

static isIntersect(rect: common2D.Rect, other: common2D.Rect): boolean

判断两个矩形是否相交。

系统能力： SystemCapability.Graphics.Drawing

参数：

展开
参数名 类型 必填 说明
rect common2D.Rect 是 用于判断是否相交的原矩形。
other common2D.Rect 是 用于判断是否相交的另一个矩形。

返回值：

展开
类型 说明
boolean 返回两个矩形是否有交集的结果。true表示两个矩形有交集，false表示两个矩形没有交集。两矩形仅边重叠或点相交返回false。

示例：

收起
自动换行
深色代码主题
复制
  1. import { drawing } from '@kit.ArkGraphics2D';
  2. 

  3. let rect = drawing.RectUtils.makeLtrb(0, 0, 20, 20);
  4. let rect2 = drawing.RectUtils.makeLtrb(10, 10, 40, 40);
  5. let isIntersect = drawing.RectUtils.isIntersect(rect, rect2);
  6. console.info('isIntersect:', isIntersect);

union20+

Phone20+PC/2in120+Tablet20+TV20+Wearable20+

static union(rect: common2D.Rect, other: common2D.Rect): void

计算两个矩形的并集区域，并将并集结果更新到第一个入参代表的矩形区域。如果第一个入参矩形为空，则将并集结果更新到第二个入参代表的矩形区域；如果第二个入参的矩形为空，则不进行任何操作。

系统能力： SystemCapability.Graphics.Drawing

参数：

展开
参数名 类型 必填 说明
rect common2D.Rect 是 用于计算并集的原矩形。
other common2D.Rect 是 用于计算并集的另一个矩形。

示例：

收起
自动换行
深色代码主题
复制
  1. import { drawing } from '@kit.ArkGraphics2D';
  2. 

  3. let rect = drawing.RectUtils.makeLtrb(0, 0, 20, 20);
  4. let rect2 = drawing.RectUtils.makeLtrb(10, 10, 40, 40);
  5. drawing.RectUtils.union(rect, rect2);
  6. console.info('rect.left: ', rect.left);
  7. console.info('rect.top: ', rect.top);
  8. console.info('rect.right: ', rect.right);
  9. console.info('rect.bottom: ', rect.bottom);

isEmpty20+

Phone20+PC/2in120+Tablet20+TV20+Wearable20+

static isEmpty(rect: common2D.Rect): boolean

判断矩形是否为空（左边界大于等于右边界或者上边界大于等于下边界）。

系统能力： SystemCapability.Graphics.Drawing

参数：

展开
参数名 类型 必填 说明
rect common2D.Rect 是 用于判断是否为空的矩形对象。

返回值：

展开
类型 说明
boolean 返回矩形是否为空的结果。true表示矩形为空，false表示矩形不为空。

示例：

收起
自动换行
深色代码主题
复制
  1. import { drawing } from '@kit.ArkGraphics2D';
  2. 

  3. let rect = drawing.RectUtils.makeEmpty();
  4. let isEmpty = drawing.RectUtils.isEmpty(rect);
  5. console.info('isEmpty:', isEmpty);
  6. let rect2 = drawing.RectUtils.makeLtrb(0, 0, 20, 20);
  7. isEmpty = drawing.RectUtils.isEmpty(rect2);
  8. console.info('isEmpty:', isEmpty);

offset20+

Phone20+PC/2in120+Tablet20+TV20+Wearable20+

static offset(rect: common2D.Rect, dx: number, dy: number): void

对矩形进行平移。

系统能力： SystemCapability.Graphics.Drawing

参数：

展开
参数名 类型 必填 说明
rect common2D.Rect 是 发生平移的矩形区域。
dx number 是 水平方向平移的距离，该参数为浮点数。0表示不平移，负数表示向左平移，正数表示向右平移。单位为物理像素px。
dy number 是 竖直方向平移的距离，该参数为浮点数。0表示不平移，负数表示向上平移，正数表示向下平移。单位为物理像素px。

示例：

收起
自动换行
深色代码主题
复制
  1. import { drawing } from '@kit.ArkGraphics2D';
  2. 

  3. let rect = drawing.RectUtils.makeLtrb(0, 0, 20, 20);
  4. drawing.RectUtils.offset(rect, 10, 20);
  5. console.info('rect.left: ', rect.left);
  6. console.info('rect.top: ', rect.top);
  7. console.info('rect.right: ', rect.right);
  8. console.info('rect.bottom: ', rect.bottom);

offsetTo20+

Phone20+PC/2in120+Tablet20+TV20+Wearable20+

static offsetTo(rect: common2D.Rect, newLeft: number, newTop: number): void

将矩形平移到指定位置。

系统能力： SystemCapability.Graphics.Drawing

参数：

展开
参数名 类型 必填 说明
rect common2D.Rect 是 发生平移的矩形区域。
newLeft number 是 要平移到的对应位置的x轴坐标，该参数为浮点数。0表示坐标原点，负数表示位于坐标原点左侧，正数表示位于坐标原点右侧。单位为物理像素px。
newTop number 是 要平移到的对应位置的y轴坐标，该参数为浮点数。0表示坐标原点，负数表示位于坐标原点上侧，正数表示位于坐标原点下侧。单位为物理像素px。

示例：

收起
自动换行
深色代码主题
复制
  1. import { drawing } from '@kit.ArkGraphics2D';
  2. 

  3. let rect = drawing.RectUtils.makeLtrb(20, 20, 40, 40);
  4. drawing.RectUtils.offsetTo(rect, 10, 20);
  5. console.info('rect.left: ', rect.left);
  6. console.info('rect.top: ', rect.top);
  7. console.info('rect.right: ', rect.right);
  8. console.info('rect.bottom: ', rect.bottom);

setRect20+

Phone20+PC/2in120+Tablet20+TV20+Wearable20+

static setRect(rect: common2D.Rect, other: common2D.Rect): void

使用另一个矩形对当前矩形进行赋值。

系统能力： SystemCapability.Graphics.Drawing

参数：

展开
参数名 类型 必填 说明
rect common2D.Rect 是 需要被赋值的原矩形对象。
other common2D.Rect 是 用于赋值的矩形。

示例：

收起
自动换行
深色代码主题
复制
  1. import { drawing } from '@kit.ArkGraphics2D';
  2. 

  3. let rect = drawing.RectUtils.makeLtrb(10, 20, 30, 40);
  4. let rect2 = drawing.RectUtils.makeEmpty();
  5. drawing.RectUtils.setRect(rect2, rect);
  6. console.info('rect2.left: ', rect2.left);
  7. console.info('rect2.top: ', rect2.top);
  8. console.info('rect2.right: ', rect2.right);
  9. console.info('rect2.bottom: ', rect2.bottom);

setLtrb20+

Phone20+PC/2in120+Tablet20+TV20+Wearable20+

static setLtrb(rect: common2D.Rect, left: number, top: number, right: number, bottom: number): void

使用传入的“左上右下”的值更新当前矩形的左上右下边界值。

系统能力： SystemCapability.Graphics.Drawing

参数：

展开
参数名 类型 必填 说明
rect common2D.Rect 是 需要更新边界值的原矩形对象。
left number 是 矩形的左上角x轴坐标，该参数为浮点数。0表示坐标原点，负数表示位于坐标原点左侧，正数表示位于坐标原点右侧。单位为物理像素px。
top number 是 矩形的左上角y轴坐标，该参数为浮点数。0表示坐标原点，负数表示位于坐标原点上侧，正数表示位于坐标原点下侧。单位为物理像素px。
right number 是 矩形的右下角x轴坐标，该参数为浮点数。0表示坐标原点，负数表示位于坐标原点左侧，正数表示位于坐标原点右侧。单位为物理像素px。
bottom number 是 矩形的右下角y轴坐标，该参数为浮点数。0表示坐标原点，负数表示位于坐标原点上侧，正数表示位于坐标原点下侧。单位为物理像素px。

示例：

收起
自动换行
深色代码主题
复制
  1. import { drawing } from '@kit.ArkGraphics2D';
  2. 

  3. let rect = drawing.RectUtils.makeEmpty();
  4. drawing.RectUtils.setLtrb(rect, 10, 20, 30, 60);
  5. console.info('rect.left: ', rect.left);
  6. console.info('rect.top: ', rect.top);
  7. console.info('rect.right: ', rect.right);
  8. console.info('rect.bottom: ', rect.bottom);

setEmpty20+

Phone20+PC/2in120+Tablet20+TV20+Wearable20+

static setEmpty(rect: common2D.Rect): void

将矩形的上下左右边界都设为0。

系统能力： SystemCapability.Graphics.Drawing

参数：

展开
参数名 类型 必填 说明
rect common2D.Rect 是 用于设置为空的矩形对象。

示例：

收起
自动换行
深色代码主题
复制
  1. import { drawing } from '@kit.ArkGraphics2D';
  2. 

  3. let rect = drawing.RectUtils.makeLtrb(10, 20, 20, 30);
  4. drawing.RectUtils.setEmpty(rect);
  5. console.info('rect.left: ', rect.left);
  6. console.info('rect.top: ', rect.top);
  7. console.info('rect.right: ', rect.right);
  8. console.info('rect.bottom: ', rect.bottom);

sort20+

Phone20+PC/2in120+Tablet20+TV20+Wearable20+

static sort(rect: common2D.Rect): void

如果矩形存在反转的情况（即左边界大于右边界或上边界大于下边界），则将发生反转的对应边界值进行交换（若左边界大于右边界，交换左右边界值；若上边界大于下边界，交换上下边界值），使得上边界小于下边界（左边界小于右边界）。

如果矩形不存在反转的情况（即左边界小于等于右边界且上边界小于等于下边界），不做任何操作。

系统能力： SystemCapability.Graphics.Drawing

参数：

展开
参数名 类型 必填 说明
rect common2D.Rect 是 待进行边界排序的矩形对象。

示例：

收起
自动换行
深色代码主题
复制
  1. import { drawing } from '@kit.ArkGraphics2D';
  2. 

  3. let rect = drawing.RectUtils.makeLtrb(20, 40, 30, 30);
  4. drawing.RectUtils.sort(rect);
  5. console.info('rect.left: ', rect.left);
  6. console.info('rect.top: ', rect.top);
  7. console.info('rect.right: ', rect.right);
  8. console.info('rect.bottom: ', rect.bottom);

isEqual20+

Phone20+PC/2in120+Tablet20+TV20+Wearable20+

static isEqual(rect: common2D.Rect, other: common2D.Rect): boolean

判断两个矩形是否相等。

系统能力： SystemCapability.Graphics.Drawing

参数：

展开
参数名 类型 必填 说明
rect common2D.Rect 是 需要判断是否相等的原矩形。
other common2D.Rect 是 需要判断是否相等的另一个矩形。

返回值：

展开
类型 说明
boolean 返回两个矩形是否相等的结果。true表示两个矩形相等，false表示两个矩形不相等。

示例：

收起
自动换行
深色代码主题
复制
  1. import { drawing } from '@kit.ArkGraphics2D';
  2. 

  3. let rect = drawing.RectUtils.makeLtrb(10, 20, 20, 30);
  4. let rect2 = drawing.RectUtils.makeEmpty();
  5. let isEqual = drawing.RectUtils.isEqual(rect, rect2);
  6. console.info('isEqual:', isEqual);
Class (PointUtils)
Class (Region)
简体中文
华为开发者联盟 版权所有 ©2026
问题反馈
使用条款
华为开发者联盟用户协议
关于华为开发者联盟与隐私的声明
Cookies
开源软件声明
在 开发与测试 开放能力API 中进行搜索
请输入您想要搜索的关键词