5. Revit API: Application

5. Revit API: Application

前言

上一篇中,讲到了UI篇的Ribbon(界面),并提到要创建 RibbonPanel,需要使用UIControlledApplication.CreateRibbonPanel(..)方法,还在结尾说到要写“UI”开头的那些个类,本来呢是这么想的,但写的时候,发现单独写UI类不好,与它们关联的类有不少呢,所以想想,还是把相关的内容都放一块儿,一起写了得了。


Application 相关类

Application 的翻译是“应用/应用程序”,也就是APP的简写。在程序中,一般与配置、操作、框架之类的相关。在Revit中,就是①本身表示某类应用,②提供某类操作的入口,并且都定义了不少事件。

这一篇标题是Application,与之直接关联的类或接口有哪些呢?我整了个图,一起看看。

IExternalApplication(外部应用)接口 -> 其方法提供了UIControlledApplication参数 -> 该参数有属性ControlledApplication -> 又能从该属性中拿到Creation命名空间下的另一个Application类。

IEcternalCommand(外部命令)部分的图也这样看下去。

根据它们之间的关联,这一篇,我们就讲一讲这4个:

  • UIApplicationUIControlledApplication
  • UIxxxXXX
  • ApplicationControlledApplication
  • Autodesk.Revit.Creation.Application:这个先简单提一下,后面专门写Creation相关的东西。

在这里插入图片描述

一、UIApplication 与 UIControlledApplication

UIApplicationUIControlledApplication 都是 Autodesk.Revit.UI 命名空间下的类,也都是直接派生自 System.Object ,尽管它们之间**共享**大部分属性、方法和事件,但它们之间并不存在继承关系,我们带着问题来了解它们。

1.1. 是做什么的

UIApplication 和 UIControlledApplication 都是用来操作界面的,它们之间共享了大部分属性、方法和事件,可以当作是同一个来使用。

我们来看看方法:

MethodsDescriptionUIAppUIC..App
CanPostCommand
PostCommand
主动触发一些命令
CreateAddInCommandBinding
RemoveAddInCommandBinding
LoadAddIn
重绑定按钮和外部命令
加载外部命令
CreateRibbonPanel x3
CreateRibbonTab
GetRibbonPanels x3
创建/查询工具栏处的界面。
x3表示有3个重载
DoDragDrop x2文件拖入Revit时会执行的操作。Revit有默认行为
GetDockablePane
RegisterDockablePane
获取/注册 可停靠界面DockablePane
OpenAndActivateDocument x2更改活动文档

可以看到,UIApplication只多了文件拖入和更改活动文档这两类方法。

属性上,提供一些指向具体操作的实例, 如下图。

在这里插入图片描述

而事件呢,则是完全一样。

从事件上看,UIApplicationUIControlledApplication的管理范围,基本就限定在展示上(文档操作之外)。

结合方法,基本就是一些“准备/前置”工作。

EventsDescription
ApplicationClosing应用关闭时触发
DialogBoxShowing
DisplayingOptionsDialog
对话框、对话选项
DockableFrameFocusChanged
DockableFrameVisibilityChanged
可停靠界面 聚焦/显影变化
Idling空闲事件
ViewActivated
ViewActivating
视图切换
FabricationPartBrowserChanged
TransferredProjectStandards
TransferringProjectStandards
不看

1.2. 差异与产生原因

最直接的导致差异的原因,应该是这两者的来源不同吧。

UIControlledApplication是实现外部应用接口时,由方法OnStartup/OnShutdown提供,此时Revit刚刚启动,未打开任何Revit项目。

UIApplication 主要是实现外部命令接口时,由方法Execute(ExternalCommandData..)提供,此时【已打开】了Revit项目。

从这儿,我们也就理解了,为什么方法和属性略有差异,而事件则完全相同了。

比如 UIApplication 多出的那几个方法,总得Revit打开了,能交互了,才能拖拽文件进去,才有视图能切换嘞。

