DocSetScript¶
DocSetScript kopiert ein Skript in ein UniPlot-Dokument, dass beim Öffnen der Datei ausgeführt wird.
-
bool = DocSetScript(hDoc, ssScript)
Returnwert
bool ist TRUE (1), wenn die Funktion erfolgreich war und sonst FALSE (0).
Parameter
-
hDoc
hDoc ist die Zugriffsnummer des mit DocCreate erzeugten Dokuments.
-
ssScript
ssScript ist ein Text mit UniScript-Anweisungen.
Kommentar
Mit dieser Funktion kann ein Text mit UniScript-Anweisungen und Funktionen in ein UniPlot-Dokument kopiert werden.
Wird eine UniPlot-Datei mit UniPlot geöffnet, z. B. durch Doppelklicken im
Windows Explorer, durch den Befehl Datei=>Öffnen oder durch Auswahl der
.ipw
- oder .ipz
-Datei aus der Liste der zuletzt geöffneten Dateien, wird
der mit dieser Funktion gesetzte Code ausgeführt.
Es werden folgende Aktionen durchgeführt:
- Die Datei wird mit DocCreate geöffnet.
- Es wird das Skript mit DocGetScript geladen.
- Es wird eine Sicherheitsabfrage durchgeführt, ob das Skript geladen und ausgeführt werden soll. Bestätigen Sie die Ausführung nur, wenn das UniPlot-Dokument aus einer sicheren Quelle stammt, Sie die Datei also selbst erzeugt haben oder Ihnen der Ersteller der Datei bekannt ist. Ansonsten könnte der Code unerwünschte Aktionen ausführen (Makro-Viren).
- Das Skript wird mit evalp ausgeführt. Falls das Skript einen Fehler enthält, wird ein Meldungsfenster ausgegeben.
Unter Objekt bearbeiten=>Eigenschaften wird gezeigt, wie ein Skript an ein Textfeld oder eine Schaltfläche gebunden werden kann.
Sicherheit: Die Funktion zum Ausführen des Codes, verwendet die Funktion:
nSecurity = GetProfileInt_Policy("Settings", "macro-security", 0);
zur Abfrage der Sicherheitseinstellungen. Folgende Werte werden verwendet:
- 0 - question: Defaulteinstellung. Es wird ein Meldungsfenster beim Öffnen der Datei ausgegeben. Sie können entscheiden ob die Skripte ausgeführt werden, oder ob die UniPlot-Datei ohne Ausführung des Skriptes geöffnet wird.
- 1 - never: Die Skripte werden beim Öffnen von UniPlot-Dateien niemals ausgeführt. Es wird eine Log-Message ausgegeben, wenn eine UniPlot-Datei Makros enthält.
- 2 - always: Führt Macros immer ohne Rückfrage aus. Verwenden Sie diese Einstellung nur, wenn Sie UniPlot-Dokumente ausschließlich aus sicheren Quellen verwenden.
History
Version | Beschreibung |
---|---|
R2012.2 (5.40.2) | Neu. |
Siehe auch
id-1433913