Документация-вспомогательные

Самое важное и главное при работе с объектом – это умение создавать его. Данная операция очень просто, она состоит из следующих этапов:

1. Создание пустого объекта, привязанного к определенному слою;
2. Присвоение координат объекту;
3. Присвоение атрибутивной информации;
4. Присвоение идентификатора стиля, если стиль слоя не определен как единообразный;

Необходимо также учитывать, что координаты объекта должны быть переданы в формате WKT. Этот формат очень простой и был разработан для представления объектов векторной геометрии. Ниже в таблице представлены примеры объектов в данном формате.

Тип	Примеры
Point	POINT (30 10)
LineString	LINESTRING (30 10, 10 30, 40 40)
Polygon	POLYGON ((30 10, 10 20, 20 40, 40 40, 30 10))
	POLYGON ((35 10, 10 20, 15 40, 45 45, 35 10), (20 30, 35 35, 30 20, 20 30))
MultiPoint	MULTIPOINT ((10 40), (40 30), (20 20), (30 10))
	MULTIPOINT (10 40, 40 30, 20 20, 30 10)
MultiLineString	MULTILINESTRING ((10 10, 20 20, 10 40), (40 40, 30 30, 40 20, 30 10))
MultiPolygon	MULTIPOLYGON (((30 20, 10 40, 45 40, 30 20)), ((15 5, 40 10, 10 20, 5 10, 15 5)))
	MULTIPOLYGON (((40 40, 20 45, 45 30, 40 40)), ((20 35, 45 20, 30 5, 10 10, 10 30, 20 35), (30 20, 20 25, 20 15, 30 20)))

В формате WKT все очень просто. А значит, мы можем приступить непосредственно к созданию объектов на карте. В листинге, представленном ниже, создается объект в слое с наименованием Киоски:

private void CreateObj()
{
    workLayer = mvMyMap.getLayer("Киоски");
    if (workLayer == null)
        return;
    mvVectorObject cObj = workLayer.CreateObject();        
    string wkt = "POINT(45 73)";
    cObj.setWKT(wkt);
    mvStringArray attrs = new mvStringArray();
    attrs.count = 3;
    attrs.setElem(0, "1");
    attrs.setElem(1, "Бытовая химия");
    attrs.setElem(2, "ул. Восстание д.18");
    cObj.SetAttributes(attrs);
    cObj.style = CreateStyle();
}
private int CreateStyle()
{
    mvSymbolObject symbol = new mvSymbolObject();
    symbol.shape = 0x21;
    mvFontObject font = new mvFontObject();
    font.fontname = "Map Symbols";
    font.size = 15;
    font.Color = 0xFFFFFF;
    font.framecolor = 0x000000;
    return workLayer.CreateDotStyle(symbol, font);
}

В этом примере два метода: CreateObj() и CreateStyle(). В первом происходить создание объекта, как вы наверно заметили, перед созданием стоит проверка на существование слоя. Если со слоем у нас все хорошо, то с помощью метода CreateObject() мы создаем в слое пустой объект, в котором еще нет ни координат, ни атрибутики. Однако у объекта есть метод setWKT(String) в который мы передаем координаты в формате WKT. После выполнения этого метода наш объект уже должен оказаться на том месте карты, на которое указывают координаты.

Следующим этапом при создании объекта, является, заполнение объекта атрибутивной информацией. Для этого необходимо использовать метод SetAttributes(mvStringArray) объекта. Атрибуты предварительно заполняются в mvStringArray. И на последнем этапе создаем и присваиваем стиль новому объекту.

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

mvVectorObject cObj = workLayer.getObject(1);
if (cObj == null)
    return;
mvStringArray attrs = cObj.getAttributes();
string name = attrs.getElem(1);
string address = (string)cObj.fieldValue("address");
MessageBox.Show("Киоск с названием \""+name+"\" находится по адресу: " + address); 