注:【已打开】
启动Revit后停在欢迎界面,没有打开具体的项目呢,此时插件的不可用的。我就是要点点试试怎么办?上一篇提到的按钮的AvailabilityClassName属性,可以改变按钮可用状态。效果嘛,没试过,猜测拿文档会报错。


二、UIApplication 与 Application

在上面,我们已经知道,UIApplication 持有 Application 属性,因此我们可以从前者对象获取到后者的实例。而作为贡献了大部分方法、属性、事件的UIControlledApplication 与 ControlledApplication 显然也是类似的,只不过多提供了几个实例(上面的属性图)。

它们之间的关系,似乎仅此而已。真的仅此而已。

那么,意义呢?

UIControlledApplication 提供 ControlledApplication的入口,UIApplication 提供 Application 的入口,两个UI类本身对同一事物进行操作。

(UI)ControlledApplication 到 (UI)Application 基本就提供一个实例.

类似的还有UIDocument与Document。

虽然名称类似,功能类似,但又如上面 1.1 里说的俩UI类范围被限定到展示相关,而不带UI的显然就是对文档,对Revit项目的操作了。

逻辑清晰,结构分明,就是意义了。

2.1. 创建一个UIApplication?

UIApplication 存在一个接收 Application 的构造函数,那么,我们能够创建出一个UIApplication吗?

public Result Execute(ExternalCommandData commandData, ref string message, ElementSet elements)
{UIApplication uiApp = new UIApplication(commandData.Application.Application);TaskDialog.Show("UIAPP", $"{uiApp.LoadedApplications.Size}");return Result.Succeeded;
}

显然是可以的,但这又做的目的是啥呢。

P.S. 在Revit2016以及更早,还有一种错误的创建方式。

// 该构造函数于2017版本移除,此时会报错
Autodesk.Revit.ApplicationServices.Application app = new Autodesk.Revit.ApplicationServices.Application();
Autodesk.Revit.UI.UIApplication uiApp = new Autodesk.Revit.UI.UIApplication(app);
TaskDialog.Show("UIAPP", $"{uiApp.LoadedApplications.Size}");

三、Application 与 ControlledApplication

ApplicationControlledApplication 都是 Autodesk.Revit.ApplicationServices 命名空间下的类,该命名空间下就这2个类,还有2枚举,都是没啥用的,一个显示当前Revit的语言(LanguageType ),一个表示当前Revit产品分类(ProductType )。

同带UI的,这俩之间有相当一部分属性、方法、事件相同。

与UI不同的是,这里就涉及到项目、文档的修改了,大部分事件与此有关。

P.S. 类成员有点多,建议直接复制,丢给GPT,让它解释。

3.1. ControlledApplication

ControlledApplication 成员较少,除了事件较为全面要看看,方法/属性上值得注意的就2点:

  • 共享属性
  • 失败处理程序

讲到共享属性,就得讲可扩展存储了;讲失败处理程序,就得提那些个警告/错误 的触发与处理了。后面再说、

以我这摸鱼写的样子,什么时候是个头哇(⓿_⓿)

话说今天法环DLC发售了,传火传火,赐福赐福!!

事件

事件也简单,扫一眼就那么几类:Revit程序初始化时,文档的增删改、开关存,打印前后,文件/族/链接资源的导入导出,失败通知,还有其它几个杂鱼,无了,就这么简单。

还有上面需要注意的吗,我看看…没了,就这些。

3.2. Application

比起ControlledApp多了不少,定睛一看:

  • 方法上:多了创建族文档,创建文档,打开IFC文档,和其它看起来没啥用的
  • 属性上:Documents,Create,其它的太长不看
  • 事件上:视图导出(ed/ing),共享状态变更,有啥用?不知道,没啥用。

啪啪啪,鼓掌,学会了,下一个。

四、Autodesk.Revit.Creation.Application

看Application看得我脑壳疼了都,这又是个啥玩意儿?

哦,一个用于创建 其它对象实例 的这么个类,没有构造函数,从UIApplication.Application.Creat中拿到。里头全是Newxxx方法。

那么,都New了些上面东西呢,好像看不懂唉,不知道干啥用的。

