如图，在Solidworks工程图中会用到很多表，包括普通的表，明细表等。本文我们先学习普通的表对象TableAnnotation以及表特征GeneralTableFeature的相关使用。
GeneralTableFeature是表的特征体现，TableAnnotation则是表特征的一个具体的表。本文将通过表的插入，获取等操作，学习表类对象的一些常规使用方法。
示例1 表格的插入
表格的插入主要使用了工程图文档对象的DrawingDoc::InsertTableAnnotation2方法。本例中将插入一个使用模板的表格和一个自定义的表格
实例代码
public static void InsertTable(ModelDoc2 SwDoc,string TempPath)
{
double x = 600 / 1000.0;
double y1 = 200 / 1000.0;
double y2 = 100 / 1000.0;
Sheet SwSheet = ((DrawingDoc)SwDoc).GetCurrentSheet();
double[] sheetprop = SwSheet.GetProperties2();
double scale = sheetprop[2] / sheetprop[3];
//使用表模板
SwDoc.SketchManager.CreateLine(0,0,0,x*1.0/ scale, y1 * 1.0 / scale, 0);
TableAnnotation SwTable1=((DrawingDoc)SwDoc).InsertTableAnnotation2(false, x, y1, (int)swBOMConfigurationAnchorType_e.swBOMConfigurationAnchor_TopRight, TempPath, 4, 6);
SwTable1.Title = "模板表格标题";
SwTable1.GeneralTableFeature.GetFeature().Name = "示例模板表格";
//自定义表
SwDoc.SketchManager.CreateLine(0, 0, 0, x * 1.0 / scale, y2 * 1.0 / scale, 0);
TableAnnotation SwTable2 = ((DrawingDoc)SwDoc).InsertTableAnnotation2(false, x, y2, (int)swBOMConfigurationAnchorType_e.swBOMConfigurationAnchor_TopLeft,"", 4, 6);
SwTable2.Title = "自定义表格标题";
SwTable2.GeneralTableFeature.GetFeature().Name = "示例自定义表格";
SwTable2.Text2[2, 3,true] = "测试文本";
}
实例效果
实例解析
DrawingDoc::InsertTableAnnotation2参数解读
从实例的效果图与分析可以看到，决定表格的位置，不仅和参数有关，也与表格的锚点设置类型有关。
通过TableAnnotation实例的属性和方法，我们可以对单元格进行赋值，插入行列等常规表格自动化操作。
实例2 获取表格
本例将通过TableAnnotation，GeneralTableFeature的方法属性，来获取上例中插入的表格及获取相关消息。
代码实例
public static void GetTable(ModelDoc2 SwDoc,string TableName)
{
Feature SwTableFeat = ((DrawingDoc)SwDoc).FeatureByName(TableName);
if (SwTableFeat != null)
{
StringBuilder Sb = new StringBuilder("");
GeneralTableFeature gtf = SwTableFeat.GetSpecificFeature2();
TableAnnotation SwTabe = gtf.GetTableAnnotations()[0];
Sb.Append("表标题:"+SwTabe.Title+"\r\n");
Sb.Append("内容:" + SwTabe.Text2[2, 3,true]);
System.Windows.MessageBox.Show(Sb.ToString().Trim());
}
}
实例效果
实例分析
当我们需要获得表格中的信息时，可以通过特征获取方式先获得表特征对象GeneralTableFeature实例，然后通过该特征获得所需要操作的表对象TableAnnotation实例。这里不妨读者先思考下GeneralTableFeature与TableAnnotation的关系。
实例3 表的拆分与合并
在实例2中，我们看到我们需要先获得GeneralTableFeature对象，再间接获得TableAnnotation对象。为什么TableAnnotation不能代表一个特征呢？我们先来看下本实例，本实例对表进行了行拆分和行合并。
实例代码
public static void SetTable(ModelDoc2 SwDoc, string TableName)
{
Feature SwTableFeat = ((DrawingDoc)SwDoc).FeatureByName(TableName);
if (SwTableFeat != null)
{
StringBuilder Sb = new StringBuilder("");
GeneralTableFeature gtf = SwTableFeat.GetSpecificFeature2();
TableAnnotation SwTabe = gtf.GetTableAnnotations()[0];
#region 表格拆分
System.Windows.MessageBox.Show("分割前表数量:"+ gtf.GetTableAnnotationCount().ToString());
SwTabe.Split((int)swTableSplitLocations_e.swTableSplit_AfterRow, 1);
System.Windows.MessageBox.Show("分割后表数量:" + gtf.GetTableAnnotationCount().ToString());
SwTabe.Merge((int)swTableMergeLocations_e.swTableMerge_All);
System.Windows.MessageBox.Show("合并后表数量:" + gtf.GetTableAnnotationCount().ToString());
#endregion
}
}
实例效果
实例分析
从表格拆分后，我们可以很明显地看到，一个表格的特征GeneralTableFeature对应了多个表格TableAnnotation实例。从这里我们可以进一步理解GeneralTableFeature与TableAnnotation的区别。
如下图为本文的示例程序，源码可上我的Github下载。操作步骤可见文章《公众号源码Github分享库》 ， 实例序号23
