AppearanceOptions.UseImage Property
Gets or sets whether to use the AppearanceObject.Image property value.
Namespace: DevExpress.Utils
Assembly: DevExpress.Utils.v24.1.dll
NuGet Packages: DevExpress.Utils, DevExpress.Wpf.Core
Declaration
[Browsable(false)]
[DefaultValue(false)]
[DXCategory("Appearance")]
[EditorBrowsable(EditorBrowsableState.Never)]
[XtraSerializableProperty]
public virtual bool UseImage { get; set; }Property Value
| Type | Default | Description |
|---|---|---|
| Boolean | false | true to use the AppearanceObject.Image property value; false to use the background image specified by the parent appearance object. |
Property Paths
You can access this nested property as listed below:
| Object Type | Path to UseImage |
|---|---|
| AppearanceObject |
|
| AppearanceOptions |
|
Remarks
If the current appearance object has no parent, the AppearanceObject.Image property value is used regardless of the UseImage property setting. Please refer to the Look and Feel topic for details.
When an AppearanceObject’s style setting (for example, BackColor, ForeColor, Font and TextOptions.HAlignment) is set to a non-default value, the corresponding Options.Use… option (for instance, Options.UseBackColor, Options.UseForeColor, Options.UseFont and Options.UseTextOptions) is automatically set to true in the following cases:
- The AppearanceObject belongs to a control/component (or its element), and this control/component has been completely loaded (see the control’s IsLoading property to check the load status);
- The AppearanceObject belongs to a grid column/band or tree list column/band, and the column/band belongs to a grid/tree list control;
- The AppearanceObject is standalone, that is, it does not belong to any control or component.
In other cases, the Options.Use… options are not automatically enabled. You may need to enable these options manually for the style settings to be in effect.