FinalTarget
«FinalTarget([template])»
Position | Parameter | Description |
---|---|---|
1 | Template (optional) | The template to expand when the target was reached |
Adds a final target for text fields to a template expansion. Text fields can have two different kinds of targets: a normal target created through the Target Text Command, and a final target created through this Text Command. Normal targets are cleared any time a new text expansion occurs that includes a text field, and are useful when a template might be called (nested) one or more times from another template (if nested multiple times, only the last Target would survive, however if a FinalTarget Text Command was encountered during this expansion, it would override any previously encountered Targets). While normal targets can be set and cleared multiple times during a single template expansion, a final target is only cleared when another FinalTarget Text Command is encountered, or after expansion if the last target is reached and the Enter key is pressed, or when a brand new text expansion occurs that contains this FinalTarget Text Command. Only one FinalTarget is allowed per document at any time.