Skip to main content

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.1.dll

NuGet Packages: DevExpress.Utils, DevExpress.Wpf.Core

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:

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).

image

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.

See Also