# screenitem.updatebyposition

### Описание

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

Этот метод позволяет обновлять элементы комплексного экрана в заданных
ячейках комплексного экрана. Если ячейка пустая, будет создан новый
элемент комплексного экрана.

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

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

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

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

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

### Примеры

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

Изменение ID ресурса элемента комплексного экрана, который расположен в
левой верхней ячейке комплексного экрана.

Запрос:

``` {.java}
{
    "jsonrpc": "2.0",
    "method": "screenitem.updatebyposition",
    "params": [
        {
            "screenid": "16",
            "x": 0,
            "y": 0,
            "resourceid": "644"
        }
    ],
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

Ответ:

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

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

-   [screenitem.update](update)

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

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