IRdsDictionaryElementsSearch.FindFirstElement

Синтаксис Fore

FindFirstElement: IRdsDictionaryElement;

Синтаксис Fore.NET

FindFirstElement: Prognoz.Platform.Interop.Rds.IRdsDictionaryElement;

Описание

Метод FindFirstElement осуществляет поиск первого элемента, удовлетворяющего условиям поиска и возвращает параметры найденного элемента в случае удачного поиска.

Пример Fore

Для выполнения примера предполагается наличие формы, расположенной на ней кнопки с наименованием «Button1», компонента RdsDictionaryBox с наименованием «RdsDictionaryBox1» и какого-либо компонента UiRdsDictionary являющегося источником данных для «RdsDictionaryBox1». В справочнике НСИ, который подключен к компоненту UiRdsDictionary, имеются атрибуты «Name» и «UserAttr».

    Sub Button1OnClick(Sender: Object; Args: IMouseEventArgs);
    Var
        RdsInst: IRdsDictionaryInstance;
        Search: IRdsDictionaryElementsSearch;
        Crit: IDimTextCriteria;
        Elem: IRdsDictionaryElement;
    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 := "Доход насел";
        Search.SetTextCriteria(Crit);
        Elem := Search.FindFirstElement;
        Debug.WriteLine(Elem.Name);
        Elem := Search.FindNextElement(Elem);
        Debug.WriteLine(Elem.Name);
    End Sub Button1OnClick;

После выполнения примера при нажатии на кнопку будет осуществлен поиск первых двух элементов справочника НСИ с указанными параметрами критерия поиска. Поиск будет осуществляться по значениям указанных атрибутов. Наименования найденных элементов будут выведены в консоль среды разработки.

Пример Fore.NET

Для выполнения примера предполагается наличие .NET-формы, расположенной на ней кнопки с наименованием «Button1», компонента RdsDictionaryBoxNet с наименованием «RdsDictionaryBoxNet1» и какого-либо компонента UiRdsDictionaryNet являющегося источником данных для «RdsDictionaryBoxNet1». В справочнике НСИ, который подключен к компоненту UiRdsDictionaryNet, имеются атрибуты «Name» и «UserAttr».

    Private Sub button1_Click(sender: System.Object; e: System.EventArgs);
    Var
        RdsInst: IRdsDictionaryInstance;
        Search: IRdsDictionaryElementsSearch;
        Crit: DimTextCriteria;
        Elem: IRdsDictionaryElement;
    Begin
        RdsInst := RdsDictionaryBoxNet1.Source.Instance;
        Search := RdsInst.CreateSearch();
        Search.Attributes.Attributes := "Name;UserAttr";
        Crit := New DimTextCriteria();
        Crit.CriteriaOptions := TextCriteriaOptions.tecropSearchStringAttributes
            Or TextCriteriaOptions.tecropFreeText;
        Crit.Text := "Доход насел";
        Search.SetTextCriteria(Crit);
        Elem := Search.FindFirstElement();
        Text := Elem.Name;
        Elem := Search.FindNextElement(Elem);
        Text := Text + " " + Elem.Name;
    End Sub;

См. также: