Commande: HA

HA command description

Description: This command calls a reference hidden in the text. This reference uses the [hp] command to resolve (if type=0). The [hp] command (Insert Reference) must be in the same document when the reference is placed in the text. The page number is the number of the page where the reference is located. The page number is the actual page number displayed on the bottom left of the QuarkXPress document. If the user has modified the page numbers, you will find here the actual number of the page.

Syntax: [ HA = Type ; Reference ]

Type Integer	•	Indicates the type of the reference call. The meaning of the second parameter is related to the type of reference call.\r \t0 -> Text reference. In this case, the second parameter is the reference number defined with the [hp] command. \t1-> Block reference. In this case, the second parameter is the block number defined with the [bn] or [bi] commands when the block was created. \r

Reference Long Integer	•	Unique number. 0 < numeric value < 0x7FFFFFFF in the case of a text reference ([hp] command) or numeric value > 2000 in the case of a block reference. The reference is placed in the internal tables created by PageMakeUp.

Note: This command implies permanent references for the blocks, so you must use block numbers > 2000. In the present version of PageMakeUp, references are hidden for the QuarkXPress user, but, however, the user may delete them. This may cause layout problems. The call and the insertion of the reference must be in the same QuarkXPress document for a correct operation of the crossreferences. Remember to place the [hu] command at the end of the TCL file to update the crossreferences.

Example: [hp=2841]............ This command inserts in the text the hidden reference '2841'. The second command [ha=0; 2841], placed before or after in the text, will insert in the text the number of the page in which the reference occurs (defined with the [hp=2841]). [ha=1; 2005] In this example, the program looks for the page in which the block 2005 is located and inserts this page number at the [ha] command position.

See also: [hp] Insert Reference, [hu] Solve References

The • sign indicates a mandatory parameter