SRCategoryAttribute Class

Enables you to specify the Property Grid category where a custom property should be placed.

Namespace: DevExpress.XtraReports

Assembly: DevExpress.XtraReports.v18.1.dll

Syntax

[AttributeUsage(AttributeTargets.Assembly | AttributeTargets.Module | AttributeTargets.Class | AttributeTargets.Struct | AttributeTargets.Enum | AttributeTargets.Constructor | AttributeTargets.Method | AttributeTargets.Property | AttributeTargets.Field | AttributeTargets.Event | AttributeTargets.Interface | AttributeTargets.Parameter | AttributeTargets.Delegate | AttributeTargets.ReturnValue | AttributeTargets.GenericParameter | AttributeTargets.All)]
public sealed class SRCategoryAttribute :
    CategoryAttribute

This attribute enables you to locate a property in a Property Grid category localized using ReportStringId. In other aspects, it is similar to the is similar to CategoryAttribute.

When both the SRCategoryAttribute and BindableAttribute are specified, the property will appear in both the Data and the custom category.

When no custom category is specified, a property appears in the Misc category.

Examples

This example illustrates the use of the DefaultBindablePropertyAttribute and SRCategoryAttribute that define the behavior of custom properties specified for XRControl descendants.

using DevExpress.XtraReports;
using DevExpress.XtraReports.Localization;
using DevExpress.XtraReports.UI;
// ...

// The following line specifies the default property to bind the control 
// to a field dropped from the Field List.
[DefaultBindableProperty("MyCustomProperty")]
public class MyCustomLabel : XRLabel {
    // The following line specifies the Property Grid category, 
    // where a custom property is located.
    [SRCategory(ReportStringId.CatAppearance)]
    // When BindableAttribute is applied, the property will appear
    // in the Data category, as well as in the custom category (if specified).
    [System.ComponentModel.Bindable(true)]
    public string MyCustomProperty { get; set; }
}

public class MyCustomPageHeaderBand : PageHeaderBand {
    // When no custom Property Grid category is specified, 
    // a property appears in the Misc category.
    public string MyCustomBandProperty { get; set; }
}

Inheritance

Object
SRCategoryAttribute

See Also