MapItem
=================

.. currentmodule:: axioma.render

.. class:: MapItem

	Базовый класс для элементов карты

	От него наследуются: :class:`Layer`

		.. py:method:: MapItem(parent)

			Конструктор

			:param parent: Родительский объект.
			:type parent: :class:`~PyQt5.QtCore.QObject`

		.. py:method:: MapItem(other)

			Конструктор - копия существующего объекта

			:param other: Эталонный объект.
			:type other: :class:`~axioma.render.MapItem`

		.. py:method:: name()

			Наименование объекта.

			:return: Наименование
			:rtype: :class:`str`

			.. py:method:: setName(name)

			Устанавливает новое значение наименования.

			:param name: Наименование.
			:type name: :class:`str`

		.. py:method:: contentType()

			Типы поддерживаемых объектов.

			:return: Тип контента
			:rtype: :class:`~axioma.core.dp.ContentType`

		.. py:method:: renderable()

			Будет ли отображаться данный элемент при отрисовке.

			:return: True, если включено отображение элемента, иначе False.
			:rtype: :class:`bool`

		.. py:method:: setRenderable(val)

			Управление видимостью данного элемента при отрисовке.

			:param val: True, если необходимо включить отображение элемента, иначе False.
			:type val: :class:`bool`

		.. py:method:: isVisible(viewport)

			Определяет, будет ли отображаться элемент карты для переданного viewport.

			:param viewport: True, если необходимо включить отображение элемента, иначе False.
			:type viewport: :class:`MapViewport`
			:return: True, если элемент будет отображаться для viewport, иначе False.
			:rtype: :class:`bool`

		.. py:method:: map()

			Ссылка на базовую карту.

			:return: Карта
			:rtype: :class:`~axioma.render.Map`

		.. py:method:: mapItemProperties()

			Свойства элемента карты.

			:return: Копия свойств элемента карты
			:rtype: :class:`~axioma.render.MapItemProperties`

		.. py:method:: setProperties(mapItemProperties)

			Установка свойств элемента карты.

			:param mapItemProperties: Новые свойства элемента карты.
			:type mapItemProperties: :class:`MapItemProperties`

		.. py:staticmethod:: findMap(item)

			Иерархический поиск карты, которой принадлежит данный элемент.

			:param item: Элемент, по которому производится поиск карты.
			:type item: :class:`~axioma.render.MapItem`
			:return: Найденная карта
			:rtype: :class:`~axioma.render.Map`

		.. method:: visibilityChanged(item)

			[signal] Сигнал испускается, когда видимость этого или одного из дочерних элементов поменялась

			:param item: Ссылка на элемент карты, видимость, которого поменялась.
			:type item: :class:`~axioma.render.MapItem`

		.. method:: needRedraw(layer)

			[signal] Сигнал испускается, когда слою необходима перерисовка

			:param layer: Элемент, которому необходима перерисовка
			:type layer: ::class:`~axioma.render.Layer`

		.. method:: dataChanged()

			[signal] Сигнал испускается, когда были произведены какие то изменения в данных

		.. method:: mapItemDestroyed(mapItem)

			[signal] Сигнал испускается в деструкторе для того, чтобы MapItem был	своевременно удален из LayerGroup (до сигнала QObject.destroyed)

			:param mapItem: Удаляемый элемент
			:type mapItem: :class:`~axioma.render.MapItem`

		.. method:: propertiesChanged()

			[signal] Сигнал запускается после установки свойств для элемента карты