---
metadata:
  - name: generator
    content: Diplodoc Platform v5.39.1
alternate:
  - https://yandex.com.tr/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/IContainerPane.md
  - https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IContainerPane.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/llms.txt

# IContainerPane

Расширяет [IPane](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPane.md), [IPositioningContext](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPositioningContext.md).

Интерфейс пейна карты, предназначенного для размещения отображений объектов, расположенных на поверхности карты. Предоставляет возможность перевода глобальных пикселей карты в собственную локальную координатную систему, и т.о. позволяет объекту позиционироваться внутри себя. Также информирует об изменении состояния карты и т.о. позволяет объекту обрабатывать эти изменения.

[Конструктор](#constructor-summary) | [Поля ](#properties-summary) | [События ](#events-summary) | [Методы ](#methods-summary)

## Конструктор {#constructor-summary}

```javascript
IContainerPane()
```

## Поля {#properties-summary}

#|
|| **Имя** | **Тип** | **Описание** ||
|| [events](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IEventEmitter.md#events) | [IEventManager](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IEventManager.md) | Менеджер событий.

Унаследовано от [IEventEmitter](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IEventEmitter.md#events). ||
|#

## События {#events-summary}

#|
|| **Имя** | **Описание** ||
|| [actionbegin](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IContainerPane.md#event-actionbegin) | Начало движения пейна. Экземпляр [IEvent](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IEvent.md). ||
|| [actionend](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IContainerPane.md#event-actionend) | Окончание движения пейна. Экземпляр [IEvent](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IEvent.md). ||
|| [clientpixelschange](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IContainerPane.md#event-clientpixelschange) | Изменение локальной координатной системы пейна. Данное событие означает, что объекты, рассчитывающие свою позицию внутри пейна из глобальных пиксельных координат карты, должны пересчитать ее и обновить свое положение внутри DOM-элемента пейна. Экземпляр [IEvent](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IEvent.md). ||
|| [overflowchange](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPane.md#event-overflowchange) | Изменение параметра "overflow", определяющего видимость содержимого пейна при выходе за пределы контейнера карты. Экземпляр [IEvent](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IEvent.md).

Унаследовано от [IPane](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPane.md#event-overflowchange). ||
|| [viewportchange](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IContainerPane.md#event-viewportchange) | Изменение области показа пейна. Экземпляр [IEvent](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IEvent.md). ||
|| [zindexchange](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPane.md#event-zindexchange) | Изменение значения zIndex пейна. Экземпляр [IEvent](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IEvent.md).

Унаследовано от [IPane](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPane.md#event-zindexchange). ||
|#


## Методы {#methods-summary}

#|
|| **Имя** | **Возвращает** | **Описание** ||
|| [destroy](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPane.md#destroy)() | | Уничтожает пейн.

Унаследован от [IPane](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPane.md#destroy). ||
|| [fromClientPixels](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPositioningContext.md#fromClientPixels)([clientPixelPoint](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPositioningContext.md#fromClientPixels-param-clientPixelPoint)) | Number[] | Преобразует клиентские пиксельные координаты в глобальные.

Унаследован от [IPositioningContext](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPositioningContext.md#fromClientPixels). ||
|| [getElement](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPane.md#getElement)() | HTMLElement | Возвращает ссылку на DOM-контейнер пейна.

Унаследован от [IPane](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPane.md#getElement). ||
|| [getMap](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPane.md#getMap)() | [Map](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md) | Возвращает карту, которой принадлежит пейн.

Унаследован от [IPane](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPane.md#getMap). ||
|| [getOverflow](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPane.md#getOverflow)() | String | Возвращает значение параметра "overflow", определяющего видимость содержимого пейна при выходе за пределы контейнера карты. Данный параметр может принимать одно из следующих строковых значений:
- "visible" - при выходе за пределы контейнера карты содержимое пейна остается видимым;
- "hidden" - область отображения содержимого пейна ограничена контейнером карты.

Унаследован от [IPane](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPane.md#getOverflow). ||
|| [getViewport](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IContainerPane.md#getViewport)() | Number[][] | Возвращает область показа пейна в клиентских координатах. ||
|| [getZIndex](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPane.md#getZIndex)() | Number | Возвращает zIndex пейна.

Унаследован от [IPane](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPane.md#getZIndex). ||
|| [getZoom](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPositioningContext.md#getZoom)() | Number | Возвращает текущий уровень масштабирования, в котором работает контекст позиционирования.

Унаследован от [IPositioningContext](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPositioningContext.md#getZoom). ||
|| [toClientPixels](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPositioningContext.md#toClientPixels)([globalPixelPoint](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPositioningContext.md#toClientPixels-param-globalPixelPoint)) | Number[] | Преобразует глобальные пиксельные координаты в клиентские.

Унаследован от [IPositioningContext](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPositioningContext.md#toClientPixels). ||
|#

## Описание событий {#event_detail}

### actionbegin {#actionbegin}

Начало движения пейна. Экземпляр [IEvent](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IEvent.md).

### actionend {#actionend}

Окончание движения пейна. Экземпляр [IEvent](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IEvent.md).
# clientpixelschange

Изменение локальной координатной системы пейна. Данное событие означает, что объекты, рассчитывающие свою позицию внутри пейна из глобальных пиксельных координат карты, должны пересчитать ее и обновить свое положение внутри DOM-элемента пейна. Экземпляр [IEvent](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IEvent.md).

### viewportchange {#viewportchange}

Изменение области показа пейна. Экземпляр [IEvent](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IEvent.md).

## Описание методов {#method_detail}

### getViewport {#getViewport}

```javascript
{Number[][]} getViewport()
```

**Возвращает** область показа пейна в клиентских координатах.

<!-- XLIFF_FARM_Y2FmYmRk_CACHING -->