Verwenden Sie Dokumentfunktionen zum Zugriff auf ein Inventor-Bauteil-, Baugruppen- oder Zeichnungsdokument.
Mithilfe von Dokumentfunktionen können Sie Aufgaben wie z. B. das Abrufen eines Dateinamens und Aktualisieren des Modells ausführen.
ThisDoc bezieht sich in Dokumentfunktionen auf das Inventor-Dokument, in das eine Regel geschrieben wird. Meistens ist es das aktive Dokument. Es kann sich aber auch auf ein Bauteil in einer Baugruppe beziehen. Über ThisDoc erhalten Sie unabhängig vom Speicherort der Regel Zugriff auf das Dokument.
Erweitern Sie zum Öffnen der Dokumentfunktionen im Bereich Snippets des iLogic-Dialogfelds Regel bearbeiten auf der Registerkarte System den Knoten Dokument.
Gibt den Dokumentpfad (Ordner) als Zeichenfolge aus.
Syntax
ThisDoc.Path
Gibt den Dateinamen des Dokuments an.
Syntax
ThisDoc.FileName(False)
Die Dateierweiterung wird beim Argument False nicht berücksichtigt. Wählen Sie das Argument True, wenn die Dateierweiterung berücksichtigt werden soll.
Gibt den Pfad und den Dateinamen des Dokuments aus.
Syntax
ThisDoc.PathAndFileName(False)
Die Dateierweiterung wird beim Argument False nicht berücksichtigt. Wählen Sie True in Klammern, wenn die Dateierweiterung berücksichtigt werden soll.
Erstellt einen Dateinamen aus dem Dateinamen des Dokuments und einer geänderten Erweiterung.
Syntax
changedName = ThisDoc.ChangeExtension(“.new”)
Gibt den Pfad (Ordner) des aktiven Inventor-Projektarbeitsbereichs aus. Wenn kein Arbeitsbereich definiert ist, gibt diese Funktion eine leere Zeichenfolge aus (eine Zeichenfolge ohne Zeichen und der Länge = Null).
Syntax
ThisDoc.WorkspacePath()
Öffnet anhand des angegebenen Pfads und Dateinamens (einschließlich der Dateierweiterung) eine Datei. Wenn Sie eine Datendatei angeben, wird sie in der entsprechenden Anwendung geöffnet. Wenn Sie eine ausführbare Datei (EXE) angeben, wird das Programm ausgeführt. Wenn Sie keinen vollständigen Pfad angeben, wird nach der Datei im selben Ordner gesucht, in dem sich das Inventor-Dokument befindet. Sie können auch einen relativen Namen und Pfad des Dokuments angeben.
Syntax
ThisDoc.Launch(“path\file.ext”)
Speichert das aktuell aktive Dokument. Diese Funktion kann nicht in einer Regel verwendet werden, die durch Änderung eines Parameters ausgelöst wird.
Syntax
ThisDoc.Save
Aktualisiert das Dokument, in dem sich die Regel befindet, nachdem die Regel (und alle durch sie ausgelösten Regeln) ausgeführt wurde. Diese Aktualisierung kann auch durch Klicken auf die Schaltfläche Aktualisieren auf der Benutzeroberfläche durchgeführt werden.
Syntax
iLogicVb.UpdateWhenDone = True
Wenn durch die Regel Parameterwerte geändert wurden, werden durch diese Funktion neue Regelwerte für das Inventor-Modell verwendet. Wenn diese Funktion nicht verwendet wird, werden die Werte erst angewendet, nachdem die Regel ausgeführt wurde. Verwenden Sie diese Funktion, wenn Sie eine Aktualisierung mithilfe von DocumentUpdate ausführen müssen. Diese Funktion muss auch dann verwendet werden, wenn Sie die Funktion iLogicVb.RunRule verwenden. Auf diese Weise können die neuen Parameterwerte durch die andere Regel abgerufen werden.
Syntax
RuleParametersOutput()
Führt eine sofortige Aktualisierung im aktuellen Dokument (das Dokument, in dem sich die Regel befindet) aus, und aktualisiert die Anzeige Verwenden Sie diese Funktion, wenn die Geometrie neu erstellt werden soll (z. B., wenn Sie die Masse mithilfe von iProperties.Mass berechnen). Wenn die Regel andere Regeln auslöst (durch Ändern der Parameter), aktivieren Sie im Dialogfeld Regel bearbeiten die Option Abhängige Regeln sofort auslösen für diese Regel. Durch diese Option wird sichergestellt, dass die anderen Regeln ausgeführt werden, bevor Sie die Aktualisierung durchführen.
Syntax
InventorVb.DocumentUpdate()
Führt eine sofortige Aktualisierung im aktuellen Dokument (das Dokument, in dem sich die Regel befindet) aus, ohne die Dokumentanzeige zu aktualisieren Die Funktion InventorVb.DocumentUpdate aktualisiert die Anzeige als auch das Modell. Wenn die Anzeige nicht aktualisiert werden soll, verwenden Sie diese Funktion.
Syntax
InventorVb.DocumentUpdate(False)
Diese Inventor-API-Funktion aktualisiert nur die Anzeige, nicht das Modell.
Syntax
ThisApplication.ActiveView.Update()
Überprüft Parameterwerte, ohne einen Wert zu ändern.
Verwenden Sie diese Funktion in beispielsweise folgenden Situationen:
Ihre Parameter sind mit einem Basisbauteil verknüpft, wo sie mit einer externen Tabelle verknüpft sind. Sie haben die Möglichkeit, die Parameterwerte in der Tabelle zu ändern und zu speichern, ohne dass diese Änderungen im Hauptbauteil angezeigt werden. Verwenden Sie diese Funktion in einer Regel innerhalb des Hauptbauteils, bevor Sie GoExcel verwenden, um die Werte in der Tabelle zu ändern. Durch diese Funktion wird sichergestellt, dass das Basisteil geladen wird (im Hintergrund) und das Änderungen auf das Hauptbauteil in der Baugruppe übertragen werden.
Syntax
InventorVb.CheckParameters(“”)
Speichert das Dokument unter einem neuen Dateinamen und optional mit einer neuen Erweiterung.
Syntax
ThisDoc.Document.SaveAs(NewFileNameAndExtension , True)
True
Setzen Sie den Wert auf True, um den Vorgang Kopie speichern unter auszuführen. Legen Sie den Wert auf False fest, um den Vorgang Speichern unter durchzuführen.