Найти элемент справочника по наименованию.
Синтаксис:
НайтиПоНаименованию(<Наименование>, <Режим>, <ФлагПоиска>)
Англоязычный синоним:
FindByDescr
Параметры:
<Наименование> |
Строковое выражение с наименованием искомого элемента справочника. |
<Режим> |
Необязательный параметр. Числовое выражение — режим поиска: 1 — поиск внутри установленного подчинения (родителя); 0 — поиск во всем справочнике вне зависимости от родителя. Значение по умолчанию — 1. |
<ФлагПоиска> |
Необязательный параметр. Числовое выражение — флаг поиска: 1 — найти точное соответствие наименования; 0 — найти наименование по первым символам. Значение по умолчанию — 0. |
Возвращаемое значение:
Число 1 — если действие выполнено;
Число 0 — если действие не выполнено (элемент не найден).
Описание:
Метод НайтиПоНаименованию выполняет поиск элемента справочника по наименованию, заданному параметром <Наименование> и позиционирует объект справочник на этом элементе.
Данный метод может использоваться только для объектов, созданных функцией СоздатьОбъект.
Пример:
Спр = СоздатьОбъект("Справочник.Сотрудники");
Спр.ИспользоватьДату(ДатаДок);
// Позиционируем созданный объект Спр по известному наименованию
Спр.НайтиПоНаименованию("Иванов", 1);
Если Спр.Выбран() > 0 Тогда
Оклад=Спр.Оклад;
Подразделение = Спр.Подразделение;
Иначе
Предупреждение("Нет у нас Ивановых!");
КонецЕсли;
См. также: ПолноеНаименование