Пространство имен: ARO.AIS.API.Revit

Сборка: ARO.AIS.API.dll


Интерфейс описания команд для ПО Revit.

 public interface IRevitCommand : ICommand

Наследование: ICommandIRevitCommand


Навигация

Свойства

Методы

Примеры

Подробное описание

Свойства

ControlВозвращает объект описывающий элемент управления для Команды
TooltipImageВозвращает пиктограмму/картинку для расширенной подсказки Revit

Методы

Execute(object, IRevitTransaction)Вызывается в момент запуска команды с панели Revit. 
ForcedStop(object)Вызывается в случаях программного прерывания выполнения команды и выгрузки команды.

Примеры

В этом примере рассматривается создание класса команды.

using ARO.AIS.API;
using ARO.AIS.API.Revit;
using ARO.AIS.API.Utils;
using Autodesk.Revit.UI;
using System;
using System.Windows;

namespace ARO.AIS.Revit.Commands
{
    public class SampleCommand : IRevitCommand
    {
        public string Uid => "00000000000000000000000000000000";

        public string Name => "Sample command";

		public string Tooltip => "Short tooltip";

        public string Description => "Show current user login";

        public Version Version => new Version(1, 0);

        public int Product => SupportedProduct.REVIT_2022;

        public byte[] Logo => null;

		public IRevitControl Control => AISTools.RevitTool.CreateButton().AsSingleOnly().SetSize(RevitButtonSize.LARGE).ToGroup("Samples");

		public byte[] TooltipImage => null;

        public byte Execute(object application, IRevitTransaction transaction)
        {
            _ = MessageBox.Show($"Current Username: {(application as UIApplication)?.Application?.Username}");

            return RevitCommandStatus.OK;
        }

        public void ForcedStop(object application) { }
    }
}


Подробное описание

Свойства


Control

Возвращает объект описывающий элемент управления для Команды. Не может быть null.

IRevitControl Control { get; }


TooltipImage

Возвращает пиктограмму/картинку для расширенной подсказки Revit в виде массива байт. Может быть null.

byte[] TooltipImage { get; }

Методы


Execute(object, IRevitTransaction)

 Вызывается в момент запуска команды с панели Revit.

byte Execute(object application, IRevitTransaction transaction)

Параметры
object application - ссылка на объект UIApplication, который представляет активный сеанс пользовательского интерфейса Revit.
IRevitTransaction transaction - объект для управления вызовами транзакций Revit.

Возвращаемое значение
byte - результат (статус) работы Команды. Допустимые значения могут быть получены из вспомогательного класса по кодированию статуса Команды для Revit (RevitCommandStatus).


ForcedStop(object)

Вызывается в случаях программного прерывания выполнения команды и выгрузки команды.

void ForcedStop(object application)

Параметры
object application - ссылка на объект UIApplication, который представляет активный сеанс пользовательского интерфейса Revit.