[comment]: # ({b243934a-b2d566b4})
# 创建

[comment]: # ({/b243934a-b2d566b4})

[comment]: # ({d0943cba-d458a71b})
### 描述

`object screenitem.create(object/array screenItems)`

此方法允许创建一个新的聚合类型项

[comment]: # ({/d0943cba-d458a71b})

[comment]: # ({1b77a11b-b2879324})
### 参数

`(object/array)`创建聚合图形项。

此方法接受聚合图形项关于[standard screen item
properties](object#screen_item)。

[comment]: # ({/1b77a11b-b2879324})

[comment]: # ({3543a912-d4cb1517})
### 返回值

`(object)`返回一个对象，该对象包含在`screenitemids`属性下创建的聚合图形项的id。返回id的顺序与所传递的聚合图形项的顺序相匹配。

[comment]: # ({/3543a912-d4cb1517})

[comment]: # ({c38fd778-b41637d2})
### 示例如下

[comment]: # ({/c38fd778-b41637d2})

[comment]: # ({b2d3491e-36694153})
#### 创建一个聚合图形项

创建一个聚合图像项展示一个图像在左上角的聚合图形。

Request:

``` {.java}
{
    "jsonrpc": "2.0",
    "method": "screenitem.create",
    "params": {
        "screenid": 16,
        "resourcetype": 0,
        "resourceid": 612,
        "x": 0,
        "y": 0
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

Response:

``` {.java}
{
    "jsonrpc": "2.0",
    "result": {
        "screenitemids": [
            "65"
        ]
    },
    "id": 1
}
```

[comment]: # ({/b2d3491e-36694153})

[comment]: # ({71c0a4bd-9dd8f3de})
### 猜你想看

-   [screen.update](/manual/api/reference/screen/update)

[comment]: # ({/71c0a4bd-9dd8f3de})

[comment]: # ({dde1a6f4-6d1c39c8})
### 源

CScreenItem::create() in
*frontends/php/include/classes/api/services/CScreenItem.php*.

[comment]: # ({/dde1a6f4-6d1c39c8})