文件函數參考 (iLogic)

使用文件函數可存取 Inventor 零件、組合或圖面文件。

文件函數可讓您執行諸如取得檔名和更新模型等工作。

在文件函數中,ThisDoc 指在其中寫入規則的 Inventor 文件。該文件通常為作用中文件,但也可以是組合內的零件。不論規則儲存在何處,ThisDoc 均可讓您存取該文件。

若要存取文件函數,請在 iLogic「編輯規則」對話方塊的「片段」區域中,展開「系統」頁籤下的「文件」節點。

Path

將文件路徑 (資料夾名稱) 做為文字字串傳回。

語法

ThisDoc.Path

FileName

傳回文件的檔名。

語法

ThisDoc.FileName(False)

如果將 False 做為引數提供,則不會包括副檔名。若要包括副檔名,請改為使用 True 做為引數。

PathAndFileName

傳回文件的路徑和檔名。

語法

ThisDoc.PathAndFileName(False)

如果將 False 做為引數提供,則不會包括副檔名。若要包括副檔名,則請在括號中改為使用 True

ChangeExtension

使用文件的檔名及變更後的副檔名建立檔名。

語法

changedName = ThisDoc.ChangeExtension(".new")

WorkspacePath

傳回作用中 Inventor 專案工作區的路徑 (資料夾名稱)。如果未定義任何工作區,此函數會傳回空字串 (不包含任何字元,長度為零的字串)。

語法

ThisDoc.WorkspacePath()

Launch

根據提供的路徑和檔名 (包括副檔名) 啟動檔案。如果指定資料檔,該檔案將在其原生應用程式中開啟。如果指定執行檔 (.exe),其將執行該程式。如果不指定完整的路徑,iLogic 會在 Inventor 文件所在的同一資料夾中尋找該檔案。您也可以指定文件資料夾的相對名稱和路徑。

語法

ThisDoc.Launch("path\file.ext")

Save

儲存目前的作用中文件。此函數不能在由參數變更事件觸發的規則中使用。

語法

ThisDoc.Save

UpdateWhenDone

將在規則 (及其觸發的所有規則) 執行完成之後更新規則所在的文件。此更新與在使用者介面中按一下「更新」按鈕所執行的動作相同。

語法

iLogicVb.UpdateWhenDone = True

RuleParametersOutput

如果您的規則變更了任何參數值,則此函數會將新規則值套用至 Inventor 模型。如果不使用此函數,則在規則執行完成之後才會套用這些值。如果您必須使用 DocumentUpdate 執行更新,請使用此函數。如果您要使用 iLogicVb.RunRule 函數也請使用此函數,以便其他規則取得參數的新值。

語法

RuleParametersOutput()

DocumentUpdate

在目前文件 (規則所在的文件) 中執行立即更新,並更新顯示。如果您需要重建幾何圖形 (例如,您要使用 iProperties.Mass 計算質量),請使用此函數。如果該規則會觸發其他規則 (透過變更參數),請在「編輯規則」對話方塊中為此規則啟用「立即觸發從屬規則」選項。此選項可確保在您執行更新時,其他規則已執行完成。

語法

InventorVb.DocumentUpdate()

DocumentUpdate(False)

在目前文件 (規則所在的文件) 中執行立即更新,但不更新文件顯示。函數 InventorVb.DocumentUpdate 會更新顯示及模型。如果您不想更新顯示,請改為使用此函數。

語法

InventorVb.DocumentUpdate(False)

僅更新顯示

此 Inventor API 函數將僅更新顯示,而不會更新模型。

語法

ThisApplication.ActiveView.Update()

CheckParameters

驗證參數值,但不變更任何值。

針對以下情況使用此函數:

假設您的參數被連結至基準零件,而在該基準零件中,這些參數又被連結至外部工作表。可以在工作表中變更參數值並儲存工作表,而不讓這些變更展示在主零件中。請先在主零件內的規則中使用此函數,然後再使用 GoExcel 變更工作表中的值。此函數可確保載入基準零件 (在背景中),並確保變更擴展至組合的主零件。

語法

InventorVb.CheckParameters("")

File Save As

使用新檔名及新副檔名 (可選) 儲存文件。

語法

ThisDoc.Document.SaveAs(NewFileNameAndExtension , True)

True

設定為 True 以執行「將複本儲存成」作業,或者設定為 False 以執行「另存」作業。