CodeBlock Hand code Extension

Previous  Top  Next

CodeBlock technology is also available to hand coders who don't want to block an entire procedure or who want a finer degree of control over the process.


You can use hand code to:

·	Check the global status of ProCodeBlock

·	Call the CodeBlock routine and display the message, help and website URL for the end user

·	Surgically remove a portion of code from the compile when ProCodeBlock is enabled

·	Block EIP (Edit in Place) actions on a browse when ProCodeBlock is enabled

Note: As a time saver there is also a #CODE Template that inserts the few lines of code needed to block EIP if you prefer.


To use hand code for CodeBlocking in a procedure, click the EXTENSION button in the procedure tree. Then type CodeBlock and select the CodeBlock: Block this Procedure template from the list as shown here:




Then click SELECT to add this extension template to the procedure.

After the procedure extension is added you will see that it is populated with the options that you set in the global defaults.



Global Template Status Indicator
On each of the Extension templates, you will see text that tells you if the Global ProCodeBlock Control is disabled or enabled.

Example: Disabled

Example: Enabled

This visual indicator means that you do not have to open the global extension to determine if ProCodeBlock is active or not.


Display a Message
If this option is checked a Messagebox will be displayed when ProCodeBlock is active.

Message Title
This is the TITLE of a standard Clarion Messagebox.

Message Text
This is the TEXT of a standard Clarion Messagebox.

Use Custom Messagebox Code
Check this option to disable the Standard Messagebox generation and enable an entry button where you can type or paste your own Custom Messagebox code.



Custom Messagebox Code
Click this button and type/paste your own Custom Messagebox code.




Display a HTML Help Topic
If this option is checked a HTML help topic will be displayed when ProCodeBlock is active.



Default Help File
Enter the name of the default HTML help file to display (no quotes needed on this extension)

Default Help Topic
Enter the name of the default HTML help file topic to display (no quotes needed on this extension)

Select Display Method
ProCodeBlock can display a HTML help file topic using the ShellExecute API or with the standard Clarion cwHHGlobal template.

The default value is to use ShellExecute.

What's the difference?
Using ShellExecute to display the help topic means that the help topic will remain open after your application closes. This can be very useful when you want to close your application after advising the user that they have been CodeBlocked.



Display a Website URL
If this option is checked a website URL will be displayed in the user's browser when ProCodeBlock is active.



Default Website URL
The URL to display (using ShellExecute)

Add URL Button to Messagebox
Check this box to add a button on the standard Messagebox (above) that offers to take the user to a website URL when the Messagebox is displayed.

Button Text
The text to go on the standard button (limited to about 10 characters).

The default text is Buy Now.

Note: the button text is disabled if you are using Custom Messagebox code above


Disabling ProCodeBlock for this template

If you check the Disable CodeBlock box at the bottom of the tab then no ProCodeBlock code will be generated for this template on this procedure. The tab will be disabled to provide a visual indicator.