下面的例子說明了如何使用CAA C++開發(fā)方式來建立一個CATIA內(nèi)部程序。實(shí)現(xiàn)的功能是新建一個*的工作臺（workbench），并在其下面實(shí)現(xiàn)添加自定義菜單，添加工具條以及按鈕圖標(biāo)，插入CATIA風(fēng)格的對話框。并生成對界面功能的響應(yīng)，建立command，實(shí)現(xiàn)調(diào)用對話框，以及通過輸入?yún)?shù)直接用代碼生成一個三維模型，并在CATIA主窗口中顯示。

1、新建*的workbench

CATIA V5將某類包含一系列交互命令的一些工具條分組顯示在不同的工作臺（workbench）中，這樣有利于工具的查找和使用。通過自己新建的workbench可以將自己二次開發(fā)形成的一系列命令集中顯示在一個工作臺中，便于以后的操作。工作臺的建立需要以下幾個步驟。
?
創(chuàng)建工作臺廠（factory）的接口（interface）；
?
創(chuàng)建工作臺廠；
?
創(chuàng)建工作臺描述類；
?
創(chuàng)建響應(yīng)命令（command）的標(biāo)題；
?
創(chuàng)建工作臺并排列圖標(biāo)按鈕響應(yīng)；
?
提供圖片及提示等資源并將新建的工作臺插入開始菜單；
?
創(chuàng)建工作臺的顯示界面。

插入新建的工作臺MyWorkBench后的CATIA開始菜單如圖3所示，它與CATIA現(xiàn)有的模塊成為并列關(guān)系。現(xiàn)在進(jìn)入MyWorkBench工作臺里面沒有任何工具條及按鈕，下面添加這部分工具。

圖3 生成的新的工作臺

2、添加工具條及按鈕

首先創(chuàng)建按鈕的描述類CAAAfrGeoCreationWkb，派生于CATBaseUnknown類。CATBaseUnknown是創(chuàng)建用戶界面并實(shí)現(xiàn)界面的基類，所有的接口都是從IUnknown／CATBaseUnknown繼承的。這個類中建立了兩個函數(shù)分別為CATCmdWorkbench *的CreateWorkbench()函數(shù)和無返回值類型的CreateCommands()。前面的函數(shù)是用來實(shí)現(xiàn)順序插入工具條、按鈕圖標(biāo)以及菜單，后面的函數(shù)是實(shí)現(xiàn)對插入按鈕以及菜單和響應(yīng)函數(shù)的關(guān)聯(lián)。

在CreateWorkbench()函數(shù)中用到了宏NewAccess(className,variableName,objectName)。CATIA的工作場（workshop）或者工作臺（workbench）可以被看作是一個入口的集合包，使用NewAccess宏可以創(chuàng)建一個這樣的入口。使用SetAccessChild(variableName,childName)以及SetAccessNext (variableName,nextName)這兩個宏則可以連接入口。其中className表示被創(chuàng)建類的類型，包括以下幾種類型：CATCmdContainer，CATCmdWorkshop，CATCmdSeparator，CATCmdStarter。下面就是創(chuàng)建了一個按鈕的容器，也就是工具條，并在其中添加按鈕的部分代碼。

NewAccess(CATCmdContainer,pCAAAfrTB1EltTlb,CAAAfrTB1EltTlb);//創(chuàng)建工具條pCAAAfrTB1EltTlb
SetAccessChild(pCAAAfrGeoCreationWkb, pCAAAfrTB1EltTlb); //工具條加入工作臺
//創(chuàng)建按鈕cmd1，并設(shè)置其響應(yīng)宏為CAAAfrCmd1Hdr，最后將其加入工具條TB1中
NewAccess(CATCmdStarter,pCAAAfrTTB1EltCmd1Str,CAAAfrTTB1EltCmd1Str);
SetAccessCommand(pCAAAfrTTB1EltCmd1Str,"CAAAfrCmd1Hdr");
SetAccessChild(pCAAAfrTB1EltTlb,pCAAAfrTTB1EltCmd1Str);

接下來繪制一個圖標(biāo)，并在CAAAfrGeoCreationWkbHeader.CATRsc中將其關(guān)聯(lián)，具體如下，則cmd1按鈕顯示的是CAACmd1.Bmp圖標(biāo)。

