• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# RemoteWindow
2
3远程控制窗口组件,可以通过此组件控制应用窗口,提供启动退出过程中控件动画和应用窗口联动动画的能力。
4
5>  **说明:**
6>
7>  该组件从API Version 9开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
8>
9>  该组件为系统接口。
10
11## 子组件
12
13不可以包含子组件。
14
15## 接口
16
17RemoteWindow(target: WindowAnimationTarget)
18
19通过窗口动画对象创建组件。
20
21**参数:**
22| 参数名 | 参数类型 | 必填  | 参数描述 |
23| -------- | -------- | --------------- | -------- |
24| target | [WindowAnimationTarget](#windowanimationtarget) | 是   | 需要控制的动画窗口的描述。 |
25
26## WindowAnimationTarget
27目标窗口,用来远程控制实现动画。
28
29| 参数      | 类型     | 描述 |
30| ------- | ------ | ----------------------- |
31| bundleName  | string | 动画窗口所对应的进程。|
32| abilityName | string | 动画窗口所对应的Ability。|
33| windowBounds | [RRect](#rrect) | 动画窗口实际大小。|
34| missionId  | number | 任务ID。|
35
36## RRect
37圆角矩形。
38
39| 参数      | 类型     | 描述 |
40| ------- | ------ | ----------------------- |
41| left  | number | 动画窗口左上角相对于屏幕横坐标。|
42| top | number | 动画窗口左上角相对于屏幕纵坐标。|
43| width | number | 动画窗口宽度大小。|
44| height | number | 动画窗口高度大小。|
45| radius | number | 动画窗口圆角大小。|
46
47## 属性
48
49支持[通用属性](ts-universal-attributes-size.md)。
50
51## 事件
52
53支持[通用事件](ts-universal-events-click.md)。
54
55## 示例
56
57```ts
58// xxx.ets
59@Entry
60@Component
61struct RemoteWindowExample {
62  @State target: WindowAnimationTarget = undefined // 通过windowAnimationManager获取
63
64  build() {
65    Column() {
66      RemoteWindow(this.target)
67      	.translate({ x: 100, y: 200 })
68      	.scale({ x: 0.5, y: 0.5 })
69        .opacity(0.8)
70      	.position({ x: px2vp(this.target?.windowBounds.left), y: px2vp(this.target?.windowBounds.top) })
71      	.width(px2vp(this.target?.windowBounds.width))
72      	.height(px2vp(this.target?.windowBounds.height))
73     }
74  }
75}
76```