Conditions to determine which special effect to apply to an item's image.
Usage
Set_Property(OLECtrlEntID, "OLE.ImageEffects", StringValue)
Values
StringValue can be any string meeting the following format requirements:
Syntax: @FM delimited list of conditions
Default: ""
Remarks
The ImageEffects property allows you to automate which special effect should be applied to an item's image. You provide an ordered list of specially formatted condition statements telling the control what state the item must be in to apply a particular effect. When the SRP Tree Control is about to display an item, it evaluates each condition in order and, if one of them is true, applies the associated effect.
Each field has two values: Effect and Condition. The Effect value identifies one of the available effects.
| Effect | Description |
|---|---|
| Saturate | Saturates the image slightly so that normal images stand out more |
| Grayscale | Displays the image in grayscale instead of full color |
| Levitate | Displays the image slightly raised with a drop shadow |
| Default | The control draws the image normally if enabled or grayed out if disabled |
The second value of each field, the Condition value, is the condition in which the effect is to be used. Each field in this property as a like case statement. So, the property might look something like this:
Conditions<1> = "Levitate" :@VM:"Hot" Conditions<2> = "Default" :@VM:"Selected" Conditions<3> = "Saturated":@VM:"1"
However, you can visualize the property to mean this:
Begin Case Case Hot ApplyLevitateEffect() Case Selected ApplyDefaultEffect() Case 1 ApplySaturatedEffect() End Case
For more information on using conditions, see the Conditions tutorial in the Using SRP OLE Tree section.
Example
// Apply hover effects Conditions = "" Conditions<1> = "Levitate":@VM:"Hot" Conditions<2> = "Default":@VM:"Selected" Conditions<3> = "Saturated":@VM:"1" Set_Property(@Window:".OLE_TREE", "OLE.ImageEffects", Conditions)
