ContextItemCollectionOptions.DisabledStateOpacity Property

Gets or sets opacity for all disabled context items.

Namespace: DevExpress.Utils

Assembly: DevExpress.Utils.v24.1.dll

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

Declaration

C#

[DefaultValue(0.6F)]
[XtraSerializableProperty]
public float DisabledStateOpacity { get; set; }

VB.NET

<DefaultValue(0.6F)>
<XtraSerializableProperty>
Public Property DisabledStateOpacity As Single

Property Value

Type	Default	Description
Single	0.6	A value between 0 and 1 that determines opacity; 1 is for “opaque”, 0 is for “transparent”.

Property Paths

You can access this nested property as listed below:

Object Type	Path to DisabledStateOpacity
CameraControl	.ContextButtonOptions .DisabledStateOpacity
CalendarControlBase	.ContextButtonOptions .DisabledStateOpacity
ImageSlider	.ContextButtonOptions .DisabledStateOpacity
RepositoryItemPictureEdit	.ContextButtonOptions .DisabledStateOpacity
SvgImageBox	.ContextButtonOptions .DisabledStateOpacity
TileControl	.ContextButtonOptions .DisabledStateOpacity
TileView	.ContextButtonOptions .DisabledStateOpacity

Remarks

To disable a ContextItem, set the Enabled property to false. The code below demonstrates how to decrease opacity for a disabled RatingContextButton.

C#

using DevExpress.Utils;
// ...
((RatingContextButton)pictureEdit1.Properties.ContextButtons[0]).Enabled = false;
pictureEdit1.Properties.ContextButtonOptions.DisabledStateOpacity = 0.5f;

VB.NET

Imports DevExpress.Utils
' ...
CType(pictureEdit1.Properties.ContextButtons(0), RatingContextButton).Enabled = False
pictureEdit1.Properties.ContextButtonOptions.DisabledStateOpacity = 0.5F

The image below demonstrates the result.

Alternatively, you can set the DisabledStateProperty value in a control’s Properties window.