SpecialEffect Property
Specifies the visual appearance of an object.
Syntax
object.SpecialEffect [=SpecialEffect]
The SpecialEffect property syntax has these parts:
| Part | Description |
|---|---|
| object | Required. A valid object. |
| SpecialEffect | Optional. The desired visual appearance of an object other than a CheckBox, OptionButton, or ToggleButton. |
Settings
The settings for SpecialEffect are:
| Value | Description |
|---|---|
| 0 | Object appears flat, distinguished from the surrounding form by a border, a change of color, or both. Default for Image and Label, valid for all controls. |
| 1 | Object has a highlight on the top and left and a shadow on the bottom and right. Not valid for check boxes or option buttons. |
| 2 | Object has a shadow on the top and left and a highlight on the bottom and right. The control and its border appear to be carved into the form that contains them. Default for CheckBox and OptionButton, valid for all controls (default). |
| 3 | Border appears to be carved around the edge of the control. Not valid for check boxes or option buttons. |
| 6 | Object has a ridge on the bottom and right and appears flat on the top and left. Not valid for check boxes or option buttons. |
For a Frame, the default value is 2.
Note that only 0 and 2 are acceptable values for CheckBox, OptionButton, and ToggleButton. All values listed are acceptable for other controls.
Remarks
You can use either the SpecialEffect or the BorderStyle property to specify the edging for a control, but not both. If you specify a nonzero value for one of these properties, the system sets the value of the other property to zero. For example, if you set SpecialEffect to 1, the system sets BorderStyle to 0.
For a Frame, BorderStyle is ignored if SpecialEffect is 0.
SpecialEffect uses the system colors to define its borders.
Note Although the SpecialEffect property exists on the ToggleButton, the property is disabled. You cannot set or return a value for this property on the ToggleButton.