CATIA二次开发入门教程---创建工作台案例--

admin

CATIA二次开发入门教程---7 创建工作台案例

本使用案例将学到什么

此用例旨在显示如何创建要添加到给定workshop的工作台。与workshop一样，工作台是一个对象，用于收集用于处理文档的命令，并将其安排在工具栏和菜单中。命令头用于建立工作台和命令之间的链接. 本案例创建一个CAAAfrGeoCreationWbench

CAAAfrGeoCreationWbench做什么

该CAAAfrGeoCreationWbench用例创建一个名为工作台CAA几何创建为CAAGeometry文档。其规格涵盖了您将遇到的大多数情况。提供了两个工具栏：

1 实体工具栏。它包括五个新命令：Cuboid，Sphere，Torus和缸1和2。

2 曲面工具栏。它包括三个新命令：Revolution Surface，Nurbs Surface和Offset Surface

菜单栏中的唯一变化是在插入菜单中使用两个子菜单在现有菜单下面添加这些命令。

. {% P: V- L+ a- W

键入CNEXT。应用程序就绪后，请执行以下操作：

• 选择开始 - >基础设施 - > CAA V5：几何创建
  

这将创建一个新的CAAGeometry文档，其中CAA V5：几何创建工作台处于活动状态

. w7 J4 v; K# x. w5 f3 f% k

用到的类和接口是

类和接口是：

CAAAfrGeoCreationWkb	工作台描述类
CAAAfrGeoCreationWkbFactory	工作台类的工厂类
CAAIAfrGeoCreationWkbFactory	工厂接口由实施CAAAfrGeoCreationWkbFactory
TIE_CAAIAfrGeoCreationWkbFactory	TIE类为工厂接口
CAAIAfrGeoCreationWkbAddin	由工作台公开的加载项接口及其所有加载项都必须实现
TIE_CAAIAfrGeoCreationWkbAddin	TIE类用于加载项接口

5 _) D" Q  b% D5 {4 H

admin

要创建CAA几何创建工作台，有七个步骤：
1        创建工作台工厂界面        LocalInterfaces和src
2        创建工作台工厂        LocalInterfaces和src
. h! x7 c9 g, m# q3        创建工作台描述类        LocalInterfaces和src
4        创建命令头           CreateCommands 方法
3 T, K6 J/ o7 ?$ ^( [% @8 N  y5        创建工作台并排列命令        CreateWorkbench 方法
6        提供资源并将工作台插入“开始”菜单        资源文件
7        创建工作台暴露接口        ProtectedInterfaces和src
8 O" p7 z' n9 ?9 Q# E

admin

创建工作台工厂接口
* L4 {/ e# ^, \. m% C% [

该工厂接口被命名为CAAIAfrGeoCreationWkbFactory。要创建此接口，请创建：
头文件
+ B* B. s( m' l! s7 _- H源文件
' `; F4 i2 f$ I  _& UTIE tsrc文件。
* \0 j7 e# E$ S2 X如下所示。
CAAIAfrGeoCreationWkbFactory.h

#include <CATIGenericFactory.h> 8 d% f+ y9 a5 a0 D( r/ l% B+ D extern IID IID_CAAIAfrGeoCreationWkbFactory; class CAAIAfrGeoCreationWkbFactory : public CATIGenericFactory{  CATDeclareInterface;  public :};

一个工厂接口是CAA接口，即，从派生抽象类CATIGenericFactory。正如任何接口，它有一个IID声明IID_其次是接口的名称，包括 CATDeclareInterface声明，这个抽象类是接口宏。比那些没有额外的方法CATIGenericFactory是必要的。不要忘记TIE编译器所需的public关键字。


7 Z+ _* k, s2 V5 C9 j6 c$ ]. ]3 X其源文件CAAIAfrGeoCreationWkbFactory.cpp如下
' f, E; N5 ^3 |# Z" @5 E2 J6 H#include <CAAIAfrGeoCreationWkbFactory.h>IID IID_CAAIAfrGeoCreationWkbFactory = {    0xb32eed10，    0xd4c1，    0x11d3，    {0xb7，0xf5，0x00，0x08，0xc7，0x4f，0xe8，0xdd}  };
# }9 [' q* k7 N" f3 S* g- E' L7 K5 zCATImplementInterface（CAAIAfrGeoCreationWkbFactory，CATIGenericFactory）;

, \, i  U/ z! K0 j1 }
1 g) B# o: n( m( s1 \7 }在src目录中创建名为TIE_CAAIAfrGeoCreationWkbFactory.tsrc的文件，并包含：
7 w6 d9 X$ E+ q) P#include "CAAIAfrGeoCreationWkbFactory.h"
% h' s; k4 [8 p

0 ~: @/ J1 O- _: D/ Y. D3 w多工作空间应用程序生成器（mkmk）将为您生成此接口的TIE，即ProtectedGenerated目录中的TIE_CAAIAfrGeoCreationWkbFactory.h文件。
' ]4 C. X3 P  Z( T$ e5 [
' ]  l" ~; J( U; G. K  {

; e( q: G0 U7 C# k6 ]

  i* I$ v" w" X. d/ S

! X) b6 N: E: r& Y" h6 e$ ~- P0 h
; D2 [  w' [/ x


; o; s$ r1 U* C: v1 }1 w


  l1 L* }9 S) }: J3 Q0 P# S: h# \


' Z! Q% e+ f) B' M+ ^1 }
1 V2 Y7 i. u8 ^9 B; a& U( P# c
6 M# R* B, I9 G* J9 J: _

) S# t2 \! T! r( a/ ^
. F, M3 q; f; D4 z5 k: v


