2. Revit API UI 之 IExternalCommand 和 IExternalApplication

2. Revit API UI 之 IExternalCommand 和 IExternalApplication

上一篇我们大致看了下 RevitAPI 的一级命名空间划分,再简单讲了一下Attributes命名空间下的3个类,并从一个代码样例,提到了AttributesIExternalCommand ,前者是指示外部命令要满足的要求或要执行的动作,后者呢,就是外部命令接口。和外部命令接口类似的接口,还有IExternalApplication(外部应用)和IExternalEventHandler(外部事件)

这一篇呢,如题目所说,讲的是UI命名空间的部分,讲其中的IExternalCommand IExternalApplication这两个接口

Revit UI Namespace

在讲外部命令和外部事件之前,我们得先了解一下UI命名空间下,都有哪些东西。

我在这儿贴了一个图,该导图使用FreeMind制作。

注:图中包含Autodesk.Revit.UI下的所有成员

在这里插入图片描述

IExternalCommand 外部命令

当一个类实现了IExternalCommand 接口,就可以通过官方插件Addin Manager加载运行测试。该插件可以在安装的 Revit SDK 目录下找到,具体就不多介绍了。

在这里插入图片描述

接口实现

IExternalCommand 接口需要实现一个Execute方法,该方法传入了3个参数:

  • commandData:包含应用程序、视图、日志映射的引用,这些是外部命令所需的;
  • message:如果命令失败,可以返回错误消息,这个字符串有1023个字符的限制;
  • elements:如果命令失败,可以指示问题元素的集合。

先看个示例代码,作用是删除项目中的所有元素。

public Result Execute(ExternalCommandData commandData, ref string message, ElementSet elements)
{UIApplication uiApp = commandData.Application;  // 拿到当前活跃着的会话UIDocument uiDoc = uiApp.ActiveUIDocument;  // 拿到UI交互相关的引用Document doc = uiDoc.Document;  // 拿到文档引用,操作一般都在这个上面// 启动一个事务,删除文档中的元素。// 不要忘记了上一篇的TransactionAttributeusing (Transaction transaction = new Transaction(doc, "delete all element")){try{transaction.Start();  // 开始事务FilteredElementCollector collector = new FilteredElementCollector(doc);IList<Element> elementsToDelete = collector.ToElements();foreach (Element element in elementsToDelete){doc.Delete(element.Id);}transaction.Commit();  // 提交事务}catch (Exception ex){transaction.RollBack();  // 回滚事务message = ex.Message;return Result.Failed;⌈⌋}}return Result.Succeeded;
} 

好了,这个接口的使用就是这么的简单。


IExternalApplication 外部应用

同样的,实现IExternalApplication 接口,再通过.addin配置文件进行注册,就可以愉快得使用啦。

与外部命令不同的,是外部应用要实现的不在是⌈执行⌋方法,而是OnStartup OnShutdown

接口实现

OnStartup 方法会在Revit启动时调用,允许开发者执行初始化任务,比如添加界面、设置事件处理器等。

OnShutdown 就是在Revit关闭时调用。一般用于行清理工作,比如注销事件处理器、保存设置、释放资源等。

看一个例子,Revit启动的时候,在Revit最顶栏加一个叫“测试Tab”的选项,内部就一个叫“Panel”的面板,面板里就一个“Bottun”按钮。

还有呢,会启动一个空闲事件,作用是Revit有空的时候就打印一下。

