SCA Micro Templates
		Documentation

• Introduction
• Installation
• Browse Header and Reverse Sort
• Auto Next-Tab
• XP Controls Enable
• Support

Introduction

The S.C.A. Micro Templates were developed to add value to your applications by integrating small but very useful and attractive features.

The Browse Header Sort and Reverse Sort template, adds let's the user change sort orders by clicking on columns' headers, while allowing the developer to have full control of each sort order, by using the "Default Behavior/Conditional Behavior" of the standard ABC templates. Clicking again in a selected column, makes the browse display records in reversed order.

The Auto Next-Tab templates helps the use to enter data in fields which are populated in multiple tabs, by automatically selecting the first field in the next tab when the user accepts the last field in the current tab. The developer can populate this extension template at the procedure level, or, to save time, at the Global level, and the template will only generate code when there are two or more tabs in a window.

The XP Controls Enable is a global template whose only function is to include a precompiled resource file which tells Window XP that the application can handle the new style XP controls. This gives the application a modern look when running on Windows XP.

Installation

The installation is handled by the setup program scamicroinstall.exe you downloaded after buying the templates. This setup program does the following steps (depending on the options you selected):

• Installs these files:
  • SCA.TPL to InstDir\Template
  • SCAEXAM1.APP, SCAEXAM1.EXE and SCAMICRO.DCT to InstDir\examples\scamicro
  • SCAMICRO.HTML (this file) and images to InstDir\docs\scamicro
  • XPCTRL.RES to InstDir\LIB
• If necessary, adds this line to the c55xx.red file:
  • *.res= InstDir\lib (usually InstDir will be C:\C55\3RDPARTY)
    
• Adds a link to this file to "Accessories" - "Help" in the Clarion IDE.
• Starts the Clarion IDE and registers the template SCA.TPL
• Creates a Start Menu folder with a link to this file and an "uninstall" link.

Browse Header and Reverse Sort

To add this template to your application, follow these steps:

• Define in "Browse Box Behavior" - "Default Behavior" and "Conditional Behavior" all the sort orders you want to use. When defining "Conditional Behavior", in the "Condition:" field enter "0".
• In the "Extensions" section, click on the browse line and then on the "Insert Button", and select "S.C.A. Browse Header Sort Extended".
• After populating the template, you'll see a window like this:
  
  
  

  "Ascending" symbol:	Used when the column is the current sort order and order is ascending
  "Descending" symbol:	Used when the column is the current sort order and order is descending
  "No sort" symbol:	Used when the column is not the current sort order, but it's available for clicking.
  :	If you click on these buttons, they populate some common choices of symbols on the previous prompts.
  	These are the keycodes which will change the sort order. "Click on header and "DoubleClick on header" are mutually exclusive. "CtrlClick/ShftClick/AltClick" work anywhere in the column.
  	Select the column which is linked to the default sort order. Specify if you want the symbol at the left or right of the column header. If you are using a locator for the default sort order, select it, and it will be hidden when using a different sort order.
  	You need to press the Insert button for each one of your additional sort orders. For each sort order you need to enter the key used, the linked columnd, and if you are using a locator for that sort order, the locator control.

• After filling these prompts, just compile and run your application, and test the results.

Auto Next-Tab

There are two ways to use this template:

1. At the procedure where you want this functionality, enter the "Extensions" section, press the "Insert" button and select "S.C.A. - Auto Next-Tab". The template has two checkboxes you should only enable if you are using one of the "Enter=Tab" templates
   
2. If you prefer to add this feature to all your application, populate it at the "Global" - "Extensions" option, selecting the template "Auto Next Tab Global Enable". This template has the same prompts, and will automatically populate the template for all the procedures in your application. This template will only generate code when there are two or more tabs in the window.

XP Controls Enable

This template must be populated at the "Global" - "Extension" option, and has no prompts. Select the template "S.C.A. - Enable XP Controls". Your resulting application will have this look:

Warnings:
- This new look will only work if you run the application in a computer running Windows XP. You won't have any problem if you run the application on any other Windows version, but you'll get the traditional look.
- This feature won't work with controls with the "transparent" attribute. This can be a problem if you are using background images in your windows.
- If the Clarion button has an Icon, it won't get the new look. You should use Icetips MagicButtons for this.
- Depending on how is your shortcut to Clarion configured, you won't see the new look if you run your application using the Compile&Run button of the Clarion IDE. In this case, run the application using the Windows Explorer or try disabling the compatibility options of your Clarion shortcut.
Note:
- This template works with Legacy templates.

Support

TIf you need help, please visit our site at http://sca.com.mx/clarion/ or contact carlosg@sca.com.mx