CAAAfrGeoCreationWkbHeader.CAAAfrCmd1Hdr.Icon.Normal = "I_CAACmd1";
在CAAAfrGeoCreationWkbHeader.CATNls文件中設(shè)置新建按鈕的標(biāo)題以及提示內(nèi)容
CAAAfrGeoCreationWkbHeader.CAAAfrCmd1Hdr.Category = "Element";
CAAAfrGeoCreationWkbHeader.CAAAfrCmd1Hdr.Title = "command1";
CAAAfrGeoCreationWkbHeader.CAAAfrCmd1Hdr.ShortHelp = "new cmd1";

添加兩個工具條并插入一系列按鈕的效果圖如下面圖4所示。

圖4 新添加的按鈕 圖5 添加的菜單

3、添加菜單

菜單的添加與添加按鈕類似，也是在CreateWorkbench()函數(shù)中，只不過是在宏中的參數(shù)與添加按鈕并不一樣。添加后的效果圖如圖5所示

NewAccess(CATCmdContainer, pCAAAfrGeoCreationMbr, CAAAfrGeoCreationMbr);
NewAccess(CATCmdContainer, pCATAfrInsertMnu, CATAfrInsertMnu);
SetAccessChild(pCAAAfrGeoCreationMbr, pCATAfrInsertMnu);
NewAccess(CATCmdSeparator, pCAAAfrGeoCreationInsertSep, CAAAfrGeoCreationInsertSep);
SetAccessChild(pCATAfrInsertMnu, pCAAAfrGeoCreationInsertSep);
NewAccess(CATCmdContainer, pCAAAfrMeu1EltSnu, CAAAfrMeu1EltSnu);
SetAccessNext(pCAAAfrGeoCreationInsertSep, pCAAAfrMeu1EltSnu);
NewAccess(CATCmdStarter, pCAAAfrMMeu1SubMn1Str, CAAAfrMMeu1SubMn1Str);
SetAccessChild(pCAAAfrMeu1EltSnu, pCAAAfrMMeu1SubMn1Str);
SetAccessCommand(pCAAAfrMMeu1SubMn1Str, "CAAAfrCmd1Hdr");
在CAAAfrGeoCreationWkb.CATNls文件中設(shè)置菜單顯示的屬性。
CAAAfr Meu1EltSnu.Title = "新建菜單1" ;
CAAAfr Meu1EltTlb.Title = "command1" ;

3、建立菜單以及按鈕的響應(yīng)類

建好的workbench空框架中可以創(chuàng)建三種類型的響應(yīng)（command）類，他們都是CATCommand派生出來的。具體添加過程是打開CAA Rade 菜單"Insert"，選擇 "CATIA Resource"下的"Command..."。可以選擇Statechart command，dialog-box based command和 Basic command。Basic command是創(chuàng)建一個空的響應(yīng)類，在函數(shù)Activate( CATCommand * iFromClient, CATNotification * iEvtDat)中添加響應(yīng)。

dialog-box based command在二次開發(fā)中會被更多的用到。選擇該類型響應(yīng)類，在運(yùn)行的時候會直接彈出一個對話框，當(dāng)然，可以對這個對話框進(jìn)行編輯。對話框編輯界面如圖6所示，里面有一個正在編輯的對話框，在圖的中部，右邊是自帶的一些控件，包括CATDlgFrame，CATDlgLabel，CATDlgEditor，CATDlgPushButton，CATDlgRadioButton等等。對話框內(nèi)所有的控件在Build（）函數(shù)中列出，應(yīng)用函數(shù)SetGridConstraints（short int iTopRow, short int iLeftColumn, short int iRowSpan, unsigned int iJustification）通過設(shè)置控件在對話框中矩陣位置的方式來調(diào)整位置。

為控件添加回調(diào)函數(shù)來響應(yīng)各種操作。如圖7所示，CATDlgPushButton按鈕控件包括Creation，Visibility swap，Resizement，Button activation以及Repetitive button activation5中回調(diào)函數(shù)。選擇Button activation產(chǎn)生點(diǎn)擊響應(yīng)生成回調(diào)函數(shù)OnPushButton004PushBActivateNotification(CATCommand* cmd, CATNotification* evt, CATCommandClientData data)，可以在這個函數(shù)內(nèi)添加代碼。

圖6 對話框編輯 圖7 添加對話框控件回調(diào)函數(shù)

四、開發(fā)實(shí)例