# screenitem.update

### Описание

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

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

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

`(объект/массив)` [Свойства элемента комплексного
экрана](object#элемент_комплексного_экрана), которые будут обновлены.

Свойство `screenitemid` должно быть указано по каждому элементу
комплексного экрана, все остальные свойства опциональны. Будут обновлены
только переданные свойства, все остальные останутся неизменными.

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

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

### Примеры

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

Изменение размеров элемента комплексного экрана, ширину на 500px и
высоту на 300px.

Запрос:

``` {.java}
{
    "jsonrpc": "2.0",
    "method": "screenitem.update",
    "params": {
        "screenitemid": "20",
        "width": 500,
        "height": 300
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

Ответ:

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

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

-   [screenitem.updatebyposition](updatebyposition)

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

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