XtraForm.EnableAcrylicAccent Property
Gets or sets whether the Acrylic accent is enabled for the Accordion Control, Layout Control and Calendar Control when they reside within the current form. The property also enables the Reveal Highlight effect for the Accordion Control and Calendar Control.
Namespace: DevExpress.XtraEditors
Assembly: DevExpress.Utils.v24.2.dll
Declaration
[Browsable(false)]
[EditorBrowsable(EditorBrowsableState.Never)]
public virtual bool EnableAcrylicAccent { get; set; }Property Value
| Type | Description |
|---|---|
| Boolean | true, to enable the Acrylic effect; otherwise, false. |
Remarks
Set the EnableAcrylicAccent property to true to enable the Acrylic accent (a semi-transparent texture) for the controls that support this rendering mode. These controls include:
-
CalendarControl (when its CalendarControlBase.CalendarView property value equals Fluent)
-
The AccordionControl and CalendarControl also activate the Reveal Highlight effect (a lighting effect that highlights items when a user moves the mouse pointer over them).
The EnableAcrylicAccent property’s default value is true for the Fluent Design Form. For the XtraForm and its other descendants, the property’s default value is false.
If the Acrylic effect is disabled by default, you can enable this feature for all controls within the form with the XtraForm.EnableAcrylicAccent property. Set this property to true when a form’s handle is created (for instance, in the form’s constructor).
You can enable and clear the Acrylic effect for individual controls with the XtraForm.ApplyAcrylicAccent and XtraForm.ClearAcrylicAccent methods.
If the Acrylic effect has not been applied so far (to all or individual controls), the first call of the ApplyAcrylicAccent method must be performed when the form’s handle is created (for instance, in the form’s constructor).
When you enable the Acrylic effect, DirectX rendering is enabled for the controls as well (except for the Layout Control).
Note
In some instances when DPI-aware mode is disabled, a Hamburger Menu can be incorrectly painted. Enable the DPI-aware mode on the Project Settings Page to avoid this issue.
Supported Windows Versions and Limitations
The Acrylic and Reveal Highlight effects are only available if the application runs on Windows 10 v1803 (OS build 17134) or newer.
Application Manifest
The supportedOS element in an application manifest allows you to specify the Windows versions that the application supports.
<compatibility xmlns="urn:schemas-microsoft-com:compatibility.v1">
<application>
<!-- A list of the Windows versions that this application has been tested on
and is designed to work with. Uncomment the appropriate elements
and Windows will automatically select the most compatible environment. -->
<!-- Windows Vista -->
<!--<supportedOS Id="{e2011457-1546-43c5-a5fe-008deee3d3f0}" />-->
<!-- Windows 7 -->
<!--<supportedOS Id="{35138b9a-5d96-4fbd-8e2d-a2440225f93a}" />-->
<!-- Windows 8 -->
<!--<supportedOS Id="{4a2f28e3-53b9-4441-ba9c-d69d4a4a6e38}" />-->
<!-- Windows 8.1 -->
<!--<supportedOS Id="{1f676c76-80e1-4239-95bb-83d0f6d0da78}" />-->
<!-- Windows 10 -->
<supportedOS Id="{8e0f7a12-bfb3-4fe8-b9a5-48fd50a15a9a}" />
</application>
</compatibility>
See the following help topic on docs.microsoft.com for more information: Application Manifests.
If the manifest declares that the application supports Windows 8 or higher, mouse actions performed on a transparent control are passed to the window below that transparent control. See the following help topic on docs.microsoft.com for more information: Form.TransparencyKey.
If the Acrylic accent is enabled, the Accordion and Calendar controls are semi-transparent that also causes mouse actions to be passed to the window below the control. To address this issue, you can remove the supported versions from the manifest or disable the Acrylic accent.