Использование групп акций

Возможно отменить или восстановить любые выполненные пользователем действия. То же самое касается любых команд, выполненных через API. Если команда выполнена дважды, и пользователь желает отменить результат, отмена также должна быть выполнена дважды. Однако, бывают случаи, когда пользователь хочет комбинировать различные команды и обрабатывать их как единое действие. Например, для отмены изменения значения определенного свойства, нужно вернуть свойству то значение, которое у него было до вызова функций Get и Set. Однако, в комбинации с функциями Get/Set могло выполняться много команд. В таком случае, несколько команд могут быть объединены в группу и обработаны как одно действие.

Объект StarUMLApplication позволяет выполнять группы команд как единое действие, используя методы BeginGroupAction и EndGroupAction. При вызове метода BeginGroupAction, будет создана новая виртуальная группа акций.

Все действия, выполненные после этого вызова, будут добавлены в группу, а когда будет вызван метод EndGroupAction, группировка действий, будет закончена. После выполнения BeginGroupAction нужно вызвать EndGroupAction, даже если произошла ошибка в действиях, включенных в группу. Поэтому должен использоваться блок обработки прерываний. Действие группы интерпретируется как единое действие при выполнении отмен или восстановлений.

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

...

app.BeginGroupAction(); try {

...

}

finally { app.EndGroupAction();

}

...

При вызове метода BeginGroupAction, результат будет тот же самый, как при вызове BeginUpdate. Аналогично, вызов метода EndGroupAction приводит к тому же результату, что и вызов EndUpdate. Другими словами, изменения не будут приняты, пока группа должным образом не будет закончена. Поэтому методы BeginUpdate или EndUpdate не должны использоваться между BeginGroupAction и EndGroupAction.

Обработка выбранных элементов

StarUML™ предоставляет способ получения информации относительно модельных элементов или представлений, выбранных пользователем, а также позволяет выбирать некоторые элементы принудительно. Все эти функции определены в интерфейсе ISelectionManager.

Получение выбранных элементов

Чтобы получить список модельных элементов или представлений, выбранных в данный момент, сначала должна быть получена ссылка на SelectionManager. Затем нужно написать код подобный следующему.

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

// Список выбранных элементов

for (i=0; i<selmgr.GetSelectedModelCount(); i++) { var m = selmgr.GetSelectedModelAt(i);

...

}

// Список выбранных представлений.

for (i=0; i<selmgr.GetSelectedViewCount(); i++) { var v = selmgr.GetSelectedViewAt(i);

...

}

Получение активной диаграммы

Можно получить ссылку на активную диаграмму (диаграмму, которая в данный момент отображена на экране). Диаграмма всегда управляется двумя отдельными объектами: Diagram и DiagramView. Ссылки и на объект Diagram и на объект DiagramView могут быть получены отдельно.

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

var dgm = selmgr.ActiveDiagram // Диаграмма, которая становится активной

var dgmview = selmgr.ActiveDiagram // объект DiagramView для активной диаграммы

Выбор модельных элементов

Чтобы выбрать определенные элементы (например, класс, интерфейс, компонент...), используется метод SelectModel. Вызов этого метода сбрасывает все выбранные до этого элементы и устанавливает выбор только одного указанного элемента. Чтобы сохранить текущий выбор и добавить к выбору другие модельные элементы, должен использоваться метод SelectAdditionalModel.

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

var selmgr = app.SelectionManager;

var m = ... // Присваиваем ссылку на выбираемый модельный элемент.

...

selmgr.SelectModel(m); // Выбираем только элемент 'm'.

...

selmgr.SelectAdditionalModel(m); // Добавляем элемент 'm' к выбранным.

...

Чтобы отменить выбор модельных элементов, используйте метод DeselectModel как показано в примере ниже.

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

var selmgr = app.SelectionManager;

var m = ... // Присваиваем ссылку на элемент, который будет деактивирован.

...

selmgr.DeselectModel(m); // Деактивируем элемент 'm'.

...

selmgr.DelselectAllModels(); // Деактивируем все элементы.

...

Выбор представлений

Чтобы выбирать визуальные представления, отображаемые на диаграмме, используйте метод SelectView. Вызов этого метода деактивирует все выбранные на данный момент визуальные образы и выбирает только один. Чтобы, не снимая текущего выбора, добавлять визуальные образы к уже выбранным, должен использоваться метод SelectAdditionalView.