PRODUCTS

The STYLED-CONTROLS library

The COM.CURL.GUI.STYLED library is an add-on library that provides style sheets and skinned controls for the Curl GUI Toolkit for version 6.0 of the Curl RTE. The styled controls are built into version 7.0 so the library is not needed for 7.0 applets. However, a 7.0 version of the library is available for developers who want to make modifications.

The library includes a basic StyleManager implementation called BasicStyleManager. This class implements "style sheets" for GUI objects. It also provides skinnable UI delegates for almost all of the controls in the Curl GUI Toolkit. Finally, it includes a default skin for all of the skinnable controls.

If you previously downloaded the beta version of Version 6.0 or the Curl RTE or Curl IDE and the beta version of the styled controls library, you must download the released version of Version 6.0 of the Curl RTE or IDE along with the version of the styled controls library available here.

Developing with the Library

To get started with this library you need install the documentation in the Curl IDE. First, download and unzip the library to a convenient location. This location should not be inside of any other Curl project directory.

Note that there are two zip files for each locale. For the "en" locale, the files are COM.CURL.GUI.STYLED-6.0-03-en.zip, which should be used for development and COM.CURL.GUI.STYLED-6.0-03-pcurl-en.zip, which should be used for deployment. The former zip file includes documentation and source code. The zip file that includes "pcurl" in the name it only includes files that need to be deployed.

Once you have unzipped the development version of the library, you can install the documentation in the Curl IDE. Choose Install Documentation from the Help menu in the IDE. Click the Install button and then navigate to the location where you unzipped your copy of the library and select the manifest.mcurl file. You only need to do this when you download the library. (If you download an update, you must uninstall the documentation and install the updated version.)

To use the default skin, you will do the following:

  • In your project, delegate to the downloaded library. Use an alternate manifest location to specify the location of the library on your web site.
  • In your applet, import the STYLED-CONTROLS package and call install-style-sheet.
  • When you deploy, deploy both the applet and the library.

The installed documentation explains all of these steps in detail. After you install it, You will see a new item at the bottom of the Contents panel in the documentation viewer called COM.CURL.GUI.STYLED.6.0. Expand that item and you'll see the API Reference and the Skinned Controls Developer's Guide. Click the Skinned Controls link under that to see the complete documentation.

For applets written for API version 7.0, the libraries are COM.CURL.GUI.STYLED-R7.0-V7.0-00-en, which should be used for development and COM.CURL.GUI.STYLED-R7.0-V7.0-00-pcurl-en.zip, which should be used for deployment. When using the library in a 7.0 applet or package, be sure to import with override? = true.