В этом примере получение атрибутивной информации происходит двумя способами. В первом случае информацию о наименовании киоска получаем, используя метод getAttributes(), который возвращает экземпляр класса mvStringArray, а из него по индексу элемента получаем значение атрибута. Во втором случае, информацию об адресе киоска получаем, используя метод fieldValue, у которого  аргументом является наименование нужного нам атрибута.

В таблице ниже приведены все методы класса mvVectorObject.

В этом разделе мы рассмотрим возможность индивидуального  оформления каждого объекта. В разделе, посвящённом работе с объектами, мы уже затрагивали тему создания стиля, там мы рассмотрели только стили для точечного объекта. Однако для оставшихся двух типов создание стиля не сильно отличается. В примере ниже рассматривается создание стиля для линейных и площадных объектов.

#region Создание стиля для линейного объекта
mvPenObject pen_line = new mvPenObject();
pen_line.Color = 0x333333;
pen_line.ctype = 2;
pen_line.width = 2;
line_style = workLayer.CreateLineStyle(pen_line);
#endregion
#region Создание стиля для полигонального объекта
mvPenObject pen_polygon = new mvPenObject();
pen_polygon.Color = 0x00FF00;
pen_polygon.ctype = 1;
pen_polygon.width = 2;
mvBrushObject brush = new mvBrushObject();
brush.bgcolor = 0xffff00;
brush.fgcolor = 0x00ffff;
brush.style = 0;
brush.hatch = 2;
polygon_style = workLayer.CreatePolygonStyle(pen_polygon, brush);
#endregion 

В данном примере мы создаем объекты «карандаш» и «кисть» (mvPenObject и mvBrushObject), каждый из этих объектов отвечает за свою часть стиля. Для создания стиля линейного объекта нам необходим только mvPenObject. Его в качестве аргумента и нужно передать методу CreateLineStyle слоя, который в свою очередь, так же как и с точкой, возвращает идентификатор стиля в слое.

При создании стиля для полигонального объекта кроме mvPenObject нужен еще mvBrushObject, которые является кистью. Эти два объекта передаются методу CreatePolygonStyle, который также возвращается идентификатор стиля в слое.

Таким образом, мы рассмотрели создание индивидуального стиля для каждого объекта. Однако, если в вашем слое могут быть объекты с одинаковым оформлением, то достаточно всего лишь присвоить ранее полученный идентификатор стиля созданному объекту.

В компоненте так же предусмотрен доступ к установке стиля объекта через слой. Иногда это бывает намного удобнее, нежели изменять стиль у каждого объекта. Для таких манипуляций существуют два метода: SetObjectStyle(int style, int ID) и SetObjectsStyle(int style, mvIntArray ids).

Разница между двумя этими методами в том, что первый позволяет установить стиль только для одного объекта, у которого значение атрибута идентификатора равно ID. Второй же метод может изменить стиль для множества объектов, правда перед этим вам необходимо будет сформировать объект класса mvIntArray.

В разделе «Стили» будут подробно рассмотрены создание и работа со стилями, но в них не будет затронута работа со стилями во внешних слоях. Основная часть действий сохраняется неизменной, а в случае если слой раскрашивается единообразно, то разницы в работе стилей нет.

Рассмотрим пример создания слоя, при котором необходимо раскрашивать объект в зависимости от значения атрибута в определенной колонке таблицы. В листинге ниже приводится пример создания слоя под названием «Киоски» и в зависимости от значения колонки «electricity» мы будет представлять объекты слоя в разных стилях.

