• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# RemoteWindow
2
3**\<RemoteWindow>** is a component used to control the application window, providing the component animator and application window linkage animator during application startup and exit.
4
5>  **NOTE**
6>
7>  This component is supported since API version 9. Updates will be marked with a superscript to indicate their earliest API version.
8>
9>  The APIs provided by this component are system APIs.
10
11## Child Components
12
13Not supported
14
15## APIs
16
17RemoteWindow(target: WindowAnimationTarget)
18
19Creates a **\<RemoteWindow>** through a window animation object.
20
21- Parameters
22  | Name| Type| Mandatory| Default Value| Description|
23  | -------- | -------- | -------- | -------- | -------- |
24  | target | [WindowAnimationTarget](#windowanimationtarget) | Yes| - | Description of the animation window to control.|
25
26## WindowAnimationTarget
27Implements a target window, which is used to remotely control the animation.
28
29| Name     | Type    | Description|
30| ------- | ------ | ----------------------- |
31| bundleName  | string | Process corresponding to the animation window.|
32| abilityName | string | Ability corresponding to the animation window.|
33| windowBounds | [RRect](#rrect) | Actual size of the animation window.|
34| missionId  | number | Mission ID.|
35
36## RRect
37Implements a rounded rectangle.
38
39| Name     | Type    | Description|
40| ------- | ------ | ----------------------- |
41| left  | number | Horizontal coordinate of the upper left corner of the animation window relative to the screen.|
42| top | number | Vertical coordinate of the upper left corner of the animation window relative to the screen.|
43| width | number | Width of the animation window.|
44| height | number | Height of the animation window.|
45| radius | number | Radius of the rounded corner of the animation window.|
46
47## Attributes
48
49The [universal attributes](ts-universal-attributes-size.md) are supported.
50
51## Events
52
53The [universal events](ts-universal-events-click.md) are supported.
54
55## Example
56
57```ts
58// xxx.ets
59@Entry
60@Component
61struct RemoteWindowExample {
62  @State target: WindowAnimationTarget = undefined // Obtained through 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```
77