Developing ColdFusion Applications
Building Custom CFXAPI Tags

Registering CFXs

To use a CFX tag in your ColdFusion applications, first register it in the Extensions, CFX Tags page in the ColdFusion Administrator.

To register a Java CFX:

1. On the ColdFusion Administrator Server tab, select Extensions > CFX Tags to opent the CFX Tags page.
2. Click the Register Java CFX button.
3. Enter the tag name (for example cfx_MyNewTag).
4. Enter the class name (without the .class extension).
5. (Optional) Enter a description.
6. Click Submit Changes.

You can now call the tag from a ColdFusion page.

To register a C++ CFX:

1. On the ColdFusion Administrator Server tab, select Extensions > CFX Tags to opent the CFX Tags page.
2. Click the Register C++ CFX button.
3. Enter the Tag name (for example cfx_MyNewTag).
4. If the Server Library .dll field is empty, enter the file path.
5. Accept the default Procedure entry.
6. Clear the Keep library loaded box while developing the tag.

   When the tag is ready for production use, you can select this option to keep the DLL in memory for improved performance.

7. (Optional), Enter a description.
8. Click Submit Changes.

You can now call the tag from a ColdFusion page.

On Windows NT only, the Visual C++ Custom Tag Wizard automatically registers custom tags so that they can be tested and debugged.

To change a CFX tag:

1. Click the tag that you want to change in the Registered CFX Tags list.
2. Make changes as needed on the Edit CFX Tag page.
3. Click Submit Changes.

To delete a CFX tag:

• Click the Delete Applet (right-most) icon in the Controls column of the Registered CFX Tags list for the tag you want to delete.

On Windows NT only, the Visual C++ Custom Tag Wizard automatically registers custom tags so that they can be tested and debugged.

Copyright © 2001, Macromedia Inc. All rights reserved.

---