var class1 = factory.CreateClass(rootElem); var class2 = factory.CreateClass(rootElem);

var dependency = factory.CreateDependency(rootElem, class1, class2); var association = factory.CreateAssociation(rootElem, class1, class2); var diagram = factory.CreateClassDiagram(rootElem);

var diagramView = diagram.DiagramView; // Создание представлений.

var classView1 = factory.CreateClassView(diagramView, class1); var classView2 = factory.CreateClassView(diagramView, class2);

var dependencyView = factory.CreateDependencyView(diagramView, dependency, classView1, classView2);

var associationView = factory.CreateAssociationView(diagramView, association, classView1, classView2);

// Выравнивание образов. classView1.Left = 100; classView1.Top = 100; classView2.Left = 300; classView2.Top = 100; app.OpenDiagram(diagram);

}

finally{

app.EndUpdate();

}

}

Удаление представлений

Метод DeleteView интерфейса IStarUMLApplication может использоваться, чтобы удалять представления. Помните, что когда модельный элемент удаляется, его представления автоматически удаляются вместе с ним, но когда удаляется представление, соответствующий ему модельный элемент не удаляется.

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

...

app.DeleteView(dependencyView);

app.DeleteView(associationView);

...

Использование API для объекта приложения

Управление объектом приложения

Объект StarUMLApplication

Первое, что нужно получить, чтобы использовать API StarUML™ - ссылку на объект StarUMLApplication. Все другие объекты могут быть получены через него.

Интерфейс IStarUMLApplication - абстракция приложения StarUML™, содержит следующие методы.

•Методы акций пользователя (Undo, Redo, ClearHistory, BeginUpdate, EndUpdate, BeginGroupAction, EndGroupAction, ...)

•Методы редактирования элементов(Copy, Cut, Paste, ...)

•Методы удаления модельных элементов, представлений, диаграмм (DeleteModel, DeleteView, ...)

•Чтение значений опций (GetOptionValue)

•Методы просмотра журнала, сообщений и web-страниц (Log, AddMessageItem, NavigateWeb, ...)

•Управление диаграммами (OpenDiagram, CloseDiagram, ...)

•Другие методы (FindByPathname, SelectInModelExplorer, ...)

Управление открытыми диаграммами

В области диаграмм StarUML™ , открытые диаграммы располагаются на вкладках, как иллюстрировано ниже. Активизированную на конкретный момент времени диаграмму называют активной диаграммой.

Чтобы открыть диаграмму, используйте следующий код. Если диаграмма не является уже открытой, она откроется и автоматически станет активной. Если диаграмма уже открыта, она будет установлена как активная диаграмма.

var app = new ActiveXObject("StarUML.StarUMLApplication"); var dgm = ... // присваивание открываемой диаграммы. app.OpenDiagram(dgm);

Чтобы получить ссылку на открытые диаграммы, используйте методы GetOpenedDiagramCount и GetOpenedDiagramAt.

var app = new ActiveXObject("StarUML.StarUMLApplication");

...

for (i=0; i<app.GetOpenedDiagramCount(); i++) { var dgm = app.GetOpenedDiagramAt(i);

...

}

Открытые диаграммы могут быть закрыты. В этом случае может использоваться метод CloseDiagram. Используйте метод CloseAllDiagram, чтобы закрыть все диаграммы, или метод CloseActiveDiagram, чтобы закрыть только активную диаграмму.

var app = new ActiveXObject("StarUML.StarUMLApplication"); var dgm = ... // Assign a diagram to close. app.CloseDiagram(dgm);

Запись в журнал

Закладка [Output] в информационной области StarUML™ обеспечивает интерфейс для того, чтобы записывать и показывать журнал выполнения приложения пользователю.

Чтобы делать запись в секцию [Output] , используйте метод Log как показано в следующем примере.

var app = new ActiveXObject("StarUML.StarUMLApplication"); app.Log("This is a test log...");

Работа с сообщениями

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

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

var app = new ActiveXObject("StarUML.StarUMLApplication"); app.AddMessageItem(0, "This is general message...", app.GetProject()); app.AddMessageItem(1, "This is find result message...", app.GetProject());

app.AddMessageItem(2, "This is verification result message...", app.GetProject());

Двойное нажатие на сообщении автоматически выбирает связанный элемент в навигаторе модели, и если элемент отображается на диаграмме, эта диаграмма становится активной.

Поиск элемента по пути

Элемент может быть найден по своему полному имени (пути). Например, путь для элемента Class1, расположенного в Package2, который находится в Package1 - ":: Package1:: Package2:: Class1". Путь (полное имя) - цепочка имен элементов, связанных разделителем "::". Поиск всегда

начинается от проекта верхнего уровня.

Так как имя проекта верхнего уровня - всегда пустая строка, любое имя пути начинается с "::". Однако, можно опустить начальный разделитель "::". Другими словами, выражение типа "Package1:: Package2:: Class2" интерпретируется также как то, что указано выше. Следующий примера показывает получение ссылки на модельный элемент по его пути.

var app = new ActiveXObject("StarUML.StarUMLApplication"); var elem = app.FindByPathname("::Logical View::Class1");

...

Управление изменениями в приложении

Когда пользователь вносит некоторое изменение или исполняет некоторую команду через API, соответствующая модификация модели отображается немедленно.

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

Пользователь может вызвать метод BeginUpdate перед выполнением сложной и длинной задачи, а метод EndUpdate - немедленно после её выполнения, чтобы отобразить изменения. Нужно учитывать, что никакие изменения не будут отображены вообще, если после вызова BeginUpdate метод EndUpdate не будет вызван из-за ошибок или других проблем при выполнении задачи. Для предотвращения таких проблем должен использоваться блок обработки исключений, как показано в следующем примере.

var app = new ActiveXObject("StarUML.StarUMLApplication");

...

app.BeginUpdate(); try {

... // Place tasks to process here.

}

finally {

app.EndUpdate(); // The finally block will be executed even if an exception occurs in the try block.

}

...

Для того, чтобы указывать конец модификаций и вызывать отображение изменений, может также использоваться метод EndUpdate2 вместо метода EndUpdate. Оба метода имеют одинаковый эффект, но EndUpdate2 обеспечивает более детальный контроль. Этот метод имеет следующие два аргумента.