【文章內(nèi)容簡介】 對象技術(shù)的 Pro/TOOLKIT 不允許直接訪問這些結(jié)構(gòu)的內(nèi)容。 Pro/TOOLKIT 函數(shù)返回值 大多數(shù) Pro/TOOLKIT 函數(shù)的返回值類型為 ProError，用來表示調(diào)用函數(shù)執(zhí)行狀態(tài)。最常用返回值是 PRO_TK_NO_ERROR,表示函數(shù)調(diào)用成功。在程序中，通過檢查函數(shù)的返回值不僅便于在調(diào)試是找出錯誤，更重要的是可以避免在執(zhí)行時出現(xiàn)異常情況，提高了程序的可靠性。 創(chuàng)建 Pro/TOOLKIT 應(yīng)用程序的基本方法 創(chuàng)建基本方法 ； 利用 Make 文件創(chuàng)建 Pro/TOOLKIT 應(yīng)用程序；利用 VC向?qū)?chuàng)建 Pro/TOOLKIT 應(yīng)用程序 。 采用 Make 文件 的方法創(chuàng)建 Pro/TOOLKIT應(yīng)用程序 必須手工修改 make 文件，程序的設(shè)置與調(diào)試均不方便，且不能充分利用 VC 的資源。所以本課題 利用 VC 向?qū)?chuàng)建 Pro/TOOLKIT 應(yīng)用程序 。 在 Visual C++ 環(huán)境下新建一個 dll工程。 (1)進入 Visual C++ 集成開發(fā)環(huán)境，選擇“ File/New...”選項，啟動 “ New”對話框。 在“ New”對話框中選擇“ Projects”選項卡，選擇 MFC AppWizard(dll)項。在 “ Project nam” 輸 入工程文件名，在 “ Location” 輸入框中輸入路徑。單擊OK 按鈕 。 (2)在“ MFC AppWizard” 對話框中選擇 “ Regular DLL using shared MFC DLL” 單選框，使 Pro/TOOLKIT 應(yīng)用程序使用共享的 MFC。單擊 Finish 按鈕，進入 New Project Information 窗口后，單擊 OK 按鈕，完成工程文件框架的建立。 (3)選擇 FileView 打開 VC 應(yīng)用程序向?qū)ё詣由沙绦蛭募?. VC 應(yīng)用程序設(shè)計向?qū)г?FileView 中自動加入了 、 和以工程文件名為前綴的 cpp 資源文件、 def 模塊定義文件以及 rc 資源文件等。如下圖 ： 圖 VC文件圖 Pro/TOOLKIT 信息文件的建立 信息 文件是一種 ASCII 碼文件，用來定義菜單項、菜單項提示等信息，可以用 Word 記事本和寫字板等文字處理軟件建立，也可在 VC 的集成開發(fā)環(huán)境 中建立，但必須以純文本格式保存且信息文件以四行為一組。 其含義分別如下： 第一行： Pro/ENGINEER 系統(tǒng)可以識別的關(guān)鍵字，該關(guān)鍵字必須與該信息文件函數(shù)中的相關(guān)字符串相同。 第二行：再菜單項 或菜單項提示上顯示的英語文本。 第三行：另一種語言的譯文或為空。 第四行：當(dāng)前的 Pro/ENGINEER 版本為空。 其中，第二﹑第四行的語言顯示取決于系統(tǒng)環(huán)境變量 lang 的設(shè)置。同時，信息文件必須位于 textpath\text 或 textpath\text\language文件夾，language為 chinese 時表示信息為中文，為 usascii 表示信息為英語。由此，可以通過系統(tǒng)的環(huán)境變量控制顯示的語種，不必修改程序。 編譯和連接設(shè)置 設(shè)置包含文件路徑 ，加入“ \PROTOOLKIT\INCLUDES”； 設(shè)置庫文件路徑 ，加入“ \PROTOOLKIT\I486_NT\OBJ” ；設(shè)置連接所需庫文件 ，加入“ ”兩庫文件；在菜單“ Project/Settings”的“ Link”選項頁設(shè)定強制文件輸出，即選中“ Force file output”的復(fù)選項 。 編制注冊文件及應(yīng)用程序的運行 編制注冊文件 在 Pro/ENGINEER 中運行 Pro/TOOLKIT 應(yīng)用程序 ，必須先進行注冊。注冊文件的作用是向 Pro/ENGINEER 系統(tǒng)傳遞應(yīng) 用程序的信息。一般可只選擇Name EXEC_FILE TEXT_DIR STARTUP ALLOW_STOP REVISION 和 END項即可。保存注冊文件時，要以 .dat 為擴展名。建立 缸體 的注冊文件如圖 ： 圖 缸體 注冊文件圖 應(yīng)用程序的運行 1 注冊運行分為自動注冊和手動注冊。 缸體 采用自動注冊，并將注冊文件名取為“ ”將此文件位于 Pro/ENGINEER 的起始位置設(shè)定的目錄。其注冊文件設(shè)置 DELAY_START 的值為 FALSE，應(yīng)用程序自動運行。 2 卸載應(yīng)用程序。將注冊文件中 ALLOW_STOP 設(shè)為 TRUE，可以手工終止運行。如果啟動應(yīng)用程序失敗，可以選擇信息按鈕來顯示應(yīng)用程序的有關(guān)注冊信息，以便找出錯的原因。 第 三 章 用戶界面設(shè)計 Pro/ENGINEER可以利用 Pro/TOOLKIT提供的菜單 UI對話框以及 VC 的可視化界面技術(shù)，設(shè)計出方便實用的人機交互界面，從而大大提高系統(tǒng)的使用效率。在設(shè)計人機交互界面時，要盡量能使操作自然簡便快捷。 菜單的設(shè)計 菜單是 Pro/ENGINEER 的主要用戶界面， Pro/TOOLKIT 提供了一系列菜單操作函數(shù)，允許應(yīng)用程序創(chuàng)建何管理菜單。在應(yīng)用 Pro/TOOLKIT 對Pro/ENGINEER 進行開發(fā)的過程中，添加用戶自定義菜單是最常用的技術(shù)。菜單在 Pro/ENGINEER 界面上的生成代表著動態(tài)鏈接庫加載成功，這是進行后續(xù)工作的基礎(chǔ)。 向菜單欄添加 菜單條 Pro/ENGINEER 是一個不斷發(fā)展不斷更新的軟件，某個版本下有的菜單在另外一個版本下可能沒有，因此，如果用戶自定義菜單依賴某個菜單條，很有可能在另外一個版本中就不能正常使用。這樣只能修改應(yīng)用程序來適應(yīng)這種變化，其軟件的通用性較差。因此，決定在 Pro/ENGINEER 界面上添加新的菜單條。 菜單條是 Pro/ENGINEER 菜單體系的最頂層菜單，其創(chuàng)建的方法是：直接調(diào)用 ProMenubarMenuAdd()函數(shù)向 Pro/ENGINEER 添加所需的菜單，要實現(xiàn)函數(shù)的功能，就必須將改按鈕和命令捆綁在一起 。該命令調(diào)用某個函數(shù)實現(xiàn)按鈕功能，在 Pro/TOOLKIT 中，完成命令添加的函數(shù)是 ProCmdAction（），函 數(shù) 調(diào) 用 成 功 返 回 PRO_TK_NO_ERROR （ 0 ）， 否 則 返 回PRO_TK_GENERAL_ERROR(1)。 向菜單條下添加下級子菜單 缸體分為嵌入新建、修改、幫助，不可能每個都建立一個菜單條。因此必須添加下級菜單以達到建立一個自然便捷的界面的目的。調(diào)用ProMenubarmenuMenuAdd（）函數(shù) ，并在此菜單下添加菜單項。 缸體 菜單設(shè)計 在旁邊插入一個菜單條（ UserMenu） “ Pro/e 二次開發(fā) (amp。E)”，在其下添加一個下級子菜單（ SubMenu ）“ 缸體 ”。在子菜單下建立 三 個菜單按鈕：UsrPd_新建 ， UsrPd修改 ， Help幫助 。 建立的程序清單如下： static uiCmdAccessState UsrAccessDefault(uiCmdAccessMode access_mode)//訪問控制函數(shù) { return (ACCESS_AVAILABLE)。 } static uiCmdAccessState UsrAccessDefault2(uiCmdAccessMode access_mode)//訪問控制函數(shù) { ProError err。 ProMdl mdl。 err=ProMdlCurrentGet(amp。mdl)。 if (err!=PRO_TK_NO_ERROR) return ACCESS_UNAVAILABLE。 return (ACCESS_AVAILABLE)。 } static uiCmdAccessState UsrAccessDefault3(uiCmdAccessMode access_mode)//訪問控制函數(shù) { ProError err。 ProMdl mdl。 err=ProMdlCurrentGet(amp。mdl)。 if (err!=PRO_TK_NO_ERROR) return ACCESS_AVAILABLE。 return (ACCESS_UNAVAILABLE)。 } ProError UsrActionTest()。//該函數(shù)為按鈕調(diào)用的動作函數(shù) ProError UsrActionRepair()。 ProError UsrActionHelp()。 extern C int user_initialize(int argc,char *argv[]) { ProError err。 ProFileName Msg。 uiCmdCmdId uiCmdCmdIdUsrbom。 uiCmdCmdId uiCmdCmdIdUsr2。 // uiCmdCmdId uiCmdCmdIdUsr3。 uiCmdCmdId uiCmdCmdIdUsr4。 ProStringToWstring(Msg,)。 err=ProMenubarMenuAdd(UsrPd_,UsrPd,Help,PRO_B_TRUE,Msg)。//添加菜單按鈕 err=ProCmdActionAdd(usr_test_button,(uiCmdCmdActFn)UsrActionTest,uiProeImmediate,UsrAccessDefault3,PRO_B_FALSE,PRO_B_FALSE,amp。uiCmdCmdIdUsrbom)。//定義新建按鈕動作函數(shù) err=ProMenubarmenuPushbuttonAdd(UsrPd_,UsrCreate_,UsrCreate,Used to Create,NULL,PRO_B_TRUE,uiCmdCmdIdUsrbom,Msg)。//添加新建按鈕 err=ProCmdActionAdd(usr_UsrRepair_button,(uiCmdCmdActFn)UsrActionRepair,uiProeImmediate,UsrAccessDefault2,PRO_B_FALSE,PRO_B_FALSE,amp。uiCmdCmdIdUsr2)。//添加修改動作函數(shù) err=ProMenubarmenuPushbuttonAdd(UsrPd_,UsrRepair_ ,UsrRepair,Used to Repair,NULL,PRO_B_TRUE,uiCmdCmdIdUsr2,Msg)。//添加修改按鈕 err=ProCmdActionAdd(usr_UsrHelp_button,(uiCmdCmdActFn)UsrActionHelp,uiProeImmediate,UsrAccessDefault,PRO_B_FALSE,PRO_B_FALSE,amp。uiCmdCmdIdUsr4)。//添加幫助動作函數(shù) err=ProMenubarmenuPushbuttonAdd(UsrPd_,UsrHelp_ ,UsrHelp,Used to help,NULL,PRO_B_TRUE,uiCmdCmdIdUsr4,Msg)。//添加幫助按鈕 return 0。 } extern C void user_terminate() { } include CUsrDlgTest *dlg。 ProError UsrActionTest() { AFX_MANAGE_STATE(AfxGetStaticModuleState())。 if (dlg!=NULL) delete(dlg)。 dlg=new CUsrDlgTest()。 dlgCreate(IDD_DIALOG_TEST)。 dlgShowWindow(SW_SHOW)。 return PRO_TK_NO_ERROR。 } ProError UsrActionRepair() { AFX_MANAGE_STATE(AfxGetStaticModuleState())。 if (dlg!=NULL) delete(dlg)。 dlg=new CUsrDlgTest()。 dlgCreate(IDD_DIALOG_TEST)。 dlgShowWindow(SW_SHOW)。 return PRO_TK_NO_ERROR。 } ProError UsrActionHelp() { AFX_MANAGE_STATE(AfxGetStaticModuleState())。 ProError err。 //獲取 text父路徑 ProPath text_path。 err=ProToolkitApplTextPathGet(text_path)。 if (err!=PRO_TK_NO_ERROR) return err。