using Autodesk.Revit.DB.Events;
using Autodesk.Revit.UI;
using Autodesk.Revit.UI.Events;
using Nice3point.Revit.Toolkit.External;  // 一个三方库,封装了IExternalApplication接口// 基本没区别,需要实现的方法没参数了
namespace RevitDuctLoad
{[UsedImplicitly]public class Application : ExternalApplication{public override void OnStartup(){this.CreateRibbon(this.Application);  // 创建按钮this.Application.Idling += new EventHandler<IdlingEventArgs>(this.IdlingHandler);	// 开启空闲事件}public override void OnShutdown(){this.Application.Idling -= new EventHandler<IdlingEventArgs>(this.IdlingHandler);	// 关闭空闲事件}private void IdlingHandler(object sender, IdlingEventArgs e){TaskDialog.Show("提示", $"空闲事件:{DateTime.Now.ToString("mm:ss")}");}private void CreateRibbon(UIControlledApplication application){string tabName = "测试Tab";application.CreateRibbonTab(tabName);  // 再RibbonPanel panel = application.CreateRibbonPanel(tabName, "Panel");PushButton button = panel.AddItem(new PushButtonData("Bottun", "Bottun", AddInPath, "XXX.TestCommand")) as PushButton;button.ToolTip = "这是一个测试按钮,执行测试命令";}}
}

结尾

就一丢丢内容,也没什么好说的。

这一节我们提到了DocumentUIDocumentTransaction(事务),还有 Ribbon(界面相关)和 Idling(空闲事件),这些我们后面讲。

噢,还提到了一个同样是“外部”东西 IExternalEventHandler,这个要到再后面一些了。

下一篇南北,讲一下 Dialog 相关的内容,比较简单,就先写了。

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.mzph.cn/bicheng/29655.shtml

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

epoll服务端和客户端示例代码

epoll 服务端demo #include <stdio.h> #include <sys/epoll.h> #include <sys/socket.h> #include <sys/types.h> #include <netinet/in.h> #include <arpa/inet.h> #include <fcntl.h> #include <unistd.h> #include <ne…

【docker 如何自定义镜像】

查看容器列表 首先是查看容器&#xff1a;在命令台中键入 docker ps -a 命令&#xff0c;得到如下界面。 从容器创建一个新镜像 接着&#xff0c;dockers commit 容器名 要保存成的镜像名&#xff1a;版本名&#xff08;若没有 &#xff1a;版本名 则直接默认为latest&#x…

golang常用库之-KV数据库之pebble

文章目录 golang常用库之-KV数据库之pebblepebble官方示例代码 实战pebble常用方法NewSnapshot方法NewIndexedBatch 方法 参考 golang常用库之-KV数据库之pebble rocksdb是一款由Facebook使用C/C开发的嵌入式的持久化的KV数据库。 Pebble 是 Cockroach 参考 RocksDB 并用 Go …

USB 端点停止

文章目录 功能停止USB 设备设置停止特性设备设置端点停止特性示例bRequestwValuewIndex示例USB 主机设置停止特性协议停止握手包中有一个 STALL 包,由 USB 设备方发出,用来表示某个端点不能发送或者接收数据,或者表示不支持控制传输的某种请求。 端点一旦发出 STALL 包,表…

【网络安全】网络安全基础精讲 - 网络安全入门第一篇

目录 一、网络安全基础 1.1网络安全定义 1.2网络系统安全 1.3网络信息安全 1.4网络安全的威胁 1.5网络安全的特征 二、入侵方式 2.1黑客 2.1.1黑客入侵方式 2.1.2系统的威胁 2.2 IP欺骗 2.2.1 TCP等IP欺骗 2.2.2 IP欺骗可行的原因 2.3 Sniffer探测 2.4端口扫描技术…

2024新版AI创作系统pro搭建,支持文生漫画视频ai对话问答/ai音乐创作/ai测评/ai换脸/ai写真

一、系统介绍 一款结合了多种功能应用&#xff0c;是当前市场最热门的AI工具综合体 AI动漫生成 AI音乐创作 AI写真 AI换脸 AI绘画 AI趣测 六大AI功能 AI创作小程序是一种利用人工智能技术为用户提供服务&#xff0c;并通过某种方式实现的小程序。这种小程序可以应用于多…

gRPC(Google Remote Procedure Call Protocol)谷歌远程过程调用协议

文章目录 1、gRPC简介2、gRPC核心的设计思路3、gPRC与protobuf关系 1、gRPC简介 gPRC是由google开源的一个高性能的RPC框架。Stubby Google内部的RPC&#xff0c;演化而来的&#xff0c;2015年正式开源。云原生时代是一个RPC标准。 2、gRPC核心的设计思路 网络通信 ---> gPR…

vue中通过自定义指令实现一个可拖拽,缩放的弹窗

效果 功能描述 按住头部可拖拽鼠标放到边框&#xff0c;可缩放多层重叠丰富的插槽&#xff0c;易于扩展 示例 指令代码 export const dragDialog {inserted: function (el, { value, minWidth 400, minHeight 200 }) {// 让弹窗居中let dialogHeight el.clientHeight ?…

Flink Kafka获取数据写入到MongoDB中 样例

简述 Apache Flink 是一个流处理和批处理的开源框架&#xff0c;它允许从各种数据源&#xff08;如 Kafka&#xff09;读取数据&#xff0c;处理数据&#xff0c;然后将数据写入到不同的目标系统&#xff08;如 MongoDB&#xff09;。以下是一个简化的流程&#xff0c;描述如何…

Vue61-消息订阅与发布-任意组件之间的通信

一、原理图 原生的JS不能实现订阅与发布&#xff0c;要借助第三方库&#xff1a;pubsub-js&#xff08;任何一个框架都能用&#xff01;&#xff09; 二、案例实现 school组件&#xff0c;需要数据&#xff08;订阅消息&#xff09;&#xff0c;student组件提供数据&#xff0…

Linux中的EINTR和EAGAIN错误码

Linux中的EINTR和EAGAIN错误码 在Linux系统中&#xff0c;进行系统调用时经常会遇到各种错误码。其中&#xff0c;EINTR&#xff08;Interrupted system call&#xff09;和EAGAIN&#xff08;Resource temporarily unavailable&#xff09;是两个较为常见的错误码&#xff0c…

MySQL 高级 - 第十二章 | 数据库的设计规范

目录 第十二章 数据库的设计规范12.1 为什么需要数据库设计12.2 范式12.2.1 范式简介12.2.2 范式都包括哪些12.2.3 键和相关属性的概念12.2.4 第一范式&#xff08;1st NF&#xff09;12.2.5 第二范式&#xff08;2nd NF&#xff09;12.2.6 第三范式&#xff08;3rd NF&#xf…

JWT详解、JWTUtil工具类的构建方法

一、前言 使用一些用户不友好的项目时&#xff0c;会发现&#xff0c;每一次进入网站&#xff0c;我们都要重新登录。 这是为什么呢&#xff1f; 现代多采用前后端分离的项目架构&#xff0c;这种架构&#xff0c;前后端使用不同的服务器&#xff0c;两个服务器上存储的信息不…

onnx进阶算子优化

一、定义 如何保证pytorch 模型顺利转为onnx. 前言pytorch 算子是如何与onnx 算子对齐的&#xff1f;Asinh 算子出现于第 9 个 ONNX 算子集。PyTorch 在 9 号版本的符号表文件中是怎样支持这个算子的&#xff1f;BitShift 算子出现于第11个 ONNX 算子集。PyTorch 在 11 号版本…

事务AOP

事物管理 事务管理是指对一系列数据库操作进行管理&#xff0c;确保这些操作要么全部成功执行&#xff0c;要么在遇到错误时全部回滚&#xff0c;以维护数据的一致性和完整性。在多用户并发操作和大数据处理的现代软件开发领域中&#xff0c;事务管理已成为确保数据一致性和完…

链表相对于数组的优势,以及栈和队列的基本操作

链表&#xff08;Linked List&#xff09;和数组&#xff08;Array&#xff09;是两种常见的数据结构&#xff0c;它们各自在不同的场景下有其优势和劣势。链表相对于数组的优势主要体现在以下几个方面&#xff1a; 动态大小&#xff1a; 链表在插入和删除元素时&#xff0c;不…

4M-21:霸气侧漏高效的20+多模态AI模型

大模型技术论文不断&#xff0c;每个月总会新增上千篇。本专栏精选论文重点解读&#xff0c;主题还是围绕着行业实践和工程量产。若在某个环节出现卡点&#xff0c;可以回到大模型必备腔调或者LLM背后的基础模型重新阅读。而最新科技&#xff08;Mamba,xLSTM,KAN&#xff09;则…

软件设计不是CRUD(22):在流式数据处理系统中进行业务抽象落地——设计思考

(接上文《软件设计不是CRUD(21):在流式数据处理系统中进行业务抽象落地——需求分析》) 那么思考到这里我们就能做一些关于设计思路的总结: 每一个独立的数据处理流,就是数据采集系统中的一个功能。这个功能具备一个静态的控制逻辑(当然控制逻辑也可以是动态的,本文不…

嵌入式技术学习——c51单片机——蜂鸣器

一、蜂鸣器介绍 蜂鸣器时一种将电信号转化成声音信号的器件&#xff0c;常用来产生设备的按键音&#xff0c;报警音等提示信号。 蜂鸣器分为有源蜂鸣器&#xff0c;无源蜂鸣器 。 有源蜂鸣器&#xff1a;内部自带震荡源&#xff0c;将正负极街上直流电压即可持续发声&#x…

通过摄像头检测步频

通过摄像头识别运动频率&#xff0c;比如步频。 打开摄像头 循环读取视频帧 灰度转换 统计中间一行数值和 人在摄像头前运动&#xff0c;该数值会呈现周期变化 通过快速傅里叶转换&#xff0c;将和步频相似频率显示出来。 &#xff08;尝试人脸检测&#xff0c;跟着人脸位置变…