ExternalSource source = mvMyMap.CreateExternalSource(mvExternalSourceTypes.mvPostGIS);
source.prepare("host =localhost port=5432 user=fail password=112233 dbname=kultura", 32639); 
source.Connect();
mvLayer workLayer = source.addLayer("data.kiosks", "Киоски", "id", "the_geom", "name", "electricity", "", "", "");
int dot_style = 0;
#region Если electricity = 0
mvSymbolObject symbol = new mvSymbolObject();
symbol.shape = 0x21;
mvFontObject font = new mvFontObject();
font.fontname = "Map Symbols";
font.size = 15;
font.Color = 0xFFFFFF; // Белый цвет точки
font.framecolor = 0x000000;
dot_style = workLayer.CreateDotStyle(symbol, font);
workLayer.SetExtStyle(0, dot_style);
#endregion
#region Если electricity = 1
font = new mvFontObject();
font.fontname = "Map Symbols";
font.size = 15;
font.Color = 0x000000;  // Черный цвет точки
font.framecolor = 0xFFFFFF;
dot_style = workLayer.CreateDotStyle(symbol, font);
workLayer.SetExtStyle(1, dot_style);
#endregion

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

Метод SetExtStyle не единственный метод, работающий со стилями в слоях, подгружаемых из внешних источников. Полный набор всех методов, необходимых для работы, представлены в таблице ниже:

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

Объекты типа mvLayer имеют следующие основные свойства:

Также слои имеют следующие методы:

 Использование свойств и методов слоя

mvLayer layer = axMapLIb1.getLayer("Название слоя");
layer.NAME ="Новое название слоя";

В дальнейшем доступ  к слою можно будет получить по его новому названию. Использование границ видимости при масштабировании:

layer.usebounds = true;
layer.MinScale = 1000;
layer.MaxScale = 500000;

Теперь слой будет видимым, если только масштаб карты находится  в пределах от 1000 до 500000. Чтобы включить или выключить видимость загруженного на карту слоя:

layer.Visible = true;

При этом, если установить это свойство в false, слой не будет отображаться, однако останется загруженным на карту. Для того чтобы можно было выбирать объекты на карте, нужно использовать свойство Selectable, и установить его в true:

layer.Selectable = true;

Доступ к выделенным объектам можно получить через метод mvLayer.GetSelected(). Для того, чтобы выбранный объект можно было также редактировать, используется свойство Editable, установленный в true:

layer.Editable = true;

 Слои отображаются в порядке их добавления на карту. То есть, если слои перекрываются, то слой который добавлен позже, окажется поверх слоя, добавленного раньше. Порядок слоев можно менять, при этом меняется порядковый номер слоя в списке слоев, а также их взаимное расположение на поверхности карты. Таким образом, можно программно управлять тем, какой слой поверх какого будет отображаться. Для этого используются 2 метода:

mvLayer.MoveDown()
mvLayer.MoveUp()

Для того, чтобы определить, какой слой на какой позиции находится, можно использовать примерно такой код (рассматриваются два слоя с названиями «Слой №1» и «Слой №2»):

int? position1 = null;
int? position2 = null;
for (int i = 0; i < axMapLIb1.LayersCount; i++)
{
    if (axMapLIb1.getLayerByNum(i).NAME == "Слой №1")
    {
        position1 = i; 
    }
    else if (axMapLIb1.getLayerByNum(i).NAME == "Слой №2")
    {
        position2 = i; 
    }
}

Теперь в переменных position1 и position2 мы имеем порядковые номера первого и второго слоя соответственно.

Геолинк

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

mvStringArray attributesList = new mvStringArray();
attributesList.count = 2;
attributesList.setElem(0, "id");
attributesList.setElem(1, "filepath");
mvLayer layer = axMapLIb1.CreateLayer("Слой с геолинком", attributesList);
layer.GeoLinkField = 1;

Мы создали слой, у которого будут два атрибута – “id”, “filepath”. Мы указали, что второй атрибут – “filepath”  будет являться геолинком. Теперь создадим объект слоя:

