ADN Open CIS
Сообщество программистов Autodesk в СНГ

Легкое создание кнопок на ленте для вызова внешних команд

Создавая собственную внешнюю команду в интерфейсе Revit ее можно вызвать двумя способами:

Описать внешнюю команду в файле манифеста addin

В этом случае Revit автоматически добавит команду в раскрывающийся список Внешние инструменты на вкладке Надстройки

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

В Revit есть несколько типов кнопок. Самый простой и часто используемый – PushButton.

PushButton может быть высотой с размер панели на ленте, а также можно разместить кнопки в вертикальный ряд по три кнопки, соответственно размер кнопки будет 1/3 от высоты панели.

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

Создавать свои вкладки, панели и кнопки необходимо в методе OnStartup класса, реализуемого интерфейс IExternalApplication. Данный класс необходимо зарегистрировать в файле манифеста

При загрузке Revit будет выполнен метод OnStartup объявленного класса.

Для создания кнопки, необходимо:

1)      Создать объект класса PushButtonData в котором необходимо указать:

• Идентификатор кнопки. Задается строкой. Должен быть уникальным среди всех кнопок в Revit. Задается строкой
• Название кнопки, которое будет видеть пользователь
• Путь к файлу сборки, в котором находится команда, которую нужно вызвать при нажатии на кнопку
• Полное название класса команды, т.е. класса, реализующего интерфейс IExternalCommand, находящегося в сборке, указанной в предыдущем параметре.
• Дополнительно можно задать изображение для кнопки.
• Также можно задать дополнительное описание команды, которое пользователь будет видеть при наведении курсора мыши на кнопку

2)      Добавить на панель новую кнопку, передав объект класса PushButtonData. Саму панель предварительно нужно получить.

Полный код, создающий новую вкладку и затем панель, выглядит примерно так:

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

1)      Необходимо указывать путь к файлу сборки. Это конечно полезно, когда вам нужно добавить кнопку на выполнения команды из внешней сборки. Но в 99% случаев класс команды находится в той же самой сборке, где и метод создания кнопки. Как минимум этот параметр можно было сделать опциональным.

2)      Необходимость указывать название класса команды в виде строки. А значит нет подсказки при вводе наименования. Необходимо беспокоиться о названии при переименовании класса команды

3)      Изображение необходимо задавать в виде объекта класса ImageSource. Это конечно решаемо, но создает некие трудности, например, нельзя просто так вставить изображение из ресурсов.

4)      Невозможно проверить есть ли вкладка с таким именем или нет. Это необходимо, например, если вы создаете несколько своих приложений в разных проектах и их необходимо поместить на одну вкладку.

5)      То же самое, но с панелью

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

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

Результат создания двух кнопок стандартным методом и с помощью утилиты выглядит так:

Утилита устранят все недостатки создания кнопок стандартным методом и обладает интуитивно понятным, так называемым, fluent интерфейсом.

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

Приведу пример более создания большего количество кнопок

Для создания 8 кнопок также было использовано всего одно выражение:

Для использования утилиты вам необходимо добавить сборку VCRevitRibbonUtil.dll в ваш проект и добавить

Скачать исходный код утилиты вы можете на GitHub или в виде архива.