Funkce dokumentu v modulu iLogic

Funkce dokumentu používejte k zpřístupnění dokumentu součásti, sestavy nebo výkresu aplikace Inventor. Funkce dokumentu vám umožňují provádět úkoly, například získávání názvu souboru a aktualizování modelu.

Ve funkcích dokumentu odkazuje položka ThisDoc na dokument aplikace Autodesk Inventor, ve kterém bylo pravidlo zapsáno. Je to často aktivní dokument, ale může to být také součást v sestavě. Položka ThisDoc umožňuje přístup k tomuto dokumentu bez ohledu na to, kde je pravidlo uloženo.

Pro zpřístupnění funkcí dokumentu rozbalte položku Dokument na kartě Systém v oblasti Fragmenty.

Path

Výsledkem je cesta k dokumentu (názvu složky) jako textový řetězec.

Syntaxe

ThisDoc.Path

FileName

Výsledkem je název souboru dokumentu.

Syntaxe

ThisDoc.FileName(False)

Přípona souboru není přidána, když se hodnota False používá jako argument. Jestliže příponu souboru chcete, použijte jako argument hodnotu True.

PathAndFileName

Výsledkem je cesta a název souboru dokumentu.

Syntaxe

ThisDoc.PathAndFileName(False)

Přípona souboru není přidána, když se hodnota False používá jako argument. Pokud má být přípona souboru zahrnuta, použijte v závorkách hodnotu True.

ChangeExtension

Vytváří název souboru pomocí názvu souboru dokumentu a změněné přípony.

Syntaxe

changedName = ThisDoc.ChangeExtension(“.new”)

WorkspacePath

Výsledkem je cesta (název složky) aktivního pracovního prostoru projektu aplikace Autodesk Inventor. Jestliže není definován žádný pracovní prostor, tato funkce vrací prázdný řetězec (řetězec bez znaků o délce = nula).

Syntaxe

ThisDoc.WorkspacePath()

Launch

Spouští soubor na základě poskytnuté cesty a názvu souboru (včetně přípony). Jestliže je specifikován datový soubor, otevírá se ve své původní aplikaci. Jestliže je specifikován spustitelný soubor (.exe), spouští program. Jestliže nezadáte kompletní cestu, modul iLogic vyhledává soubor ve stejné složce, ve které je dokument aplikace Inventor. Také můžete specifikovat relativní název a cestu k složce dokumentu.

Syntaxe

ThisDoc.Launch(“path\file.ext”)

Save

Ukládá aktuálně aktivní dokument. Tato funkce nefunguje v pravidle spouštěném událostí změny parametru.

Syntaxe

ThisDoc.Save

UpdateWhenDone

Aktualizuje dokument, ve kterém je pravidlo, po dokončení činnosti pravidla (a jakéhokoliv pravidla, které se spouští). Tato aktualizace je stejná jako kliknutí na tlačítko Aktualizovat v uživatelském rozhraní.

Syntaxe

iLogicVb.UpdateWhenDone = True

RuleParametersOutput

Jestliže pravidlo změnilo jakékoliv hodnoty parametrů, tato funkce používá pro model aplikace Inventor nové hodnoty pravidla. Jestliže není tato funkce použita, hodnoty nejsou použity, dokud pravidlo neukončí svou činnost. Použijte tuto funkci, jestliže je nutné provést aktualizaci pomocí funkce DocumentUpdate. Tuto funkci použijte také v případě, že používáte funkci iLogicVb.RunRule, aby druhé pravidlo získalo nové hodnoty parametrů.

Syntaxe

RuleParametersOutput()

DocumentUpdate

Provádí okamžitou aktualizaci v aktuálním dokumentu (dokumentu, ve kterém je pravidlo) a aktualizuje zobrazení. Použijte tuto funkci, jestliže chcete přepracovat geometrii (například provádíte výpočet hmotnosti pomocí funkce iProperties.Mass). Jestliže pravidlo spouští jiná pravidla (změnou parametrů), povolte pro toto pravidlo možnost Spustit závislá pravidla okamžitě v dialogu Upravit pravidlo. Tato možnost zajišťuje, že ostatní pravidla ukončila činnost, když provádíte aktualizaci.

Syntaxe

InventorVb.DocumentUpdate()

DocumentUpdate(False)

Provádí okamžitou aktualizaci v aktuálním dokumentu (dokumentu, ve kterém je pravidlo) bez aktualizace zobrazení dokumentu. Funkce InventorVb.DocumentUpdate aktualizuje zobrazení a také model. Jestliže nechcete aktualizovat zobrazení, použijte místo ní tuto funkci.

Syntaxe

InventorVb.DocumentUpdate(False)

Aktualizace pouze zobrazení

Tato funkce API aplikace Inventor aktualizuje pouze zobrazení a neaktualizuje model.

Syntaxe

ThisApplication.ActiveView.Update()

CheckParameters

Ověřuje hodnoty parametrů, ale neprovádí změny žádných hodnot.

Použijte tuto funkci v následujících situacích:

Předpokládejme, že jsou parametry připojeny k základní součásti a v základní součásti jsou připojeny k externímu tabulkovému procesoru. Lze provést změny hodnot parametrů v tabulkovém procesoru a uložit je bez zobrazení těchto změn v hlavní součásti. Použijte tuto funkci v pravidle v hlavní součásti před použitím funkce GoExcel ke změně hodnot v tabulce. Tato funkce zajišťuje, že základní součást je načtena (na pozadí) a že se změny šíří v hlavní součásti sestavy.

Syntaxe

InventorVb.CheckParameters(“”)

File Save As

Ukládá dokument pod novým názvem souboru a volitelně s novou příponou.

Syntaxe

ThisDoc.Document.SaveAs(NewFileNameAndExtension , True)

True

Nastavením na hodnotu True provedete operaci Uložit kopii jako, zatímco nastavením na hodnotu False provedete operaci Uložit jako.