<连载>Protel二次开发从入门到精通

--正文篇——第十一章第5节

发表时间：2007-11-23 特约撰稿人：张浩白二平来源：e-works

用Protel的原理图API，您开发的服务器可以访问原理图编辑器服务器，例如，可以使用原理图API开发原理图BOM和原理图Spread服务器。此章节是一个原理图编辑器API所提供功能的简明摘要，另外有一些原理图API函数和类的例子。作者邮箱：bullzhanghao@yahoo.com.cn 如有疑问，可直接与作者联系！

4.6 查询对象函数

4.6.1 SchAPI_QueryArc函数

声明(来自SchProcs单元)：

Function SchAPI_QueryArc(Mode : TQueryMode;...) : Integer;

描述：

SchAPI_QueryArc函数使用下列给定的参数来检索或设置一个弧对象的选项，如果调用成功，一个kSchAPI_NoError值被返回，否则一个kSchAPI_Error值被返回。

参数	类型	描述
Mode	TQueryMode	表示从原理图数据库中取得数据或向原理图数据库设置数据的查询模式。
ObjectHandle	TObjecthandle	表示弧对象的句柄。
Var LocationX	Integer	表示X坐标位置。
Var LocationY	Integer	表示Y坐标位置。
Var Radius	Integer	表示半径尺寸。
Var LineWidth	TSize	表示线宽度。
Var StartAngle	Real	表示弧的起始点。
Var EndAngle	Real	表示弧的结束点。
Var Color	LongInt	表示弧对象的颜色。
Var Selection	Boolean	表示弧对象是否被选择。

参见其它：

TObjectHandle类型

4.6.2 SchAPI_QueryBezier函数

声明(来自SchProcs单元)：

Function SchAPI_QueryBezier(Mode : TQueryMode;...): Integer;

描述：

SchAPI_QueryBezier函数使用下列给定的参数来检索或设置一个贝塞尔曲线对象的选项，如果调用成功，一个kSchAPI_NoError值被返回，否则一个kSchAPI_Error值被返回。

参数	类型	描述
Mode	TQueryMode	表示从原理图数据库中取得数据或向原理图数据库设置数据的查询模式。
ObjectHandle	TObjecthandle	表示贝塞尔曲线对象的句柄。
Var LineWidth	TSize	表示贝塞尔曲线对象的线宽。
Var Color	LongInt	表示贝塞尔曲线对象的颜色。
Var Selection	Boolean	表示贝塞尔曲线对象是否被选择。

参见其它：

TObjectHandle类型

4.6.3 SchAPI_QueryBus函数

声明(来自SchProcs单元)：

Function SchAPI_QueryBus(Mode : TQueryMode;...) : Integer;

描述：

SchAPI_QueryBus函数使用下列给定的参数来检索或设置一个总线(Bus)对象的选项，如果调用成功，一个kSchAPI_NoError值被返回，否则一个kSchAPI_Error值被返回。

参数	类型	描述
Mode	TQueryMode	表示从原理图数据库中取得数据或向原理图数据库设置数据的查询模式。
ObjectHandle	TObjecthandle	表示总线对象的句柄。
Var LineWidth	TSize	表示总线对象的线宽。
Var Color	LongInt	表示总线对象的颜色。
Var Selection	Boolean	表示总线对象是否被选择。

参见其它：

TObjectHandle类型

4.6.4 SchAPI_QueryBusEntry函数

声明(来自SchProcs单元)：

Function SchAPI_QueryBusEntry(Mode : TQueryMode;...) : Integer;

描述：

SchAPI_QueryBusEntry函数使用下列给定的参数来检索或设置一个总线入口对象的选项，如果调用成功，一个kSchAPI_NoError值被返回，否则一个kSchAPI_Error值被返回。

参数	类型	描述
Mode	TQueryMode	表示从原理图数据库中取得数据或向原理图数据库设置数据的查询模式。
ObjectHandle	TObjecthandle	表示总线入口对象的句柄。
Var LocationX	Integer	表示初始左下X坐标。
Var LocationY	Integer	表示初始左下Y坐标。
Var CornerX	Integer	表示最后右上X坐标。
Var CornerY	Integer	表示最后右上Y坐标。
Var LineWidth	TSize	表示总线入口对象的线宽。
Var Color	LongInt	表示总线入口对象的颜色。
Var Selection	Boolean	表示总线入口对象的是否被选择。

参见其它：

TObjectHandle类型

4.6.5 SchAPI_QueryEllipse函数

声明(来自SchProcs单元)：

Function SchAPI_QueryEllipse(Mode : TQueryMode;...) : Integer;

描述：

SchAPI_QueryEllipse函数使用下列给定的参数来检索或设置一个椭圆对象的选项，如果调用成功，一个kSchAPI_NoError值被返回，否则一个kSchAPI_Error值被返回。

参数	类型	描述
Mode	TQueryMode	表示从原理图数据库中取得数据或向原理图数据库设置数据的查询模式。
ObjectHandle	TObjecthandle	表示椭圆对象的句柄。
Var LocationX	Integer	表示椭圆对象的X坐标。
Var LocationY	Integer	表示椭圆对象的Y坐标。
Var LineWidth	TSize	表示椭圆对象的线宽。
Var Radius	Integer	表示椭圆对象的第一个半径。
Var SecondaryRadius	Integer	表示椭圆对象的第二个半径。
Var Color	LongInt	表示椭圆对象的轮廓颜色。
Var AreaColor	LongInt	表示椭圆对象的背景颜色。
Var IsSolid	Boolean	表示椭圆对象是否被背景颜色添充。
Var Selection	Boolean	表示椭圆对象的是否被选择。

参见其它：

TObjectHandle类型

4.6.6 SchAPI_QueryEllipticalArc函数

声明(来自SchProcs单元)：

Function SchAPI_QueryEllipticalArc(Mode : TQueryMode;...) : Integer;

描述：

SchAPI_QueryEllipticalArc函数使用下列给定的参数来检索或设置一个椭圆弧对象的选项，如果调用成功，一个kSchAPI_NoError值被返回，否则一个kSchAPI_Error值被返回。

参数	类型	描述
Mode	TQueryMode	表示从原理图数据库中取得数据或向原理图数据库设置数据的查询模式。
ObjectHandle	TObjecthandle	表示椭圆弧对象的句柄。
Var LocationX	Integer	表示椭圆弧对象的X坐标。
Var LocationY	Integer	表示椭圆弧对象的Y坐标。
Var Radius	Integer	表示椭圆弧对象的第一个半径。
Var SecondaryRadius	Integer	表示椭圆弧对象的第二个半径。
Var LineWidth	TSize	表示椭圆弧对象的线宽度。
Var StartAngle	Real	表示初始角。
Var EndAngle	Real	表示最末角。
Var Color	Longint	表示椭圆弧对象的颜色。
Var Selection	Boolean	表示椭圆弧对象的是否被选择。

参见其它：

TObjectHandle类型

4.6.7 SchAPI_QueryErrorMarker函数

声明(来自SchProcs单元)：

Function SchAPI_QueryErrorMarker(Mode : TQueryMode;...) : Integer;

描述：

SchAPI_QueryErrorMarker函数使用下列给定的参数来检索或设置一个错误标记(Error Marker)对象的选项，如果调用成功，一个kSchAPI_NoError值被返回，否则一个kSchAPI_Error值被返回。

参数	类型	描述
Mode	TQueryMode	表示从原理图数据库中取得数据或向原理图数据库设置数据的查询模式。
ObjectHandle	TObjecthandle	表示错误标记对象的句柄。
var LocationX	Integer	表示X坐标。
var LocationY	Integer	表示Y坐标。
var Color	LongInt	表示错误标记对象的颜色。
var Selection	Boolean	表示错误标记对象的是否被选择。
var Error	PChar	表示错误标记对象的文本描述，是一个以Null为终止符的最大长度为256个字符的字符串。

参见其它：

