Revit API Revit.ini文件设置

当初是看Jeremy的Managing SDK Samples那篇博客时，才知道Revit用ini文件来储存许多配置信息的。他说Revit.ini文件与Revit.exe文件在同一文件夹下，但我打开那个文件是空白的，不知道是不是后来有更改。而且又在Loading SDK Samples那篇博客中指明，Revit可用ini文件来控制外部程序加载的。用Everything软件搜索可以找到起作用的Revit.ini文件。

读写ini文件

读写ini文件主要使用的是下面的两个方法：

[DllImport("kernel32")]
private static extern long WritePrivateProfileString(string section,string key,string val,string filepath);
[DllImport("kernel32")]
private static extern int GetPrivateProfileString(string section,string key,string def,StringBuilder retval,int size,string filePath);

如果有不了解的，可以看看参考资料3（C#操作INI文件）。

颜色[Colors]

下面几种颜色中除了CustomerColor使用的是16色，其它的使用时需要计算RGB值，可以按照参考资料4（常用的RGB值和颜色对照表）确认。其中RGB函数计算公式为：

颜色值 ＝ (65536 * Blue) + (256 * Green) + (Red)
- BackgroundColor——背景色。
- HiliteColor——选中构件时，构件的颜色。
- PreHiliteColor——鼠标悬停在构件上时，构件的颜色。
- ErrorColor——出现问题时，构件的颜色。

- CustomColorXX——使用这些颜色对自定义颜色进行预定义。 然后在软件中，就可以将颜色分配给线样式、材质、颜色方案和其他属性。

文件夹[Directories]

• ProjectPath——新建项目默认保存路径。
• ExternalParameters——共享参数文件保存路径。

用户界面[UserInterface]

• ActivateContextualTabOnSelection——选项卡切换行为。
• DisplayRecentFilesPage——是否显示最近打开文档页面。
• CategoryDisciplineFilter——控制显示类别列表的对话框中的过滤器列表，例如“可见性/图形”对话框。包括：
  
  1. 1 = 建筑
  2. 2 = 结构
  3. 4 = 机械
  4. 8 = 电气
  5. 16 = 管道
  6. 28 = 机械 + 电气 + 管道
  7. 31 = 显示全部

可选用的语言包[DirectoriesXXX]

• DefaultTemplate——默认样板。
• FamilyTemplatePath——默认族样板。

图形显示[Graphics]

• SemiTransparent——半透明设置。
• TempDimFontSizeInPoints——指定临时尺寸标注中的文字磅值。
• TempDimTextBackground——临时尺寸标注文字背景是否透明。
• ThinLinesEnabled——是否启用细线。
• UseGraphicsHardware——是否启用硬件加速。

最近使用文档[Recent File List]

指定 15 个最近使用的文件（包括项目、族和其他 Revit 文件）的路径和文件名。

选择设置[Selection]

• AllowFaceSelection——是否按面选择图元。
• AllowLinkSelection——是否选择链接。
• AllowPinnedSelection——是否选择锁定图元。
• AllowPressAndDrag——是否选择时拖拽图元。
• AllowUnderlaySelection——是否选择基线图元。

创建图元时是否默认创建标记[TagOnPlacement]

例如创建房间时可以同时创建房间名称标记。

视图选项[ViewOptions]

DefaultViewDiscipline——默认视图规程设置。

以上只是列举了一部分文件中的设置，详细文档可查阅参考资料5（Revit.ini文件在线帮助文档）。

参考资料：

1.Managing SDK Samples

2.Loading SDK Samples

3.C#操作INI文件

4.常用的RGB值和颜色对照表

5.Revit.ini文件在线帮助文档