| Home | Getting Started | Using the Template | Task Guides | What’s New |
The most important first check is the EXE’s Windows compatibility manifest. It must declare support for Windows 8 or later. An application can compile and run normally yet show no dimming effect when the manifest does not provide this compatibility information.
See Requirements and Deployment.
Open cdWindowDim - Global Settings. Make sure Disable this template is unchecked and Enable automatic browse dimming is checked. Confirm that the affected browse procedure has not selected Disable auto dimming for this procedure. Verify that the installed runtime DLL matches the product version.
Make sure the strength is greater than zero and a visible color is selected. A nearly black custom color can look similar to the default black overlay.
A custom tint may also look lighter or different from the picker swatch because the overlay blends with the underlying window. For example, a blue overlay can look lavender over a light browse. Adjust the color and strength together; see Choosing Custom Overlay Colors.
Clarion’s Custom color picker uses Hue, Saturation, and Lightness (HSL). When the selected color is black, Lightness (L) can start at 0. Clicking a hue in the large color area may leave the preview black because lightness remains zero.
The Custom overlay color starts at COLOR:Gray. The normal Use default window appearance setting produces a black overlay at strength 90.
If the Custom preview is black:
Confirm the APP containing the procedure has its cdWindowDim global extension enabled. For hand-coded calls, make sure the required DLL declarations and matching CDWindowDim.lib are available. If you globally disabled cdWindowDim, handwritten function calls will not be removed for you.
Check the operation sequence. For synchronous calls, Restore belongs after the called procedure returns. For a window launched with START, do not restore immediately after START. Instead, associate the returned thread with the parent and run the Started Child Closing code template in the child’s Close Window embed. See Dimming a Window Started with START.
Make sure every successful manual Dim has exactly one matching Restore or started-child closing notification. For START, the child’s closing code should run regardless of whether the user closes the window with a button or the title-bar X.
Use the individual and global disable options described in Temporarily Disable Dimming.
If the issue persists, contact Clarion ProSeries Support with the Clarion version, ABC/Legacy chain, and steps to reproduce it.
| Home | Getting Started | Using the Template | Task Guides | What’s New |