TObjectHandle类型

4.6.8 SchAPI_QueryImage函数

声明(来自SchProcs单元)：

Function SchAPI_QueryImage(Mode : TQueryMode;...) : Integer;

描述：

SchAPI_QueryImage函数使用下列给定的参数来检索或设置一个图像对象的选项，如果调用成功，一个kSchAPI_NoError值被返回，否则一个kSchAPI_Error值被返回。

参数	类型	描述
Mode	TQueryMode	表示从原理图数据库中取得数据或向原理图数据库设置数据的查询模式。
ObjectHandle	TObjecthandle	表示图像对象的句柄。
var LocationX	Integer	表示左下X坐标。
var LocationY	Integer	表示左下Y坐标。
Var CornerX	Integer	表示右上X坐标。
Var CornerY	Integer	表示右上Y坐标。
Var LineWidth	TSize	表示图像对象的边框宽度。
Var Color	Longint	表示边框颜色。
Var Selection	Boolean	表示图像对象的是否被选择。
Var IsSolid	Boolean	表示边框是否可见。
Var KeepAspect	Boolean	表示图像高宽比是否将被维持。
Var FileName	PChar	表示到一个图像的连接。文件名称是一个以null为终止符的最长长度为256个字符的字符串。

参见其它：

TObjectHandle类型

4.6.9 SchAPI_QueryJunction函数

声明(来自SchProcs单元)：

Function SchAPI_QueryJunction(Mode : TQueryMode;...) : Integer;

描述：

SchAPI_QueryJunction函数使用下列给定的参数来检索或设置一个接点(junction)对象的选项，如果调用成功，一个kSchAPI_NoError值被返回，否则一个kSchAPI_Error值被返回。

参数	类型	描述
Mode	TQueryMode	表示从原理图数据库中取得数据或向原理图数据库设置数据的查询模式。
ObjectHandle	TObjecthandle	表示接点对象的句柄。
Var LocationX	Integer	表示左下X坐标。
Var LocationY	Integer	表示左下Y坐标。
Var Size	TSize	表示接点对象的大小。
Var Locked	Boolean	表示接点对象是否可移动。
Var Color	LongInt	表示接点对象的颜色。
Var Selection	Boolean	表示接点对象的是否被选择。

参见其它：

TObjectHandle类型

4.6.10 SchAPI_QueryLabel函数

声明(来自SchProcs单元)：

Function SchAPI_QueryLabel(Mode : TQueryMode;...) : Integer;

描述：

SchAPI_QueryLabel函数使用下列给定的参数来检索或设置一个注解(Annotation)对象的选项，如果调用成功，一个kSchAPI_NoError值被返回，否则一个kSchAPI_Error值被返回。

参数	类型	描述
Mode	TQueryMode	表示从原理图数据库中取得数据或向原理图数据库设置数据的查询模式。
ObjectHandle	TObjecthandle	表示注解对象的句柄。
Var LocationX	Integer	表示左下X坐标。
Var LocationY	Integer	表示左下Y坐标。
Var Orientation	TRotation	表示注解对象的方向。
Var Color	LongInt	表示注解对象的颜色。
Var FontID	Integer	表示注解对象的字体类型。完全支持Windows True Type字体。
Var Selection	Boolean	表示注解对象的是否被选择。
Var Text	PChar	表示注解对象的文本内容，是一个以null为终止符的最长长度为256个字符的字符串。

参见其它：

TObjectHandle类型

TSchAnnotation类

本文为e-works原创投稿文章，未经e-works书面许可，任何人不得复制、转载、摘编等任何方式进行使用。如已是e-works授权合作伙伴，应在授权范围内使用。e-works内容合作伙伴申请热线：editor@e-works.net.cn tel：027-87592219/20/21。

责任编辑：王阳

共3页

1 2 3 下一页

上一篇文章：<连载>Protel二次开发从入门到精通
下一篇文章：EDA工具最好理念：端到端流程优化

信息化应用调查在线投稿加入收藏发表评论好文推荐打印文本

近期热点