4 Q+ \2 q  \$ x4 }9 c


" B( U) p/ U* a" N! ~* e1 Q
0 T3 l$ N5 _8 w; f& o4 l) x

admin

创建工作台工厂

创建工作台实例的工厂类必须连接的名称之类的实例，也就是工作台描述类 CAAAfrGeoCreationWkb，以字符串工厂。这给CAAAfrGeoCreationWkbFactory。
要创建此类，请创建：
0 \4 a7 V: ^) Z" y头文件使用CATDeclareConfigurationFactory 宏
源文件，使用CATImplementConfigurationFactory 宏
2 d" l/ s! B5 U7 l9 M# y更新接口字典和工厂字典。
创建CAAAfrGeoCreationWkbFactory.h头文件。
. u7 d8 _: n/ c- x( C3 x& u#include“CATWorkshopConfigurationFactory.h”

CATDeclareConfigurationFactory（CAAAfrGeoCreationWkb）;
% U2 Z/ C4 G5 M6 }3 H' \该CATDeclareConfigurationFactory宏参数是工作台描述类的名称。
创建CAAAfrGeoCreationWkbFactory.cpp文件。
/ R  u: G) h) i% W, H/ T#include <CAAAfrGeoCreationWkb.h>
#include <CAAAfrGeoCreationWkbFactory.h>
$ T- a) m2 A- E9 \& v; N% i1 J#include <TIE_CAAIAfrGeoCreationWkbFactory.h>
CATImplementConfigurationFactory（CAAAfrGeoCreationWkb，
: [" _  C. \* C2 B                                 CAAIAfrGeoCreationWkbFactory）;
2 F( X/ ~2 N  h& \' t该CATImplementConfigurationFactory参数是工作台描述类的名称和工作台工厂接口分别的名称。在CATDeclareConfigurationFactory与 CATImplementConfigurationFactory作为数据扩展宏创建工作台工厂实现类 CATApplicationFrame组件
: p! E- {& g0 W' V您现在应该更新这两个字典文件：
$ A/ J& U6 I4 L5 j+ u
: D0 g9 |4 A* Y7 }该接口的字典，那就是他的名字是迪科，如CAAApplicationFrame.dico后缀框架名称的文件，并且你应该创建或框架CNEXT /代码/字典目录更新。接口字典包含以下声明，以说明该CATApplicationFrame组件实现 CAAIAfrGeoCreationWkbFactory接口，由宏，其代码位于libCAAAfrGeoCreationWbench共享库或DLL创建的扩展类的方法：
2 D) ~; h; v& }CATApplicationFrame CAAIAfrGeoCreationWkbFactory libCAAAfrGeoCreationWbench
  R* j# O* h6 R/ \3 Z7 h! s5 Q) e该工厂的字典，那就是他的名字是事实，如CAAApplicationFrame.fact后缀框架名称的文件，并且你应该创建或框架CNEXT /代码/字典目录更新。工厂字典包含以下声明，以说明该CAAIAfrGeoCreationWkbFactory界面是一个工厂的实现将创建一个接口 CAAAfrGeoCreationWkb类的实例：
4 [- p. m2 S* n1 c) w% k- J/ O8 DCAAAfrGeoCreationWkb CAAIAfrGeoCreationWkbFactory
在运行时，包含这些字典文件的目录的路径名将连接到CATDictionaryPath环境变量中的其他字典路径名。
; y# r0 U' ^8 W, y9 B9 S

, A$ R1 I- z/ h: i3 b- r, l创建工作台描述类

- K5 v& Q1 @- P/ c( H% W1 M, I该CAAAfrGeoCreationWkb类实现 CATICAAAfrGeometryWksConfiguration由CAAGeometry车间暴露接口。它包括以下方法：
CreateCommands 以实例化工作台的命令的命令头
4 f; H" c- s% a$ ACreateWorkbench 创建工作台，菜单和工具栏的容器，并在菜单和工具栏中排列命令
GetCustomInterfaces，返回由工作台公开的接口的名称以启用其自定义
' Y7 I& r1 c1 FGetAddinInterface 它返回由工作台公开以创建加载项的接口的名称。
你应该：
& Y' d& l+ T8 e6 t# m3 e4 J$ G为创建头文件和源文件CAAAfrGeoCreationWkb 类
更新字典。
创建CAAAfrGeoCreationWkb.h文件
- z8 c, j! s+ h; j: C) B* x* y# V#include“CATBaseUnknown.h”
#include“CATListPV.h”

class CATCmdWorkbench;

( V) K1 Q4 V5 D, O  Bclass CAAAfrGeoCreationWkb：public CATBaseUnknown
  h2 }) E1 `' i2 m+ c  D& F; l{
/ Y7 H8 |) \( x9 ^% j* C  CATDeclareClass;
  public：
     CAAAfrGeoCreationWkb（）;
     virtual〜CAAAfrGeoCreationWkb（）;
  p" l8 x0 }0 g/ V, k! `/ }$ M
