Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

ContextItemCollectionOptions.DisabledStateOpacity Property

Gets or sets opacity for all disabled context items.

Namespace: DevExpress.Utils

Assembly: DevExpress.Utils.v24.2.dll

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

#Declaration

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

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

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

The image below demonstrates the result.

DisabledStateOpacity

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

PropertiesDisabledStateOpacity

See Also