Utilisez les fonctions Document pour accéder au fichier pièce, ensemble ou dessin Inventor. Les fonctions Document vous permettent d'effectuer des tâches telles que l'obtention du nom du fichier et la mise à jour du modèle.
Dans les fonctions Document, ThisDoc fait référence au document Autodesk Inventor dans laquelle la règle est enregistrée. Il s'agit souvent du document actif, mais il peut également s'agir d'une pièce dans un ensemble. Quel que soit l'emplacement dans lequel la règle est stockée, ThisDoc vous donne accès à ce document.
Pour accéder aux fonctions Document, développez le noeud Document sous l'onglet Système de la zone Extraits de code.
Renvoie le chemin d'accès au document (nom de dossier) sous la forme d'une chaîne de texte.
Syntaxe
ThisDoc.Path
Renvoie le nom de fichier du document.
Syntaxe
ThisDoc.FileName(False)
L'extension de fichier n'est pas incluse lorsque False est fourni comme argument. Si vous souhaitez afficher l'extension du fichier, choisissez True comme argument de substitution.
Renvoie le chemin et le nom de fichier du document.
Syntaxe
ThisDoc.PathAndFileName(False)
L'extension de fichier n'est pas incluse lorsque False est fourni comme argument. Pour inclure l'extension de fichier, insérez True entre les parenthèses.
Crée un nom de fichier en utilisant le nom de fichier du document et une nouvelle extension.
Syntaxe
changedName = ThisDoc.ChangeExtension(“.new”)
Renvoie le chemin d'accès (nom de dossier) à l'espace de travail du projet Autodesk Inventor actif. Si aucun espace de travail n'est défini, cette fonction renvoie une chaîne vide (une chaîne sans caractères, de longueur égale à 0).
Syntaxe
ThisDoc.WorkspacePath()
Ouvre un fichier basé sur le chemin d'accès et le nom de fichier (y compris l'extension) fournis. Si un fichier de données est spécifié, il s'ouvre dans son application d'origine. Si un fichier exécutable (.exe) est spécifié, il exécute le programme. Si vous ne spécifiez pas le chemin d'accès complet, iLogic recherche le fichier dans le dossier qui contient le document Inventor. Vous pouvez également spécifier un nom et un chemin relatif pour le dossier du document.
Syntaxe
ThisDoc.Launch(“path\file.ext”)
Enregistre le document actif. Cette fonction ne sert pas dans une règle déclenchée par un événement de type changement de paramètre.
Syntaxe
ThisDoc.Save
Met à jour le document contenant la règle après l'exécution de cette dernière (et de toute autre règle qu'elle déclenche). Le résultat est le même que lorsque vous cliquez sur le bouton Mettre à jour dans l'interface utilisateur.
Syntaxe
iLogicVb.UpdateWhenDone = True
Si votre règle a modifié des valeurs de paramètre, cette fonction applique de nouvelles valeurs de règle pour le modèle Inventor. Si cette fonction n'est pas utilisée, les valeurs ne sont pas appliquées tant que la règle n'est pas terminée. Utilisez cette fonction si vous devez effectuer une mise à jour à l'aide de DocumentUpdate. Utilisez également cette fonction si vous utilisez la fonction iLogicVb.RunRule, de sorte que l'autre règle puisse extraire les nouvelles valeurs des paramètres.
Syntaxe
RuleParametersOutput()
Effectue une mise à jour immédiatement dans le document actif (le document qui contient la règle) et met à jour l'affichage. Utilisez cette fonction si vous avez besoin que la géométrie soit recréée (par exemple, si vous calculez les volumes à l'aide de iProperties.Mass). Si la règle déclenche d'autres règles (en modifiant les paramètres), activer l'option Exécuter les règles dépendantes immédiatement dans la boîte de dialogue Modifier la règle. Cette option permet de s'assurer que les autres règles ont terminé avant la mise à jour.
Syntaxe
InventorVb.DocumentUpdate()
Effectue une mise à jour immédiatement dans le document actif (le document qui contient la règle) sans mettre à jour l'affichage. La fonction InventorVb.DocumentUpdate met à jour l'affichage ainsi que le modèle. Si vous ne souhaitez pas mettre à jour l'affichage, utilisez cette fonction à la place.
Syntaxe
InventorVb.DocumentUpdate(False)
Cette fonction API Inventor met à jour l'affichage, mais pas le modèle.
Syntaxe
ThisApplication.ActiveView.Update()
Vérifie les valeurs des paramètres, mais ne les change pas.
Utilisez cette fonction dans les cas suivants :
Supposons que vos paramètres soient liés à une pièce de base, puis liés à une feuille de calcul externe dans la pièce de base. Il est possible de modifier les valeurs de paramètres dans la feuille de calcul et l'enregistrer sans ces modifications affichant dans la pièce principale. Utilisez cette fonction dans une règle de la pièce principale avant d'utiliser GoExcel pour modifier les valeurs dans la feuille de calcul. Cette fonction permet de s'assurer que la pièce de base est chargée (dans l'arrière-plan) et que les modifications sont propagées à la pièce principale de l'ensemble.
Syntaxe
InventorVb.CheckParameters(“”)
Enregistre le document sous un nouveau nom de fichier et, éventuellement, sous une nouvelle extension.
Syntaxe
ThisDoc.Document.SaveAs(NewFileNameAndExtension , True)
True
Définie sur True, permet d'effectuer une opération Enregistrer la copie sous et définie sur False, d'effectuer une opération Enregistrer sous.