Macro Language Reference > PIs > Text > <?contextup>
  
<?contextup>
Description
This command will add any context matches declared in a named context selection control stream to the list of already active context matches for an XML stream. For example, the command <?contextup “ExtraContexts”> will add context matches from the ExtraContexts stream to the context control stream already associated with the XML stream.
In the case where multiple contexts are found with the same priority, contexts in the most recently added set will be chosen over any existing ones. Otherwise, normal priority selection rules will apply.
Up to ten additions can be made to the context list via <?contextup>.
To remove a set of contexts from the current list, use the associated command <?contextdown>.
Syntax
<?contextup group:n? '+' '-' ctrl_stream:t>
group
(optional) Add the contexts to one of five numbered context groups, numbered 0–4.
When PTC ALD checks the available list of contexts, it will return the single most specific context from each different group specified, using normal priority rules.
The set of contexts assigned to the stream (if present) is considered group 0. If adding to this group results in multiple contexts being found, each result will be processed in the group number order, with any results from group 4 first, and group 0 last. This allows up to 5 different matches to be processed at the same time.
If a group number is not specified in the command, the additional contexts specified in that instruction will be added to group 0.
The most applicable context from each group is applied:
• onEnter tags are applied in the order of group 4 to group 0.
• onExit tags are applied in the order of group 0 to group 4.
+
(optional) Ignore any previously specified contexts and do not check for matches.
-
(optional) Limit other contexts in the same group instead of blocking other groups.
ctrl_stream
The name of the context selection stream that contains the context declarations
Must be specified in double quotes
Related Links