- C& I7 r! t* p( ?, p6 b- w     void CreateCommands（）;
: W: |3 u: c0 m. X$ |! h0 Z     CATCmdWorkbench * CreateWorkbench（）;
     CATClassId GetAddinInterface（）;
1 P, S  [4 D4 l' h9 n4 a! f     void GetCustomInterfaces（CATListPV * oDefaultIIDList，
6 q  A4 {2 A/ v" X5 v  c1 S                                           CATListPV * oCustomIIDList）;
3 L3 }3 e1 P1 {; m  y5 C+ {+ q# ^0 ?  private:
! D  o- G! g5 a5 _# [     CAAAfrGeoCreationWkb（const CAAAfrGeoCreationWkb＆iObjectToCopy）;
};
该CAAAfrGeoCreationWkb类C ++ -派生自CATBaseUnknown。的CATDeclareClass宏声明类 CAAAfrGeoCreationWkb属于组件。这个类有一个构造函数，析构函数中，的四种方法CATIWorkbench接口和一个拷贝构造函数。请注意，复制构造函数设置为private。这防止编译器在不知道的情况下将复制构造函数创建为public。此复制构造函数未在源文件中实现。
$ Z( P) k5 A4 G* T/ r4 d8 T9 t创建CAAAfrGeoCreationWkb.cpp文件。文件框架如下所示。每个方法的实现在单独的章节中描述。
# S/ R6 e! N( S. N% J4 X#include <CAAAfrGeoCreationWkb.h>

, `2 x2 d- ?& {的#include <CATCommandHeader.h> //参见创建命令头
MacDeclareHeader（CAAAfrGeoCreationWkbHeader）;

#include <CATCreateWorkshop.h>

5 z5 e, A- k' Y1 r* }$ eCATImplementClass（CAAAfrGeoCreationWkb，Implementation，CATBaseUnknown，CATNull）;
#include <TIE_CATICAAAfrGeometryWksConfiguration.h>
; o0 x! R) j$ w  OTIE_CATICAAAfrGeometryWksConfiguration（CAAAfrGeoCreationWkb）;
# w) C0 u& G2 a+ ]
& b+ H( U' C. @' j5 ICAAAfrGeoCreationWkb :: CAAAfrGeoCreationWkb（）{}
CAAAfrGeoCreationWkb ::〜CAAAfrGeoCreationWkb（）{}

3 E& I; h- O5 N2 a* q% B0 U! avoid CAAAfrGeoCreationWkb :: CreateCommands（）
{
& z$ J2 Y; c6 C1 x+ W0 D  L  ... //见创建命令头
. D) O6 k6 Q* p$ E  A}}

CATCmdWorkbench * CAAAfrGeoCreationWkb :: CreateWorkbench（）
{
  ... //见创建Workbench和安排的命令
}}

0 d8 M6 Y- S: gCATClassId CAAAfrGeoCreationWkb :: GetAddinInterface（）
7 u% d, W9 A( k& S, O/ a( \; f{
4 m' k6 j/ J# Z) o  return“CAAIAfrGeoCreationWkbAddin”;
3 p+ x, b2 Z* ?& x! A7 R( c}}

void CAAAfrGeoCreationWkb :: GetCustomInterfaces（CATListPV * oDefaultIIDList，
                                               CATListPV * oCustomIIDList）
{}
该CAAAfrGeoCreationWkb类规定，它实现了 CATICAAAfrGeometryWksConfiguration接口多亏了 TIE_CATICAAAfrGeometryWksConfiguration宏。该 CATImplementClass宏声明，该CAAAfrGeoCreationWkb 类是部分主类[ 2 ]，由于 Implementation关键字，并从CATBaseUnknown它OM-提炼出来[ 2 ]。第四个参数必须始终设置CATNull为组件主要类别。
该GetCustomInterfaces方法必须是空的。由工作台暴露，使客户能够创建加载项的接口的名称是由返回的GetAddinInterface方法。请参阅 创建工作台暴露接口来创建此接口。
5 ^8 \0 |1 U/ O更新词典
3 p3 Y- q( k3 y. S更新界面的字典，这是一个命名的文件，例如，CAAApplicationFrame.dico，其目录的路径名在运行时在CATDictionaryPath环境变量连接，并且包含以下声明，以说明该CAAAfrGeoCreationWkb类实现CATICAAAfrGeometryWksConfiguration接口，并且其代码位于libCAAAfrGeoCreationWbench共享库或DLL中。更新为粗体字：
+ J) w) Q# ~! z. ~3 UCATApplicationFrame CAAIAfrGeoCreationWkbFactory libCAAAfrGeoCreationWbench
% z3 ?7 l1 B/ P6 l! l, C, ^6 M$ ` CAAAfrGeoCreationWkb CATICAAAfrGeometryWksConfiguration libCAAAfrGeoCreationWbench

4 Y/ o7 r% M, }! S; s4 \+ c8 c
+ @, B$ l- ]9 B* ?% h* v2 I, w

4 `8 g& J2 h& o2 D 创建命令头
9 t$ p  l  t# A9 \4 U9 M+ g
+ Z4 }* c9 T' d2 Q( w- t这是通过完成CreateCommands方法。工作台中可用的每个命令都必须有一个命令头。命令头是命令头类的实例，并且不同的命令可以共享相同的命令头类来创建它们的命令头。有关更多详细信息，请参阅命令头。
单个命令头类的命令，命名CAAAfrGeoCreationWkbHeader使用创建的MacDeclareHeader宏。如果命令有时不可用，您也可以更经典地创建类。这在命令头中描述。
3 G2 z& K/ l& H7 i+ ]创建CAAAfrGeoCreationWkbHeader命令头类。为此，请在CAAAfrGeoCreationWkb.cpp中添加以下内容：
. b) a( b* U9 F9 A( w#include <CATCommandHeader.h>
MacDeclareHeader（CAAAfrGeoCreationWkbHeader）;
" d8 [6 W+ ~# f& v& S6 S( b5 P该MacDeclareHeader宏创建头文件并为CAAAfrGeoCreationWkbHeader类的源文件和联营与此类资源文件CAAAfrGeoCreationWkbHeader.CATNls和CAAAfrGeoCreationWkbHeader.CATRsc。
. u5 u. q8 b$ ?8 Z2 S" P8 p+ s创建代码以实例您的命令报头在CreateCommands方法。此方法应包含每个命令的命令头类的一个实例化语句。每个语句具有以下形式，例如对于Cuboid命令。
void CAAAfrGeoCreationWkb :: CreateCommands（）
+ p: ?7 e: S* l* o{
  ... ...
# w, m8 {) o  F8 ^* r( a  new CAAAfrGeoCreationWkbHeader（“CAAAfrCuboidHdr”，
% I3 ]" a& f$ ^: ?3 L                                 “CAADegGeoCommands”，
6 s! D# ~+ G6 G3 y! N+ N                                 “CAADegCreateCuboidCmd”，
) J1 N5 R$ x9 A; t/ ?! x9 b' \+ {1 t: X" [                                 （void *）NULL）;
  ... ...
}}  
命令头构造函数具有以下参数：
CAAAfruboidHdr是您需要分配给命令头的标识符。它将在以后使用：
要关联命令启动器，您将定义将命令放在菜单中，并在工具栏中使用命令头。这是该工作台在完成创建工作台和排列的命令。
构建定义命令头资源的变量，例如最终用户在菜单中以他/她自己的语言看到的名称，或要显示在工具栏中的图标。这是在解释 提供了资源和插入工作台到开始菜单
' }6 w  _2 I5 Y+ V* hCAADegGeoCommands 是包含Cuboid命令代码的共享库或DLL的名称，不带前缀lib，不带后缀，具体取决于操作系统。
) B$ e5 I/ A) tCAADegCreateCuboidCmd 是Cuboid命令类的名称
  h9 s- S* V+ W, T$ Q最后一个参数是执行它时传递​​给命令的对象的可能指针。它通常是指示当相同命令可以根据活动文档和数据（诸如“更新”或“全部更新”或“剪切”或“复制”）执行若干动作时执行的动作的字符串。

admin

1 创建工作台
工作台包含其工具栏及其菜单栏。创建工作台作为实例CATCmdWorkbench使用类NewAccess 宏。
CATCmdWorkbench * CAAAfrGeoCreationWkb :: CreateWorkbench（）
! w3 s6 n, `) s3 O9 H{
  NewAccess（CATCmdWorkbench，pCAAAfrGeoCreationWkb，CAAAfrGeoCreationWkb）;
  ... //见创建容器的工具栏和菜单栏
  return pCAAAfrGeoCreationWkb;
# d8 K/ i: |- p) p) @}}
pCAAAfrGeoCreationWkb是用来处理工作台实例指针变量，CAAAfrGeoCreationWkb就是工作台标识符。注意，工作台类名和工作台标识符必须相同，才能考虑开始菜单中的工作台资源。它们都以粗体字显示。此标识符还用于命名工作台资源文件CAAAfrGeoCreationWkb.CATNls和CAAAfrGeoCreationWkb.CATRsc。“为工作台创建资源”中介绍了工作台资源以及如何提供它们。

# S  w0 }4 h% U" e/ N
/ X& @. b# o7 G( E1 r: T6 @) o9 f2 为工具栏和菜单栏创建容器
工具栏和菜单栏又是命令和子菜单的容器。
创建工具栏和菜单栏的代码如下：
* o! R. b2 H9 ?2 u2 Y8 l; m... ...
% m1 Q  l/ O4 r8 Y) X) s, o) f3 J; k    NewAccess（CATCmdContainer，pCAAAfrSolidEltTlb，CAAAfrSolidEltTlb）;
    SetAccessChild（pCAAAfrGeoCreationWkb，pCAAAfrSolidEltTlb）;
    ... //见创建固体工具栏内容
    addToolbarView（pCAAAfrSolidEltTlb，1，Right）;

    NewAccess（CATCmdContainer，pCAAAfrSurfacicEltTlb，CAAAfrSurfacicEltTlb）;
    SetAccessNext（pCAAAfrSolidEltTlb，pCAAAfrSurfacicEltTlb）;
    ... //见创建曲面工具栏内容
+ l* d) A( N5 N: w" _, O    AddToolbarView（pCAAAfrSurfacicEltTlb，-1，Right）;
* u! D# U' o2 T) q4 K' y! H
    NewAccess（CATCmdContainer，pCAAAfrGeoCreationMbr，CAAAfrGeoCreationMbr）;
    ... //见创建菜单栏内容
" d% U- `. L, I( T- U    SetWorkbenchMenu（pCAAAfrGeoCreationWkb，pCAAAfrGeoCreationMbr）;
0 H! {; A- G# `9 x... ...
这里是发生什么：
, b$ q3 l, `5 {/ A& |1 y* J实体工具栏作为一个实例创建CATCmdContainer 使用类NewAccess宏。pCAAAfrSolidEltTlb是用于处理实体工具栏命令容器实例的指针的变量，并且CAAAfrSolidEltTlb是用来指它在工作台资源文件的标识符。此标识符在应用程序中可以找到的所有工具栏标识符之间必须是唯一的。实体工具栏使用设置工作台的子SetAccessChild宏，其默认位置是使用定义的AddToolbarView宏，在这里1指实体工具栏默认为可见（-1指不可见），并Right表示该工具栏停靠在右边侧的应用程序窗口。
0 @8 _* v3 M/ l1 ?5 k曲面工具栏被以相同的方式创建的，但它是使用设置实体工具栏旁SetAccessNext宏。默认情况下它是不可见的（-1表示不可见），并且也停靠在应用程序窗口的右侧。
菜单栏也被创建为实例CATCmdContainer 类被称为使用pCAAAfrGeoCreationMbr 指针。其标识符是CAAAfrGeoCreationMbr，用于其的资源。它被设置为使用工作台的菜单栏 SetWorkbenchMenu宏。


- o) F" |# i3 g8 m; Z8 U3 创建实体工具栏内容

此工具栏包含四个命令：Cuboid，Sphere，Torus和Cylinder。你应该为每个命令：
, o# M' r' S6 _6 C* X' ?+ z" W# g（1）创建使用命令启动NewAccess宏
（2）关联命令启动器，使用SetAccessCommand 宏，在定义适当的命令头识别 CreateCommands方法
（3）使用排列工具栏中的命令启动 SetAccessChild和SetAccessNext宏
... ...
      NewAccess（CATCmdStarter，pCAAAfrTSolidEltCuboidStr，CAAAfrTSolidEltCuboidStr）;
3 t8 N  k1 j, Y5 w/ W& W! d! D8 a      SetAccessCommand（pCAAAfrTSolidEltCuboidStr，“CAAAfrCuboidHdr”）;
( D; [+ n5 D& P) _1 g      SetAccessChild（pCAAAfrSolidEltTlb，pCAAAfrTSolidEltCuboidStr）;

+ M' `& L0 N1 l; y/ G7 \9 c8 B      NewAccess（CATCmdStarter，pCAAAfrTSolidEltSphereStr，CAAAfrTSolidEltSphereStr）;
      SetAccessCommand（pCAAAfrTSolidEltSphereStr，“CAAAfrSphereHdr”）;
6 q2 G9 g. A# J, q0 c; |" [- U      SetAccessNext（pCAAAfrTSolidEltCuboidStr，pCAAAfrTSolidEltSphereStr）;

      NewAccess（CATCmdStarter，pCAAAfrTSolidEltTorusStr，CAAAfrTSolidEltTorusStr）;
      SetAccessCommand（pCAAAfrTSolidEltTorusStr，“CAAAfrTorusHdr”）;
5 U  e, s2 V8 d" s4 T* k/ C      SetAccessNext（pCAAAfrTSolidEltSphereStr，pCAAAfrTSolidEltTorusStr）;

$ d% k5 h5 h! F1 _- B/ o      NewAccess（CATCmdStarter，pCAAAfrTSolidEltCylinder1Str，CAAAfrTSolidEltCylinder1Str）;
% ^, V5 R# d0 h  [  a! f      SetAccessCommand（pCAAAfrTSolidEltCylinder1Str，“CAAAfrCylinder1Hdr”）;
; J9 I8 x, \3 j, P4 o3 C% ]1 r      SetAccessNext（pCAAAfrTSolidEltTorusStr，pCAAAfrTSolidEltCylinder1Str）;
2 l/ S' i- }3 {( k. V2 ~
1 B, X6 x  f% s! h( d      NewAccess（CATCmdStarter，pCAAAfrTSolidEltCylinder2Str，CAAAfrTSolidEltCylinder2Str）;
      SetAccessCommand（pCAAAfrTSolidEltCylinder2Str，“CAAAfrCylinder2Hdr”）;
      SetAccessNext（pCAAAfrTSolidEltCylinder1Str，pCAAAfrTSolidEltCylinder2Str）;
" @: \  W3 W2 Y) n9 d9 W... ...

$ @# I  _" v5 ?7 ?0 b每个命令需要三个宏。例如，Cuboid命令处理如下：
! P5 W" t+ B" I1 F/ c. l" X首先创建命令启动作为CATCmdStarter使用实例NewAccess宏。pCAAAfrTSolidEltCuboidStr 是用于处理一个指向实例变量，并且 CAAAfrTSolidEltCuboidStr是它的标识。
! ]! z" Q7 g$ f( |然后使用这个命令启动长方体命令头相关联SetAccessCommand宏。第二个参数是定义为命令头导出器的第一个参数的Cuboid命令头标识符。请参阅创建命令头
( b8 j0 \7 g5 N0 Z& h3 Y) s7 B最后将Cuboid命令启动器设置为“实体”工具栏的子项。
继续在为其它命令的相同的方式，不同之处在于它们被设定为下一个使用彼此的SetAccessNext宏。


; u6 d; O; k( Z, L8 f4 创建曲面工具栏内容

* U% C( s" {+ @9 c& d  v此工具栏包含三个命令：Revolution Surface，Nurbs Surface和Offset Surface。你应该为每个命令：
创建使用命令启动NewAccess宏
关联命令启动器，使用SetAccessCommand 宏，在定义适当的命令头识别 CreateCommands方法
使用排列工具栏中的命令启动 SetAccessChild和SetAccessNext宏
5 R& \* L7 e1 L' i1 _) J; [... ...
    NewAccess（CATCmdStarter，pCAAAfrTSurfRevolStr，CAAAfrTSurfRevolStr）;
    SetAccessCommand（pCAAAfrTSurfRevolStr，“CAAAfrRevolSurfHdr”）;
    SetAccessChild（pCAAAfrSurfacicEltTlb，pCAAAfrTSurfRevolStr）;
: \7 g/ O+ U, W  h* @& Y- f
    NewAccess（CATCmdStarter，pCAAAfrTSurfNurbsStr，CAAAfrTSurfNurbsStr）;
! j" S+ J/ ]0 @0 R# D    SetAccessCommand（pCAAAfrTSurfNurbsStr，“CAAAfrNurbsSurfHdr”）;
    SetAccessNext（pCAAAfrTSurfRevolStr，pCAAAfrTSurfNurbsStr）;
0 K9 |3 A4 u8 F+ M" S$ \0 U
    NewAccess（CATCmdStarter，pCAAAfrTSurfOffsetStr，CAAAfrTSurfOffsetStr）;
    SetAccessCommand（pCAAAfrTSurfOffsetStr，“CAAAfrOffsetSurfHdr”）;
9 V/ t' S- l7 j; S    SetAccessNext（pCAAAfrTSurfNurbsStr，pCAAAfrTSurfOffsetStr）;
... ...
6 U# p. p3 c2 ?7 r" Z; q- M& @/ N每个命令需要三个宏。例如，Revolution Surface命令处理如下：
8 I2 K( t$ F. `' x6 d首先创建命令启动作为CATCmdStarter使用实例NewAccess宏。pCAAAfrTSurfRevolStr 是用于处理一个指向实例变量，并且 CAAAfrTSurfRevolStr是它的标识。
然后使用这个命令启动的回转面命令头相关联SetAccessCommand宏。第二个参数是Revolution Surface命令头标识符，定义为命令头导出器的第一个参数。请参阅 创建命令头
9 a$ D+ z6 r9 {+ D最后将Revolution Surface命令启动器设置为Surfaces工具栏的子项。
$ T) _$ H. M' G/ t/ N+ p& Q8 |继续在为其它命令的相同的方式，不同之处在于它们被设定为下一个使用彼此的SetAccessNext宏。

5 创建菜单栏内容
8 W4 A0 B* U% _1 x* U: i- _: h菜单和子菜单被创建为CATCmdContainer实例，菜单项被创建为CATCmdStarter实例。当运行时使用车间菜单栏加载或激活工作台时，您创建的菜单栏将合并，本身将导致默认菜单栏（即，没有文档处于活动状态时存在的菜单栏）与一个为车间定义。 您不能从默认菜单栏或为车间定义的菜单栏中删除菜单，也不能更改菜单​​顺序，也不能修改现有菜单项，也不能将子菜单添加到现有菜单项。您只能添加项在现有菜单的第一级具有子菜单或不是。

创建使用每个菜单和子菜单命令容器 NewAccess宏
5 i/ Y% E; z/ [1 b' S! l创建一个使用每个命令的命令启动NewAccess宏
& }2 |, M9 _% p. k  @- Q* M关联的每个命令启动器，使用SetAccessCommand 宏，在定义适当的命令头识别 CreateCommands方法
" k- x% C% w- p) z/ B, Z使用排列菜单命令首发SetAccessChild，和SetAccessNext宏

插入菜单 - 实体子菜单
5 b% _# B+ c4 t4 [/ v... ...
0 X( b$ c2 [3 a! Z6 E    NewAccess（CATCmdContainer，pCATAfrInsertMnu，CATAfrInsertMnu）;
    SetAccessChild（pCAAAfrGeoCreationMbr，pCATAfrInsertMnu）;

      NewAccess（CATCmdSeparator，pCAAAfrGeoCreationInsertSep，CAAAfrGeoCreationInsertSep）;
      SetAccessChild（pCATAfrInsertMnu，pCAAAfrGeoCreationInsertSep）;

/ `* L/ y8 U* n- L      NewAccess（CATCmdContainer，pCAAAfrSolidEltSnu，CAAAfrSolidEltSnu）;
      SetAccessNext（pCAAAfrGeoCreationInsertSep，pCAAAfrSolidEltSnu）;

        NewAccess（CATCmdStarter，pCAAAfrMSolidCuboidStr，CAAAfrMSolidCuboidStr）;
        SetAccessChild（pCAAAfrSolidEltSnu，pCAAAfrMSolidCuboidStr）;
4 E" }2 O) A' d+ \( ?        SetAccessCommand（pCAAAfrMSolidCuboidStr，“CAAAfrCuboidHdr”）;

        NewAccess（CATCmdStarter，pCAAAfrMSolidSphereStr，CAAAfrMSolidSphereStr）;
        SetAccessNext（pCAAAfrMSolidCuboidStr，pCAAAfrMSolidSphereStr）;
6 b1 p" B  s9 S. n+ o+ q. a        SetAccessCommand（pCAAAfrMSolidSphereStr，“CAAAfrSphereHdr”）;
8 o! J  w5 O, B' g4 {                            
        NewAccess（CATCmdStarter，pCAAAfrMSolidTorusStr，CAAAfrMSolidTorusStr）;
        SetAccessNext（pCAAAfrMSolidSphereStr，pCAAAfrMSolidTorusStr）;
        SetAccessCommand（pCAAAfrMSolidTorusStr，“CAAAfrTorusHdr”）;
: Q5 G  w  f0 |  y" ~2 {
        NewAccess（CATCmdStarter，pCAAAfrMSolidCylinder1Str，CAAAfrMSolidCylinder1Str）;
        SetAccessNext（pCAAAfrMSolidTorusStr，pCAAAfrMSolidCylinder1Str）;
- \  V8 k* i5 ?9 V( I  r. U, H        SetAccessCommand（pCAAAfrMSolidCylinder1Str，“CAAAfrCylinder1Hdr”）;

        NewAccess（CATCmdStarter，pCAAAfrMSolidCylinder2Str，CAAAfrMSolidCylinder2Str）;
; h5 P; X: y8 L4 k  W! J        SetAccessNext（pCAAAfrMSolidCylinder1Str，pCAAAfrMSolidCylinder2Str）;
        SetAccessCommand（pCAAAfrMSolidCylinder2Str，“CAAAfrCylinder2Hdr”）;
... ...
将创建“插入”菜单命令容器，即使它已经存在。然后创建Solids子菜单命令容器，并将其设置为“插入”菜单命令容器的子代。由于没有给出其他定位信息，它应该位于车间菜单栏的最后一个子菜单或命令之下，即平面命令。然后，创建Cuboid命令启动器并将其设置为Solids子菜单命令容器的子代，并将其他克隆并设置为彼此相邻。
插入菜单 - 曲面子菜单
; u. t+ s% S) ?8 S: t... ...
      NewAccess（CATCmdContainer，pCAAAfrSurfacicEltSnu，CAAAfrSurfacicEltSnu）;
; K& X1 {6 ~7 T      SetAccessNext（pCAAAfrSolidEltSnu，pCAAAfrSurfacicEltSnu）;
' \/ ]% [+ j0 F8 x1 ]* n0 i
" E2 z. H4 T1 o        NewAccess（CATCmdStarter，pCAAAfrMSurfRevolStr，CAAAfrMSurfRevolStr）;
        SetAccessChild（pCAAAfrSurfacicEltSnu，pCAAAfrMSurfRevolStr）;
        SetAccessCommand（pCAAAfrMSurfRevolStr，“CAAAfrRevolSurfHdr”）;
- Q* l+ j# j; E) q5 ~# ]
$ T8 x$ ~) o, I' c        NewAccess（CATCmdStarter，pCAAAfrMSurfNurbsStr，CAAAfrMSurfNurbsStr）;
2 g5 U! L. [8 \1 }5 z        SetAccessNext（pCAAAfrMSurfRevolStr，pCAAAfrMSurfNurbsStr）;
        SetAccessCommand（pCAAAfrMSurfNurbsStr，“CAAAfrNurbsSurfHdr”）;
% k" s4 E% v; y
. C, A8 b1 J" x3 K- ?2 d( \3 Z8 G        NewAccess（CATCmdStarter，pCAAAfrMSurfOffsetStr，CAAAfrMSurfOffsetStr）;
8 e! E* J* m) X, q; J        SetAccessNext（pCAAAfrMSurfNurbsStr，pCAAAfrMSurfOffsetStr）;
        SetAccessCommand（pCAAAfrMSurfOffsetStr，“CAAAfrOffsetSurfHdr”）;
, E1 j: N- N& E3 H% e... ...
创建Surfaces子菜单命令容器并将其设置在Solids子菜单命令容器旁边。然后创建Revolution Surface命令启动器，并将其设置为Surfaces子菜单命令容器的子代，其他都是cretaed并且彼此相邻设置。
( b/ k2 _+ H" G5 h) b/ j3 v创建Workbench的资源中描述了菜单和子菜单资源以及如何提供它们。参见提供了资源和插入工作台到开始菜单的所有资源的概况创建。

' j) n; o; L8 |) G8 c/ W提供资源并将工作台插入“开始”菜单

您应该为工作台及其所有内容提供资源。这些资源分类如下：
工作台和命令容器资源，位于两个工作台资源文件中：
1 c/ f1 G# u, k$ D9 }资源文件包含英语的标题和帮助消息，并且可以翻译成其他语言。它使用CATNls作为后缀
' a8 C# L% V- Z5 y资源文件包含不应翻译的图标和其他资源。后缀为CATRsc
资源文件必须具有工作台标识符作为文件名，即CAAAfrGeoCreationWkb。该标识符在声明 CreateWorkbench工作台描述类的方法，作为第三个参数NewAccess创建工作台宏。
8 m' m! u, U/ ^5 B* k" Z1 b( O1 Q( }. ]NewAccess（CATCmdWorkbench，pCAAAfrGeoCreationWkb，CAAAfrGeoCreationWkb）;
$ s8 R+ w7 W3 M* Q+ f! ?' z* @8 `6 Q然后，工作台资源文件为CAAAfrGeoCreationWkb.CATNls和CAAAfrGeoCreationWkb.CATRsc。这些文件位于包含工作台模块的框架的CNext \ resources \ msgcatalog目录中。此目录包含子目录，每个语言都可以转换CAAAfrGeoCreationWkb.CATNls文件的标题和消息。资源文件包含：
/ b$ T+ {+ H! G* p* r5 i要显示的标题，消息和图标：工作台 开始菜单
工具栏：他们的标题
# [; c, e! ^( _! ^) r菜单和子菜单：其标题，图标和助记符
; R3 S& L0 u) t9 a# K! u( J0 y1 [图标框：他们的标题。
/ |7 o/ H0 O# M: x6 V每个资源使用键和文本提供，或者使用没有后缀的文件名，用等号分隔。键被构建为你定义为第三参数的对象标识符的级联 NewAccess宏，一个点，一个关键字指定相应的资源。消息使用双引号括起来并以分号结尾。例如，CAAAfrGeoCreationWkb工作台标题定义如下：
- Y$ @- Y9 c  N3 G8 Q. NCAAAfrGeoCreationWkb.Title =“CAA V5：Geometrical Creation”;
4 e- J! W" N; s6 |* j$ D) jCAAAfrGeoCreationWkb.CATNls文件
此文件包含：
* ^! }* _. t8 R& w  Y, R对于工作台本身的资源：在使用的标题 开始菜单，其相关的帮助信息，当鼠标移动到工作台图标显示简短的帮助和长帮助
工具栏和图标框的标题
菜单和子菜单的标题和助记符。
CAAAfrGeoCreationWkb.CATNls，如下所示：
( S% v) Q. h/ ]6 v// ------------------------------------------------ ----------------------------
& G+ e- J, K. Q# M// 工作台
// ------------------------------------------------ ----------------------------
9 K3 @6 A9 M  n" aCAAAfrGeoCreationWkb.Title =“CAA V5：Geometrical Creation”;
3 g( ?- o% `, q9 B# F1 eCAAAfrGeoCreationWkb.ShortHelp =“工作台创建几何元素”;
CAAAfrGeoCreationWkb.Help =“工作台创建几何，实体和表面元素”;
CAAAfrGeoCreationWkb.LongHelp =“这是CAA V5：几何创建工作台。
% \% W* p- H( U它用于演示工作台。
它包含两个工具栏：
- 一个用于某些实体元素
- 另一个为一些Surfacic元素“;
. B  |, Z7 V. d$ v* ~$ b
// ------------------------------------------------ ----------------------------
* [, I! v$ ]* x2 s+ c, d+ C//工具栏
// ------------------------------------------------ ----------------------------
CAAAfrSolidEltTlb.Title =“固体”;
! d& y7 r* X8 \9 U$ K" @CAAAfrSurfacicEltTlb.Title =“表面”;
+ q( C7 e; ?; x
// ------------------------------------------------ ----------------------------
// SUB  -  MENU
5 h( r3 g2 Y3 Q4 X5 j, P! l/ H) X// ------------------------------------------------ ----------------------------
CAAAfrSolidEltSnu.Title =“固体”;
CAAAfrSolidEltSnu.Mnemonic =“S”;
5 l( c  d+ E& U+ B
CAAAfrSurfacicEltSnu.Title =“表面”;
CAAAfrSurfacicEltSnu.Mnemonic =“u”;
; ^2 ]$ q& P* W$ C0 @) @CAAAfrGeoCreationWkb.CATRsc文件
5 N1 U) O/ f% u9 J此文件包含的类别，即子菜单启动 那里的工作台应该会出现菜单，图标的名称与工作台的关联开始菜单。
CAAAfrGeoCreationWkb.Category =“基础设施”;
: x1 G, `1 y: K# q/ ^' Z4 K$ v
//欢迎窗口的图标64x64
CAAAfrGeoCreationWkb.Icon.NormalPnl =“I_WkAsCAAAfrGeoCreationWkb”;
; S, O' I; l, E3 L+ F& Q; ^CAAAfrGeoCreationWkb.Icon.PressedlPnl =“IP_WkAsCAAAfrGeoCreationWkb”;
CAAAfrGeoCreationWkb.Icon.FocusedlPnl =“IF_WkAsCAAAfrGeoCreationWkb”;

0 r6 b% o& H. \7 j2 {8 d! b//开始菜单的图标32x32
CAAAfrGeoCreationWkb.Icon.NormalCtx =“I_WkNvCAAAfrGeoCreationWkb”;
CAAAfrGeoCreationWkb.Icon.PressedlCtx =“IP_WkNvCAAAfrGeoCreationWkb”;
0 s2 X* o4 K) T$ x% rCAAAfrGeoCreationWkb.Icon.FocusedlCtx =“IF_WkNvCAAAfrGeoCreationWkb”;
3 {# n" j: v9 D- v
2 Q2 o: O. V9 o' _( @% [$ C//工作台工具栏的图标24x24
5 m4 R9 r! X5 x. ^CAAAfrGeoCreationWkb.Icon.NormalRep =“I_WkCAAAfrGeoCreationWkb”;
5 W# @5 g) L; @4 v( q. aCAAAfrGeoCreationWkb.Icon.PressedlRep =“IP_WkCAAAfrGeoCreationWkb”;
CAAAfrGeoCreationWkb.Icon.FocusedlRep =“IF_WkCAAAfrGeoCreationWkb”;
正是在这个文件中声明，如果工作台的热启动标准[ 3 ]。CAAGeometry文档不是热启动兼容的，因此它的工作台也不兼容。
+ V2 z+ R3 v% l+ M命令头资源文件中的命令头资源：标题，消息，图标和与命令相关联的加速器。在运行时搜索的资源文件应与命令头类（即CAAAfrGeoCreationWkbHeader）具有相同的名称。
- c7 R3 u' `+ f0 UCAAAfrGeoCreationWkbHeader.CATNls文件包含以下用于Cuboid命令的文件
CAAAfrGeoCreationWkbHeader.CAAAfrCuboidHdr.Category =“Element”;
8 j) t8 [: q+ lCAAAfrGeoCreationWkbHeader.CAAAfrCuboidHdr.Title =“Cuboid”;
6 d# c) y- O, l. y8 m, A0 LCAAAfrGeoCreationWkbHeader.CAAAfrCuboidHdr.ShortHelp =“Cuboid”;
CAAAfrGeoCreationWkbHeader.CAAAfrCuboidHdr.Help =“Cuboid命令尚未实现”;
( x2 K  D5 s+ [& r# @/ gCAAAfrGeoCreationWkbHeader.CAAAfrCuboidHdr.LongHelp =“Cuboid（插入菜单）
6 N" t  f% s# g5 u  fCuboid命令允许您创建一个长方体，但尚未实现。
... ...
8 z- r; n! J' n1 L对于每个命令，标题，短的帮助，帮助和长的帮助被声明。
) `" p1 ~  k3 Y5 ?, a3 Z4 x对于Cuboid命令，CAAAfrGeoCreationWkbHeader.CATRsc文件包括以下内容
CAAAfrGeoCreationWkbHeader.CAAAfrCuboidHdr.Icon.Normal =“I_CAACube”;
8 p7 T4 O( a4 H... ...
$ B$ l, w. E! m) p此图标名称显示在包含Cuboid命令的“实体”工具栏中。该图标也显示在菜单中的菜单项前面。
6 r% P1 ]6 m* ?# F/ q) R命令启动程序资源是与命令关联的助记符。它们在运行时自动设置。
有关国际化和资源的更多信息，请参见国际化您的客户端应用程序。
' j$ n* g+ t$ O) o$ j


* _6 b6 D! @( M; J+ R' M$ P