Utilizzare le funzioni documento per accedere al documento di disegno, di assieme o di parte di Inventor. Le funzioni documento consentono di eseguire attività quali l'ottenimento del nome file e l'aggiornamento del modello.
Nelle funzioni documento, ThisDoc fa riferimento al documento Autodesk Inventor in cui viene scritta la regola. Si tratta spesso del documento attivo, ma può anche essere una parte all'interno di un assieme. Ogni volta che la regola viene memorizzata, ThisDoc fornisce accesso a quel documento.
Per accedere alle funzioni documento, espandere il nodo Documento nella scheda Sistema dell'area Frammenti.
Consente di restituire il percorso del documento (nome cartella) come una stringa di testo.
Sintassi
ThisDoc.Path
Consente di restituire il nome file del documento.
Sintassi
ThisDoc.FileName(False)
L'estensione del file non viene inclusa quando False viene fornito come argomento. Se è necessaria l'estensione del file, sostituire True come argomento.
Restituisce il percorso e il nome file del documento.
Sintassi
ThisDoc.PathAndFileName(False)
L'estensione del file non viene inclusa quando False viene fornito come argomento. Per includere l'estensione di file, sostituire True nelle parentesi.
Consente di creare un nome file utilizzando il nome file del documento e un'estensione modificata.
Sintassi
changedName = ThisDoc.ChangeExtension(“.new”)
Restituisce il percorso (nome cartella) dell'area di lavoro del progetto attivo di Autodesk Inventor. Se non è definita alcuna area di lavoro, questa funzione restituisce una stringa vuota (una stringa senza caratteri, con lunghezza zero).
Sintassi
ThisDoc.WorkspacePath()
Consente di aprire un file in base al percorso e al nome file (inclusa l'estensione) forniti. Se viene specificato un file di dati, verrà aperto nell'applicazione di origine. Se viene specificato un file eseguibile (.exe), verrà eseguito il programma. Se non viene specificato un percorso completo, iLogic cerca il file nella stessa cartella del documento di Inventor. È inoltre possibile specificare un nome e un percorso relativo per la cartella del documento.
Sintassi
ThisDoc.Launch(“path\file.ext”)
Consente di salvare il documento attivo. Questa funzione non è utilizzabile in una regola attivata mediante un evento di modifica parametri.
Sintassi
ThisDoc.Save
Consente di aggiornare il documento in cui si trova la regola, dopo il completamento dell'esecuzione della regola (e di qualsiasi regola da essa attivata). Questo aggiornamento coincide con quello ottenuto mediante il pulsante Aggiorna nell'interfaccia utente.
Sintassi
iLogicVb.UpdateWhenDone = True
Se la regola modifica qualsiasi valore di parametro, questa funzione consente di applicare nuovi valori regola al modello di Inventor. Se questa funzione non viene utilizzata, i valori non vengono applicati fino a quando la regola non ha terminato l'esecuzione. Utilizzare questa funzione se è necessario eseguire un aggiornamento utilizzando DocumentUpdate. È inoltre possibile utilizzare questa funzione se si utilizza la funzione iLogicVb.RunRule, in modo che i nuovi valori dei parametri siano disponibili per l'altra regola.
Sintassi
RuleParametersOutput()
Esegue l'aggiornamento immediato nel documento corrente (il documento in cui si trova la regola) e aggiorna la visualizzazione. Utilizzare questa funzione se si desidera ricreare la geometria (ad esempio, se si calcola la massa utilizzando iProperties.Mass). Se tramite la regola vengono attivate altre regole (modificando i parametri), abilitare l'opzione Attiva regole dipendenti immediatamente per la regola nella finestra di dialogo Modifica regola. Questa opzione garantisce che sia conclusa l'esecuzione delle altre regole quando si esegue l'aggiornamento.
Sintassi
InventorVb.DocumentUpdate()
Consente di eseguire un aggiornamento immediato nel documento corrente (il documento in cui si trova la regola) senza aggiornare la visualizzazione del documento. La funzione InventorVb.DocumentUpdate consente di aggiornare la visualizzazione oltre al modello. Se non si desidera aggiornare la visualizzazione, utilizzare questa funzione.
Sintassi
InventorVb.DocumentUpdate(False)
Questa funzione API di Inventor consente di aggiornare solo la visualizzazione e non il modello.
Sintassi
ThisApplication.ActiveView.Update()
Consente di verificare dei valori di parametro, ma non di modificare alcun valore.
Utilizzare questa funzione per le seguenti situazioni:
Si supponga che i parametri siano collegati ad una parte di base e dalla parte di base ad un foglio di calcolo esterno. È possibile modificare i valori di parametro nel foglio di calcolo e salvarlo, senza che le modifiche siano visualizzate nella parte principale. Utilizzare questa funzione in una regola all'interno della parte principale prima di utilizzare GoExcel per modificare i valori nel foglio di calcolo. Tramite questa funzione la parte di base viene caricata (in background) e le modifiche vengono propagate alla parte principale dell'assieme.
Sintassi
InventorVb.CheckParameters(“”)
Consente di salvare il documento con un nuovo nome file e, se lo si desidera, con una nuova estensione.
Sintassi
ThisDoc.Document.SaveAs(NewFileNameAndExtension , True)
Vero
Impostare su True per eseguire un'operazione Salva copia con nome, o impostare su False per eseguire un'operazione Salva con nome.