Die Funktionen DOCU-REGISTER-TR-GROUP und DOCU-REGISTER-TR-TYPE und ihre Optionen
Die Funktionen DOCU-REGISTER-TR-GROUP und DOCU-REGISTER-TR-TYPE definieren Gruppen von Textbezugsarten. Textbezüge sind besonders nützlich in angepassten Rahmen.
Textbezüge werden mit LISP-Funktionen entweder in der Datei am_customize oder in einer separaten Datei definiert, die in Creo Elements/Direct Annotation geladen wird. Um eine Datei in Creo Elements/Direct Annotation zu laden, geben Sie (load "path / filename") in der Eingabezeile ein, wobei path / filename die Datei und ihr Pfad mit gültigen Textbezugsdefinitionen ist.
Sie können in die Eingabezeile auch eine DOCU-REGISTER-TR-GROUP- oder DOCU-REGISTER-TR-TYPE-Funktion eingeben. Für neue Textbezugsgruppen und -arten müssen eindeutige Namen vergeben werden. Zum Registrieren einer neuen Gruppe oder Art mit einem bereits vorhandenen Namen muss zunächst die Registrierung der alten Einheit aufgehoben werden.
Die Textbezugsfunktionen sind nachstehend aufgeführt. Nähere Informationen erhalten Sie unter den jeweiligen Links. Ein
Beispiel finden Sie dort ebenfalls.
Die Funktion DOCU-REGISTER-TR-GROUP registriert eine neue Gruppe von Textbezugsarten. Sie müssen einen Namen für die neue Gruppe vergeben, der auf der Benutzeroberfläche angezeigt wird, sowie einen Aktualisierungsbereich (GLOBAL oder SHEET).
Syntax
(DOCU-REGISTER-TR-GROUP "New group name" "Group update scope")
Funktion DOCU-UNREGISTER-TR-GROUP
Die Funktion DOCU-UNREGISTER-TR-GROUP hebt die Registrierung einer zuvor definierten Textbezugsgruppe auf. Sie können einen vorhandenen Gruppennamen (in doppelten Anführungszeichen) angeben.
Syntax
(DOCU-UNREGISTER-TR-GROUP "Group name")
Funktion DOCU-REGISTER-TR-TYPE
Die Funktion DOCU-REGISTER-TR-TYPE registriert eine neue Textbezugsart. Sie müssen die folgenden Angaben in die Definition der Art aufnehmen:
• Der Name der Gruppe, die die neue Textbezugsart besitzt.
• Der eindeutige Name der neuen Textbezugsart. Dieser Name wird auf der Benutzeroberfläche angezeigt.
• Der Anfangswert des Textbezugs (z. B. ??? oder NIL).
• Die Aktualisierungsfunktion, die zum Aktualisieren der Textbezugsart aufgerufen wird. Stellen Sie dem Funktionsnamen einen Apostroph voran.
Syntax
(DOCU-REGISTER-TR-TYPE "Owning group name" "New text reference type name" "Initial value" 'Update function)
Funktion DOCU-UNREGISTER-TR-TYPE
Die Funktion DOCU-UNREGISTER-TR-TYPE hebt die Registrierung einer zuvor definierten Textbezugsart auf. Beziehen Sie den Namen der Gruppe ein, die die Art enthält, sowie den Namen der Textbezugsart selbst. Beide Namen müssen zwischen doppelte Anführungszeichen gesetzt werden.
Die Funktion DOCU-UPDATE-TR-GROUP aktualisiert eine definierte Textbezugsgruppe. Der Gruppenname muss zwischen doppelte Anführungszeichen gesetzt werden. Mit dieser Funktion kann eine Gruppe aus einem LISP-Programm oder -dialog aktualisiert werden.
Syntax
(DOCU-UPDATE-TR-GROUP "Group name")
Beispiel
Nachstehend finden Sie ein Beispiel für eine Textbezugsregistrierung:
Die erste Funktion oben erstellt eine Textbezugsgruppe mit dem Namen "My_group_name" mit globalem Aktualisierungsbereich. Die zweite Funktion erstellt eine Textbezugsart mit dem Namen "MY_TYPE" in der Textbezugsgruppe "My_group_name". Der aktuelle (Anfangs-) Wert ist "???". Die aktualisierten Werte werden von "my-value-update-function" bereitgestellt.
Funktion DOCU-REGISTER-SPECIAL-CHAR und Optionen
Die Funktion DOCU-REGISTER-SPECIAL-CHAR registriert Sonderzeichen zur Verwendung in der Tabelle Sonderzeichen von Creo Elements/Direct Annotation. Es kann jedes beliebige Zeichen der Schriftarten hp_symbols und hp_symbols2 registriert werden. Darüber hinaus lassen sich in die Tabelle Sonderzeichen auch vordefinierte Abbildungen (Dateien im PIXMAP-Format) aufnehmen.
Die Registrierungsfunktionen können in der Datei am_customize oder in einer separaten Datei enthalten sein. Um eine Datei in Creo Elements/Direct Annotation zu laden, geben Sie (load "path / filename") in der Eingabezeile ein, wobei path / filename die Datei und ihr Pfad mit gültigen DOCU-REGISTER-SPECIAL-CHAR-Funktionen ist.
Sie können in die Eingabezeile auch eine DOCU-REGISTER-SPECIAL-CHAR-Funktion eingeben. Für das Zeichen "Metaname" müssen eindeutige Namen verwendet werden.
Die Funktion DOCU-REGISTER-SPECIAL-CHAR, ihre Optionen und die zugehörigen Funktionen sind nachstehend aufgeführt. Nähere Informationen erhalten Sie unter den jeweiligen Links. Ein
Beispiel finden Sie nachstehend.
:CHAR-CODE legt die Codenummer des Sonderzeichens in der ausgewählten Schriftart (:hp_symbols oder :hp_symbols2) fest.
Syntax
-->(:CHAR-CODE)----->|code number|------->
Option FONT-CODE
:FONT-CODE legt die Schriftart fest, die das Sonderzeichen enthält, das registriert werden soll. Die möglichen Schriftarten sind :hp_symbols und :hp_symbols2.
Syntax
-->(:FONT-CODE)----->|:hp_symbols or :hp_symbols2|------->
Option META-NAME
:META-NAME legt den Namen fest, unter dem das Sonderzeichen in der Tabelle Sonderzeichen und im Texteditor bekannt ist. Der Name muss eindeutig sein. Heben Sie die Registrierung einer früheren Instanz eines Metanamens auf, um eine erneute Registrierung vorzunehmen. Der Metaname wird zwischen spitzen Klammern angezeigt, z. B. <Diameter>.
Syntax
-->(:META-NAME)----->|"metaname"|------->
Option PIXMAP-FILE
:PIXMAP-FILE legt eine Pixmap- oder Bitmap-Datei fest, die in den Eintrag des Sonderzeichens in der Tabelle Sonderzeichen einbezogen werden soll. Die Datei kann mit jedem beliebigen Pixmap-Standardeditor erzeugt werden, z. B. XPaint. Die empfohlene Größe für eine Pixmap beträgt 42 x 24 Pixel.
Syntax
-->(:PIXMAP-FILE)----->|"filename"|------->
Funktion DOCU-UNREGISTER-SPECIAL-CHAR-ALL
Die Funktion DOCU-UNREGISTER-SPECIAL-CHAR-ALL hebt die Registrierung aller zuvor definierten Sonderzeichen auf. Verwenden Sie diese Funktion in der Datei am_customize (oder in einer separaten Datei) vor Instanzen von DOCU-REGISTER-SPECIAL-CHAR, wenn die Standardzeichen nicht zur Verfügung stehen sollen.
Funktion DOCU-UNREGISTER-SPECIAL-CHAR
Die Funktion DOCU-UNREGISTER-SPECIAL-CHAR hebt die Registrierung eines zuvor definierten Sonderzeichens auf. Sie können einen vorhandenen Zeichen-Metanamen (in doppelten Anführungszeichen) angeben.
Syntax
(DOCU-UNREGISTER-SPECIAL-CHAR "metaname")
Beispiel
Nachstehend finden Sie ein Beispiel für eine Sonderzeichenregistrierung: