SmartSearchBehaviorProperties.ItemDescriptions Property

Gets a collection of item descriptions.

Namespace: DevExpress.AIIntegration.WinForms

Assembly: DevExpress.AIIntegration.WinForms.v25.1.dll

NuGet Package: DevExpress.AIIntegration.WinForms

Declaration

C#

[Browsable(false)]
public List<AIItemDescription> ItemDescriptions { get; }

VB.NET

<Browsable(False)>
Public ReadOnly Property ItemDescriptions As List(Of AIItemDescription)

Property Value

Type	Description
List<DevExpress.AIIntegration.WinForms.AIItemDescription>	The collection of item descriptions.

Remarks

Once you attach the SmartSearchBehavior to a control, you should describe items so that Smart Search can find appropriate items. In the context of Smart Search, an item refers to a BarItem when working with a RibbonControl, or an AccordionControlElement when working with an AccordionControl.

Note

Item descriptions are optional if an item’s text or caption is specified (for example, a bar item’s Caption property or accordion UI element’s Text property is set to a non-empty string). Although Smart Search attempts to find items based on their text/caption, we recommend that you also describe items for improved accuracy.

Use the ItemDescriptions collection property to add descriptions (AIItemDescription) for certain items. Each AIItemDescription object in the collection has two properties:

1. AIItemDescription.Item: An item (BarItem or AccordionControlElement).
2. AIItemDescription.Description: A string that describes the item.

C#

using DevExpress.AIIntegration.WinForms;
using DevExpress.XtraBars.Ribbon;

public Form1() {
    InitializeComponent();
    // Displays a search box in the Ribbon control's caption.
    ribbon.OptionsSearchMenu.SearchItemPosition = SearchItemPosition.Caption;

    behaviorManager1.Attach<SmartSearchBehavior>(ribbon, behavior => {
        behavior.Properties.ItemDescriptions.AddRange(new AIItemDescription[]{
            new AIItemDescription(itemEnableSystemProtection, "Activates software protection against unauthorized access."),
            new AIItemDescription(itemLogin, "Displays a sign-in or login form."),
            new AIItemDescription(itemSettings, "Displays settings and options related to security and protection."),
            new AIItemDescription(itemRBAC, "Manages user access permissions and role-based access control (RBAC)."),
            new AIItemDescription(itemBackup, "Backs up (creates a copy of) sensitive data (information)."),
            new AIItemDescription(itemRestore, "Restores data from a backup database."),
        });
    });
}

VB.NET

Imports DevExpress.AIIntegration.WinForms
Imports DevExpress.XtraBars.Ribbon

Public Sub New()
    InitializeComponent()
    ' Displays a search box in the Ribbon control's caption.
    ribbon.OptionsSearchMenu.SearchItemPosition = SearchItemPosition.Caption

    behaviorManager1.Attach(Of SmartSearchBehavior)(ribbon, Sub(behavior)
      behavior.Properties.ItemDescriptions.AddRange(New AIItemDescription(){
        New AIItemDescription(itemEnableSystemProtection, "Activates software protection against unauthorized access."),
        New AIItemDescription(itemLogin, "Displays a sign-in or login form."),
        New AIItemDescription(itemSettings, "Displays settings and options related to security and protection."),
        New AIItemDescription(itemRBAC, "Manages user access permissions and role-based access control (RBAC)."),
        New AIItemDescription(itemBackup, "Backs up (creates a copy of) sensitive data (information)."),
        New AIItemDescription(itemRestore, "Restores data from a backup database.")
      })
    End Sub)
End Sub

Tip

Read the following help topic for additional information: AI-powered Smart Search.