IRdsDictionaryElementsSearch.FindFirst

Syntax

FindFirst: Integer;

Description

The FindFirst method searches the first element that meets search conditions and returns key of the found element if search was successful.

Comments

Method returns -1 if element was not found.

Example

Executing the example requires a form with the Button1 button, the RdsDictionaryBox component named RdsDictionaryBox1, and the UiRdsDictionary component that is a data source for RdsDictionaryBox1. The MDM dictionary that is connected to the UiRdsDictionary component has the attributes Name and UserAttr.

    Sub Button1OnClick(Sender: Object; Args: IMouseEventArgs);
    Var
        RdsInst: IRdsDictionaryInstance;
        Search: IRdsDictionaryElementsSearch;
        Crit: IDimTextCriteria;
        Key: Integer;
    Begin
        RdsInst := RdsDictionaryBox1.Source.Instance;
        Search := RdsInst.CreateSearch;
        Search.Attributes.Attributes := "Name;UserAttr";
        Crit := New DimTextCriteria.Create;
        Crit.CriteriaOptions := TextCriteriaOptions.SearchStringAttributes
            Or TextCriteriaOptions.FreeText;
        Crit.Text := Income of the population;
        Search.SetTextCriteria(Crit);
        Key := Search.FindFirst;
        Debug.WriteLine(Key);
        Key := Search.FindNext(Key);
        Debug.WriteLine(Key);
    End Sub Button1OnClick;

After executing the example, pressing the button searches the first two elements of the MDM dictionary with the specified parameters of search criterion. Search is executed on values of specified attributes. Keys of found elements are displayed in the development environment console.