String wkt = "POINT(386327.172604717 6183258.75528863)"; 
mvStringArray objectAttributes = new mvStringArray();
objectAttributes.count = 2;
objectAttributes.setElem(0, "1");
objectAttributes.setElem(1, "E:\\somefile.txt"); 
mvVectorObject newObjectInLayer = layer.CreateObject();
newObjectInLayer.setWKT(wkt);
newObjectInLayer.SetAttributes(objectAttributes);
axMapLIb1.mapRepaint(); 

Мы создали объект, поле геолинка которого ссылается на файл по пути “E:\\somefile.txt”. Теперь мы программно сможем в любой момент получить доступ к связанному с объектом файлу. Также можно открыть файл связанный с объектом, используя специальный курсор:

axMapLIb1.CtlCursor = mvMapLib.Cursors.mlGeoLink;

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

 Подключение картинок как значков

Если нужно для указания точечных объектов слоя использовать некоторую картинку, можно использовать свойство слоя “ImageField”, который указывает атрибут, где будет храниться ссылка на рисунок. Однако, в отличие от геолинка, здесь хранится только название рисунка. Все рисунки должны находится в папке “images”, которая должна находится в одной директории с исполняемой программой. Также можно указать атрибут, который содержит угол поворота изображения. Пример:

mvStringArray attributesList = new mvStringArray();
attributesList.count = 3;
attributesList.setElem(0, "id");
attributesList.setElem(1, "image");
attributesList.setElem(2, "imagerotate");
mvLayer layer = axMapLIb1.CreateLayer("Слой с рисунком", attributesList);
layer.imageField = 1;
layer.imageRotateField = 2; 

Теперь создадим объект на слое и укажем картинку которая должна выводиться для данного точечного объекта:

String wkt = "POINT(386327.172604717 6183258.75528863)"; 
mvStringArray objectAttributes = new mvStringArray();
objectAttributes.count = 3;
objectAttributes.setElem(0, "1");
objectAttributes.setElem(1, "building.gif");
objectAttributes.setElem(2, "90"); 
mvVectorObject newObjectInLayer = layer.CreateObject();
newObjectInLayer.setWKT(wkt);
newObjectInLayer.SetAttributes(objectAttributes);
axMapLIb1.mapRepaint(); 

В итоге у нас должно получиться что-то вроде этого:

Рисунок 1

Как видно из рисунка, для отображения точечного объекта, используется рисунок, который указан в атрибуте объекта “image”, к которому также применен поворот в 90 градусов, указанный в атрибуте “imagerotate”.

 Подписи

Если необходимо, чтобы объекты слоя были подписаны, можно установить специальный атрибут, значение которого будет использоваться в качестве подписи объекта. Например:

mvStringArray attributesList = new mvStringArray();
attributesList.count = 2;
attributesList.setElem(0, "id");
attributesList.setElem(1, "label");
mvLayer layer = axMapLIb1.CreateLayer("Слой с подписями", attributesList);
layer.showlabels = true; 
layer.LabelField = 1;  

Теперь создадим объект с подписью:

String wkt = "POINT(386327.172604717 6183258.75528863)"; 
mvStringArray objectAttributes = new mvStringArray();
objectAttributes.count = 2;
objectAttributes.setElem(0, "1");
objectAttributes.setElem(1, "Подпись этого объекта");
mvVectorObject newObjectInLayer = layer.CreateObject();
newObjectInLayer.setWKT(wkt);
newObjectInLayer.SetAttributes(objectAttributes);
axMapLIb1.mapRepaint(); 

Теперь объект будет отображаться с подписью:

Рисунок 2

Также для указания подписей можно также использовать другой подход. Для всего слоя, можно установить выражение, которое будет определенным образом комбинировать атрибуты объекта, использовать текстовые константы и арифметические выражения, для создания подписей. Например:

layer.labelexpression = "\"Id объекта: \" + id + \". Комментарий: \" + label";

При этом надо установить свойство LabelField в 1001, и showlabels в true:

layer.showlabels = true;
layer.LabelField = 1001;

В итоге мы должны получить нечто вроде этого:

Рисунок 3