这就对了,开发时,某些方法需要奇奇怪怪的参数,这些个参数又没有构造函数时,说不准就可以在这里New出来。

好了,我们发现Creation下也没几个类呐、

在这里插入图片描述


结尾

UI都还没写完,下篇写啥,Events总结要不要来一个,Creation就一点点也想先写了,UI上还有预览界面和可停靠界面,AdWindows.dll往后稍稍。

还是写UI吧,就一丢丢了

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

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

相关文章

碳钢酸洗线送酸槽蒸汽冷凝水PH计测量装置改进方法

碳钢酸洗线送酸槽蒸汽冷凝水PH计测量装置改进方法 一、项目提出前状况 1)立项背景 轧钢退火酸洗生产线的酸洗过程需要使用大量的硫酸、盐酸、硝酸、氢氟酸等酸液对钢带的表面进行清洗,酸洗过后产生较多的酸洗废水,酸洗废水需要经过处理达到污水排放标准后才能排放。其中酸…

C++ 统计二进制串中0出现的个数

描述 一个32位有符号整数,使用二进制来表示,现在要统计一下二进制串中0的个数。 示例1 输入: 11 返回值: 29 说明: 二进制00000000000000000000000000001011中有29位0 class Solution { public:/*** 代码中的…

【linux】内核源码TCP->IP->L2层函数调用继续摸索中

日志打印的时候,把行数也打印了: 登录 - Gitee.comhttps://gitee.com/r77683962/linux-6.9.0/commit/b847489a9910f68b9581fd8788807c697c82cdbd 上回基于应用层wget操作找到TCP调用的一些接口,并且已经到IP层的一些接口,当前基…

Reactor Mono应用

使用案例 创建Mono 使用静态工厂方法创建Mono import reactor.core.publisher.Mono;public class MonoExample {public static void main(String[] args) {// 创建一个包含值的MonoMono<String> monoWithValue Mono.just("Hello, Reactor!");// 创建一个空…

昇思25天学习打卡营第3天|数据集Dataset

一、简介&#xff1a; 数据是深度学习的基础&#xff0c;高质量的数据输入将在整个深度神经网络中起到积极作用。有一种说法是模型最终训练的结果&#xff0c;10%受到算法影响&#xff0c;剩下的90%都是由训练的数据质量决定。&#xff08;doge&#xff09; MindSpore提供基于…

odoo17 小变更3 Warning、 “attrs “和 “states “不再用

odoo17 小变更 1、Warning from odoo.exceptions import ValidationError,Warning ImportError: cannot import name Warning from odoo.exceptions (D:\od172406\odoo\exceptions.py) 2、自 17.0 版起&#xff0c;不再使用 "attrs "和 "states "属性。 …

Docker常用操作和命令

文章目录 1、卸载旧版本 2、yum安装Docker CE&#xff08;社区版&#xff09; 3、添加镜像加速器 4、docker --version 查看docker版本 5、docker info 或 docker system info 显示 Docker 系统的详细信息&#xff0c;包括容器、镜像、网络等 6、docker search 搜索镜像 …

仙讯畅通无阻:探索MQ阵法的强大功能

MQ起源 IBM MQ&#xff1a;IBM MQ是IBM推出的一系列消息导向中间件产品&#xff0c;最初在1993年12月发布。它最初被称为MQSeries&#xff0c;2002年更名为WebSphere MQ&#xff0c;以加入WebSphere产品系列。2014年4月&#xff0c;它被重新命名为IBM MQ。Apache ActiveMQ&…

永辉超市:胖东来爆改,成色几何?

单日业绩暴涨14倍。来&#xff0c;看看&#xff0c;这是被胖东来爆改后重新开业后的门店&#xff0c; 不出意外的流量爆炸。胖东来爆改&#xff0c;真是解决实体商超困境的灵丹妙药吗&#xff1f; 今天我们聊聊——永辉超市 最近两年实体商超日子都不好过&#xff0c;去年13家…

构建高效的电商返利系统:架构设计与实现

构建高效的电商返利系统&#xff1a;架构设计与实现 大家好&#xff0c;我是免费搭建查券返利机器人省钱赚佣金就用微赚淘客系统3.0的小编&#xff0c;也是冬天不穿秋裤&#xff0c;天冷也要风度的程序猿&#xff01; 电商返利系统作为连接消费者和商家的桥梁&#xff0c;能够…

On_Java 安装

Ubuntu环境下打开.chm文件 broadview_java 于 2023-02-20 12:48:37 发布 342 收藏 分类专栏&#xff1a; Android 开发工具 文章标签&#xff1a; ubuntu chm文件 版权 Android 开发工具 专栏收录该内容 19 篇文章 1 订阅 订阅专栏 前言 在ubuntu下,下载了一个JDK1.8 api中文文…

cron.timezone

系统 date 数据库 show timezone插件 show cron.timezonealter system set cron.timezonePRC;show cron.timezone

node 升级之后 npm run build 错误

错误信息 Error Error: error:0308010C:digital envelope routines::unsupportedat new Hash (node:internal/crypto/hash:67:19)at Object.createHash (node:crypto:130:10)该错误源于您对过时的 SSL 版本的依赖&#xff0c;因此您有两个好的选择和两个最好但值得怀疑的选择&…

【odoo】常用的基本视图类型

概要 在Odoo中&#xff0c;有几种基本视图类型&#xff0c;每种视图类型用于不同的目的和场景。这些视图类型包括表单视图&#xff08;form view&#xff09;、树视图&#xff08;tree view&#xff09;、看板视图&#xff08;kanban view&#xff09;、图表视图&#xff08;gr…

tessy 编译报错:单元测试时,普通桩函数内容相关异常场景

目录 1&#xff0c;失败现象 2&#xff0c;原因分析 1&#xff0c;失败现象 1&#xff0c;在 step 桩函数正常的情况下报错。 2&#xff0c;测试代码执行的数据流 和 step 桩函数内容不一致。 2&#xff0c;原因分析 桩函数分为 test object, test case, test step 三种类别。…

研究人员描述了如何判断ChatGPT是否在虚构

研究人员描述了如何判断ChatGPT是否在虚构 这是世界上最不为人知的秘密之一&#xff0c;大型语言模型对查询给出了明显错误的答案&#xff0c;并自信地这样做&#xff0c;与它们正确的时候没有区别。这有很多原因。人工智能可能已经接受了错误信息的训练;答案可能需要从LLM无法…

Flutter【组件】富文本组件

简介 flutter 富文本组件。 github地址&#xff1a; https://github.com/ThinkerJack/jac_uikit pub地址&#xff1a;https://pub.dev/packages/jac_uikit 使用方式 运行 flutter pub add jac_uikit组件文档 使用方式&#xff1a; HighlightedTextWidget.builder(text: &…

Linux解压缩命令

文章目录 前言1. tar - 打包和压缩文件2. gzip - 压缩文件3. gunzip - 解压缩gzip文件4. bzip2 - 压缩文件5. unzip - 解压缩zip文件6. zip - 压缩文件为zip格式7. 7z - 7-Zip压缩工具8. unrar - 解压缩RAR文件 前言 解压缩文件在Linux中是常见的任务&#xff0c;以下是一些常…

内积知识点小记

import numpy as np a np.array([1,2]) b np.array([3,4]) c a b # 11e np.array([[1,2],[3,4]]) f np.array([[5,6],[7,8]])g e f #array([[19, 22],[43, 50]])内积&#xff0c;也称为点积或数量积&#xff0c;是数学中接受在实数R上的两个向量并返回一个实数值标量的…

视频数据标注

视频采集 视频采集通常指的是将视频信号从视频源&#xff08;如摄像头、视频播放器等&#xff09;捕获并转换为数字格式&#xff0c;以便于计算机处理和存储。 视频采集步骤&#xff1a; 视频信号捕获&#xff1a;通过摄像头、网络摄像头、视频采集卡等设备将视频信号捕获。 …