Updated & Reviewed November 2010

When multiple XTREE controls are in simultaneous use, specifies which one (range is 0 to 31) to use for this call. If XTR_OPCODE = XTROP_CREATE, you can set XTR’CTLNO to –1 to have XTREE automatically assign the next available control number. (If the control is modeless, you will need to save the returned XTR’CTLNO value for referencing it in subsequent calls.)

Note: XTR'CTLNO enumerates/identifies only the XTREE controls, using a numbering scheme only meaningful to XTREE. See XTR'CTLID for the standard control ID (which can be specified in the AUI_CONTROL ctlid parameter) to perform standard control operations on the XTREE control (aka hide, move, etc.)

Here is an illustration of multiple XTREEs on the screen at once, for which you absolutely need to keep unique XTR'CTLNO values.

History

2009 January, A-Shell 5.1.1134:  The range of XTREE control IDs has been extended from 0-9 to 0-31. In other words, you can now have 32 trees defined at once. (Believe it or not, the previous limit of 10 was cramping some programmers' style, although in some cases, the issue wasn't so much the need to have more than 10 XTREEs in existence at the same time, but the desire to use hard-coded reference numbers for them.)