docs

Home Getting Started Using the Template Task Guides What’s New

cdWindowDim - Deployment and Usage

cdWindowDim includes a small DLL that supplies the window-dimming effect for your Clarion application.

Deployment

You must deploy CDWindowDim.dll with your application.

The DLL should reside in the same folder as your application EXE file or in the application’s normal DLL location.

Windows Compatibility Manifest

Your EXE must include a Windows compatibility manifest declaring support for Windows 8 or later. This is required for the child-window dimming effect to display correctly. A generic application manifest without the appropriate compatibility entry is not sufficient.

If the program runs but the window does not dim, check the manifest first. See Troubleshooting.

Usage

For normal Clarion applications, add cdWindowDim - Global Settings to the APP containing the procedures where you want dimming. The default appearance can be used without further customization.

You may also use the supplied code templates when you want to dim another window, including a window launched with START. Each task guide provides the necessary sequence and Clarion code examples.

For multi-DLL applications, see Multi-DLL Applications. For direct function calls, see Hand-Coded Integration.

Home Getting Started Using the Template Task Guides What’s New

Imported colored-message procedures

If you use the optional colored-message Source TXA, compile those Clarion procedures in exactly one APP and use External declarations in other APPs. Deploy the compiled Clarion Data DLL when applicable as well as CDWindowDim.dll. The product .LIB is needed for linking, not as a runtime DLL.

The optional Custom Message Window extension belongs on the actual message-window APP, including a Data DLL that implements that window. The separately imported Message Source/External TXAs and (for vuFileTools) Secure Login TXA install under accessory\libsrc\win, not accessory\template\win.