### SOLIDWORKS 2019 中使用 C# 和 WinForms 创建带注释的表格对话框 在 SOLIDWORKS 的开发环境中，通过集成 Windows Forms (WinForms)，可以实现自定义用户界面的功能。以下是基于 SOLIDWORKS API 使用 C# 编写的一个示例代码，展示如何创建一个带有表格功能的对话框。 #### 示例代码说明 此代码展示了如何利用 `DataGridView` 控件来构建一个简单的表格对话框，并将其嵌入到 SOLIDWORKS 应用程序中。该示例还包括详细的注释以便于理解其工作原理。 ```csharp using System; using System.Windows.Forms; using SolidWorks.Interop.sldworks; namespace SWTableDialogExample { public partial class TableForm : Form { private SldWorks swApp; // 定义 SOLIDWORKS 应用实例变量 /// <summary> /// 构造函数初始化表单并设置 SOLIDWORKS 实例。 /// </summary> /// <param name="app">当前运行中的 SOLIDWORKS 对象</param> public TableForm(SldWorks app) { InitializeComponent(); this.swApp = app; InitializeDataGridView(); // 初始化 DataGridView 表格控件 } /// <summary> /// 初始化 DataGridView 并填充数据。 /// </summary> private void InitializeDataGridView() { dataGridView1.Rows.Clear(); // 清除现有行 dataGridView1.Columns.Clear(); // 清除现有列 // 添加列头 dataGridView1.Columns.Add("PartName", "零件名称"); dataGridView1.Columns.Add("Mass", "质量(g)"); dataGridView1.Columns.Add("Volume", "体积(cm³)"); // 获取装配体组件列表及其属性 object[] components = GetAssemblyComponents(swApp); foreach (var component in components) { string partName = component.ToString().Split('.')[0]; // 提取零件名 double mass = GetProperty(component, "MASS"); // 质量属性 double volume = GetProperty(component, "VOLUME"); // 体积属性 // 向表格添加新行 dataGridView1.Rows.Add(partName, Math.Round(mass * 1000, 2), Math.Round(volume, 2)); } } /// <summary> /// 获取装配体内的所有组件对象数组。 /// </summary> /// <param name="swApp">SOLIDWORKS 应用实例。</param> /// <returns>返回包含组件的对象数组。</returns> private static object[] GetAssemblyComponents(SldWorks swApp) { ModelDoc2 assemblyDoc = swApp.ActiveDoc as ModelDoc2; // 当前活动文档 if (assemblyDoc != null && assemblyDoc.GetType() == (int)swDocumentTypes_e.swDocASSEMBLY) { AssemblyDoc asmDoc = assemblyDoc as AssemblyDoc; object[] compArray = asmDoc.GetComponents(false); // 获取组件集合 return compArray; } return new object[0]; } /// <summary> /// 获取指定模型的特定属性值。 /// </summary> /// <param name="model">目标模型对象。</param> /// <param name="propertyName">要查询的属性名称。</param> /// <returns>返回对应的数值型属性值。</returns> private static double GetProperty(object model, string propertyName) { IComponent2 component = model as IComponent2; if (component != null) { CustomInfo customInfo = component.CustomInformation; if (customInfo.ContainsKey(propertyName)) return Convert.ToDouble(customInfo[propertyName]); } return 0.0; } } } ``` 上述代码实现了以下功能： - **加载当前装配体的所有组件**：通过调用 `GetComponents()` 方法获取装配体内所有的子部件[^1]。 - **提取物理特性**：读取每个组件的质量和体积等信息。 - **显示为表格形式**：使用 `DataGridView` 将这些信息以结构化的方式呈现给用户[^2]。 #### 关键点解释 1. **Active Document Check**: 确保当前激活的是装配文件 `(int)swDocumentTypes_e.swDocASSEMBLY`[^1]。 2. **Custom Information Access**: 利用了 `IComponent2.CustomInformation` 接口访问定制化的元数据。 3. **Data Binding with DataGridView**: 数据绑定至网格视图用于更直观的数据查看[^2]。 ---