HyperWorks 集成桌面环境下二次开发【二】----基础

HyperWorksAPI Programming for Beginners

使用API编程时，Handles 必须开启：

Ø  每个API都可以在对象层级中找到，API用于打开handles，handles被打开之前，不能够被使用，可以用一个比喻来解释这个问题，假如你想吃冰激凌，首先你要打开冰箱找到装有冰激凌的抽屉，打开抽屉，找到装有冰激凌的盒子，然后打开盒子，拿出冰激凌，才能够吃到冰箱中有不止一种冰激凌，每个人会根据自己的喜好来选择自己喜欢的口味，因此每个人就会决定去打开那个抽屉。为了获得特定的APIs，用户必须明确打开所需要的handle来获取响应的API。

Ø  一旦handle被打开，就可以自由使用，直到handle被释放。在冰激凌的例子中，就想关闭盖子，除非重新打开盖子，否则用户无法获取盒子中的冰激凌。同样的，Handles可以被在此打开，并且可以重复无限次，这对于handle的反复使用是重要的。

Ø  handle一般继承自上层（parenthandle），并通过某种方式相关联。所有的handle都从parents 对象获取。

下图显示了HyperWorks中数据库的层级结构：

例如：

使用hwlProject handle中AddPage API,必须首先打开project handle下面的session handle。

Ø  在打开每一个handle的时候需要指定handle的名字已方便后续使用。

hwi GetSessionHandle sess

*hwi 是最高层handle，连接所有API

*sess 是获取handle后指定的名字，名称可以随便取，但需要

    当一次打开很多handle时，需要明确那一个handle进行后续操作，例如，希望打开一个page的handle时，而此时存在许多page，就需要指定那个page的handle希望被获取。

           hwi GetSessionHandle sess

           sess GetProjectHandle proj

           proj GetPageHandle  p1  1

所有API具有如下格式：

Handle Method args

 

某些API没有参数项，某些有很多参数，某些handle被实例化后才能被打开，否则找不到对象的handle。例如，打开一条画图（plot）的handle，必须添加一条曲线后才能打开plot的handle。

hwi  GetSessionHandle sess

sessGetProjectHandle proj

projGetPageHandle    p1 1

p1   GetWindowHandle  w1 1

w1   GetClientHandle  plot

plotAddCurve

plotGetCurveHandle   c1 1

 

对于不清楚的API的使用情况，可以参考系统帮助信息，另外可以使用API中的函数ListMethod命令查看所有命令。