# screenitem.create

### Описание

`объект screenitem.create(объект/массив ЭлементыКомплексногоЭкрана)`

Этот метод позволяет создавать новые элементы комплексного экрана.

### Параметры

`(объект/массив)` Создаваемые элементы комплексного экрана.

Этот метод принимает элементы комплексного экрана со [стандартными
свойствами элемента комплексного
экрана](object#элемент_комплексного_экрана).

### Возвращаемые значения

`(объект)` Возвращает объект, который содержит ID созданных элементов
комплексного экрана под свойством `screenitemids`. Порядок возвращаемых
ID совпадает с порядком переданных элементов комплексного экрана.

### Примеры

#### Создание элемента комплексного экрана

Создание элемента комплексного экрана, который отображает график в левой
верхней ячейке комплексного экрана.

Запрос:

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

Ответ:

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

### Смотрите также

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

### Исходный код

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