beforebuild 事件
當重新連編一個項目之前,或者從一個項目創建一個應用程式檔案 (.app)、動態連結庫 (.dll) 或執行檔 (.exe) 之前發生。
語法
PROCEDURE Object.BeforeBuild
[LPARAMETERS cOutputName, nBuildAction, lRebuildAll, lShowErrors, lBuildNewGuids]
參數
cOutputName
指定要創建的應用程式、動態程式庫或執行檔的名稱。
如果 cOutputName 包含一個擴展名,並且省略了 nBuildAction,則cOutputName 指定的擴展名確定了要連編檔案的類型。
nBuildAction
指定是重新連編該項目,還是創建一個應用程式、動態程式庫或執行檔。下表列出了nBuildAction 的取值,以及每個值的說明。
nBuildAction FoxPro.h 常數 說明
1 BUILDACTION_REBUILD 重新連編項目。
2 BUILDACTION_BUILDAPP 創建一個 .app 檔案。
3 BUILDACTION_BUILDEXE 創建一個 .exe 檔案。
4 BUILDACTION_BUILDDLL 創建一個 .dll 檔案。
nBuildAction 的值優先於 cOutPutName 指定的擴展名。例如,如果nBuildAction 為 3並且 cOutputName 沒有指定 ?exe?擴展名,則會創建一個執行檔。
lRebuildAll
指定在創建一個 .app、.dll 或 .exe 檔案之前,是否重新編譯項目中的檔案。如果 lRebuildAll 為“真” (.T.),則重新編譯以下檔案:
程式檔案。
格式檔案。
表單、報表和可視類庫中的原始碼。
資料庫中的存儲過程。
如果 lRebuildAll 為“假” (.F.) 或省略,則在創建一個 .app、.dll 或 .exe 檔案之前,不重新編譯項目中的檔案。
lShowErrors
指定在連編之後是否在一個編輯視窗中顯示編譯錯誤。如果 lShowErrors 為“真” (.T.),則顯示編譯錯誤。如果 lShowErrors 為“假” (.F.) 或省略,則不顯示編譯錯誤。
lBuildNewGUIDs
指定當創建一個執行檔或動態程式庫時是否生成新的註冊 GUID(globally unique identifiers)。如果lBuildNewGUIDs 為“真” (.T.),則生成新的 GUID。如果 lBuildNewGUIDs為“假” (.F.) 或省略,則不生成新的 GUID。如果 nBuildAction 小於 3,則不生成新的 GUID。
說明
當執行 build 方法,發出 BUILD APP、BUILD DLL、BUILD EXE 或 BUILDPROJECT 命令,或者當在“連編選項”對話框選擇“確定”按鈕時,上面所列的參數回傳遞給 beforebuild 事件。這些參數除了 nBuildAction 都是按引用傳遞的。您可以在 beforebuild 事件中更改這些參數的值,以更改如何根據項目創建項目、.app、.dll或 .exe 檔案的。在 beforebuild 事件中包含 NODEFAULT,可以防止重新連編項目,或者防止創建應用程式檔案 (.app)、動態程式庫 (.dll) 或執行檔 (.exe)。
套用於
projecthook 對象