| Home | Automatic Message Dimming |
cdWindowDim includes three optional Clarion procedures for choosing a specific dimming color behind one message. They accept ordinary MESSAGE() arguments and return the selected button result:
| Procedure | Effect |
|---|---|
cdDimMessage |
Black overlay |
cdDimMessageInfo |
Blue overlay |
cdDimMessageError |
Red overlay |
You do not need these procedures for normal MESSAGE(), STOP() or HALT() calls: those can already dim automatically when the global automatic-message setting is enabled (on by default).
ImportcdDimMessage — Customizable procedures (Single EXE or Data DLL).cdDimMessage('Hello World','Information')
Result = cdDimMessageInfo('The operation completed','Information')
CASE cdDimMessageError('Try again?','Error')
OF 1
! Respond to the selected button.
END
The functions support the normal optional MESSAGE() arguments. If you save a button response, declare the receiving variable as UNSIGNED.
The CDMessageAutoDimPushSuppression and CDMessageAutoDimPopSuppression DLL declarations in the global template are used by these three imported colored-message procedures. You do not call either function yourself; the imported procedures use them automatically.
The two import utilities have different jobs:
| APP | Select this utility |
|---|---|
| Data DLL (or one APP owning the procedures) | ImportcdDimMessage — Customizable procedures (Single EXE or Data DLL) |
| Every other APP that calls them | ImportcdDimMessageDec — Customizable procedure declarations (other APPs in multi-DLL solution) |
Import the first utility once, into the owning APP. Use the second in each other DLL or EXE APP that needs to call the procedures. Never import both into the same APP. Compile the Data DLL before building its callers.
These utility entries automatically import the installed procedure files from Clarion’s accessory\libsrc\win location. You do not need to manually locate them.
For complete multi-DLL setup, see Multi-DLL Applications.
| Home | Automatic Message Dimming |