Добавил:
Upload Опубликованный материал нарушает ваши авторские права? Сообщите нам.
Вуз: Предмет: Файл:
StarUML.pdf
Скачиваний:
94
Добавлен:
26.03.2015
Размер:
7.31 Mб
Скачать

StarUML. Руководство разработчика. Глава 4. Использование API

43 / 139

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

var selmgr = app.SelectionManager;

var v = ...

...

selmgr.SelectView(v);

...

selmgr.SelectAdditionalView(v);

...

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

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

var selmgr = app.SelectionManager;

var v = ... // Присваиваем ссылку на элемент.

...

selmgr.DeselectView(v); // Снимаем выбор образа 'v'.

...

selmgr.DelselectAllViews(); // Снимаем выбор всех элементов.

...

Выбор области диаграммы

Визуальные образы могут быть выбраны, посредством ввода координат области выбора в активной диаграмме. Используйте метод SelectArea, чтобы сделать это, а также метод SelectAdditionalArea, чтобы добавить элементы к выбранным через дополнительную область. Следующий пример выбирает все визуальные образы, расположенные в пределах области координат (100, 100, 500, 300) на активной диаграмме.

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

selmgr.SelectArea(100, 100, 500, 300);

Использование диалога выбора элементов

StarUML™ предоставляет два диалога для того, чтобы выбирать определенные элементы: ElementSelector, с древовидным изображением иерархии элементов, и ElementListSelector с перечнем элементов в виде списка. ElementSelector - используется чаще, поскольку он позволяет выбирать элементы в иерархической структуре, аналогичной навигатору модели. ElementListSelector обычно используется, если нужно выбирать элементы одного типа.

Работа с объектом ElementSelector

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

StarUML. Руководство разработчика. Глава 4. Использование API

44 / 139

Ссылка на объект ElementSelector может быть получена через объект StarUMLApplication как показано в примере ниже.

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

Диалог ElementSelector предоставляет следующие свойства и методы.

 

Свойство

 

 

Описание

 

 

 

 

 

 

AllowNull: Boolean

Определяет, позволено ли возвращать пустое значение.

 

 

 

 

 

 

 

 

Метод

 

 

Описание

 

 

 

 

 

 

 

 

 

 

 

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

 

 

 

 

 

Значение может быть одним из следующих.

 

 

 

 

 

fkAll (0): Показывать все элементы.

 

 

Filter(Filtering: ElementFilteringKind)

 

fkPackages (1): Показывать только элементы типа

 

 

 

 

 

UMLPackage (UMLPackage, UMLModel, UMLSubsystem).

 

 

 

 

 

fkClassifiers (2): Показывать только элементы типа

 

 

 

 

 

UMLClassifier .

 

 

 

 

 

 

 

 

ClearSelectableModels

 

 

Очищает список выбранных типов элементов.

 

AddSelectableModel(ClassName: String) Добавляет указанный тип к списку выбираемых типов элементов. Пример значения параметра: "UMLClass"

RemoveSelectableModel(ClassName:

Удаляет выбранный тип из списка выбираемых типов элементов.

String)

Пример значения параметра: "UMLClass"

Execute(Title: String): Boolean

Выполняет диалог. Устанавливает указанный заголовок диалога.

GetSelectedModel: IModel

Возвращает ссылку на выбранный пользователем элемент.

Следующий пример показывает весь процесс выполнения диалога ElementSelector и получение

StarUML. Руководство разработчика. Глава 4. Использование API

45 / 139

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

fkClassifiers = 2;

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

sel_dlg.AllowNull = false; sel_dlg.Filter(fkClassifiers) sel_dlg.ClearSelectableModels(); sel_dlg.AddSelectableModel("UMLModel"); sel_dlg.AddSelectableModel("UMLSubsystem"); sel_dlg.AddSelectableModel("UMLPackage");

if (sel_dlg.Execute("Select a classifier type element.")){ var elem = sel_dlg.GetSelectedModel;

...

}

else{

// If canceled, ...

}

Работа с объектом ElementListSelector

ElementListSelector - диалог, который отображает элементы в виде одномерного списка и позволяет просматривать их и выбрать элемент.

Ссылка на объект диалога ElementListSelector может быть получена через объект StarApplication как показано в примере ниже.

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

Диалог ElementListSelector предоставляет следующее свойство и методы.

Свойство

Описание

 

 

AllowNull: Boolean

Определяет, позволено ли возвращать пустое значение.

 

 

Метод

Описание

 

 

ClearListElements

Очищает список.

AddListElement(AModel:

Добавляет элемент, определенный параметром в список.

IModel)

 

Соседние файлы в предмете [НЕСОРТИРОВАННОЕ]