Методы
Синтаксис:
Вставить(<Индекс>, <3начение>, <Представление> , <Пометка>, <Картинка>)
Параметры:
<Индекс> Обязательный
Тип: Число. Индекс позиции, на которую надо вставить элемент.
<3начение> Необязательный
Тип: Произвольный. Значение, которое необходимо вставить.
Значение по умолчанию: Неопределено.
<Представление> Необязательный
Тип: Строка. Строковое выражение, содержащее представление добавляемого значения.
Значение по умолчанию: Пустая строка.
<Пометка> Необязательный
Тип: Булево. Определяет, создавать новое значение с установленной пометкой или нет.
Значение по умолчанию: Ложь.
<Картинка> Необязательный
Тип: Картинка. Визуальное представление значения. Значение по умолчанию: Пустая картинка.
Возвращаемое значение:
Тип: ЭлементСпискаЗначений. Новый элемент списка значений.
Описание:
Позволяет вставить новый элемент в список значений на позицию с указанным индексом.
Пример:
СписокТиповЦен.Добавить("Все наценки", Истина);
ВыборкаТиповЦен = Справочники.ТипыЦен.Выбрать();
Пока ВыборкаТиповЦен.Следующий() Цикл
СписокТиповЦен.Вставить(0, ВыборкаТиповЦен.Ссылка, ВыборкаТиповЦен.Наценка, Ложь);
КонецЦикла ;
Синтаксис:
ВыбратьЭлемент(< Заголовок>, <Элемент>)
Параметры:
<3аголовок> Необязательный
Тип: Строка. Заголовок окна выбора.
Значение по умолчанию: Неопределено. Стандартный заголовок системы.
<Элемент> Необязательный
Тип: ЭлементСпискаЗначений. Элемент, на который следует изначально спозиционировать список значений при интерактивном выборе. Если значением параметра не является элемент списка значений, входящий в данный список, позиционирования не произойдет.
Значение по умолчанию: Неопределено.
Возвращаемое значение:
Тип: ЭлементСпискаЗначений. Выбранный элемент списка значений. При отказе от выбора возвращается Неопределено.
Описание:
Позволяет интерактивно выбрать один из элементов, входящих в список значений.
Пример:
ВыбЭлемент = СписокТиповЦен.НайтиПоЗначению(ВыбЗначение);
ВыбЭлемент = СписокТиповЦен.ВыбратьЭлемент("Выберите тип цен:", ВыбЭлемент);
Если ВыбЭлемент = Неопределено Тогда
Сообщить("Не выбран тип цен.");
Иначе
ВывЗначение = ВыбЭлемент.Значение;
КонецЕсли ;
ВыгрузитьЗначения (UnloadValues)
Синтаксис:
ВыгрузитьЗначения()
Возвращаемое значение:
Тип: Массив. Сформированный массив.
Описание:
Позволяет выгрузить хранимые элементами значения в массив значений.
Пример:
МассивЭлементов = СписокТиповЦен.Выгрузить();
Добавить (Add)
Синтаксис:
Добавить(< Значение>, <Представление> , <Пометка>, <Картинка>)
Параметры:
<3начение> Необязательный
Тип: Произвольный. Значение, которое необходимо добавить.
Значение по умолчанию: Неопределено.
<Представление> Необязательный
Тип: Строка. Строковое выражение, содержащее представление добавляемого значения.
Значение по умолчанию: Пустая строка.
<Пометка> Необязательный
Тип: Булево. Определяет, создавать новое значение с установленной пометкой или без пометки.
Значение по умолчанию: Ложь.
<Картинка> Необязательный
Тип: Картинка. Визуальное представление значения.
Значение по умолчанию: Пустая картинка.
Возвращаемое значение:
Тип: ЭлементСпискаЗначений. Добавленный элемент списка значений.
Описание:
Позволяет добавить новый элемент в конец списка значений.
Пример:
Выборка = Справочники.ТипыЦен.Выбрать();
Пока Выборка.Следующий() Цикл
СписокТиповЦен.Добавить(Выборка.Ссылка, Выборка.Наценка, Истина);
КонецЦикла;
ЗагрузитьЗначения (LoadValues)
Синтаксис:
ЗагрузитьЗначения (< Массив значений>)
Параметры:
<Массив значений> Обязательный
Тип: Массив. Массив, содержащий значения для заполнения списка значений.
Описание:
Очищает список значений, затем заполняет его элементами со значениями, взятыми из переданного в качестве параметра массива.
Пример:
СписокТиповЦен.Загрузить(МассивЭлементов) ;
Индекс (IndexOf)
Синтаксис:
Индекс(<Элемент>)
Параметры:
<Элемент> Обязательный
Тип: ЭлементСпискаЗначений. Элемент списка значений, для которого надо определить индекс.
Возвращаемое значение:
Тип: Число. Индекс переданного элемента в списке значений. Если элемент не принадлежит данному списку, возвращается -1.
Описание:
Позволяет определить индекс элемента в списке значений.
Пример:
НомерСтроки = Список.Индекс(ТекущийЭлементСписка);
Количество (Count)
Синтаксис:
Количество()
Возвращаемое значение:
Тип: Число. Количество элементов в списке.
Описание:
Позволяет получить количество элементов списка значений.
Пример:
Сообщить ("Итого типов цен: " + СписокТиповЦен.Количество());
НайтиПоЗначению (FindByValue)
Синтаксис:
НайтиПоЗначению(<Искомое значение>)
Параметры:
<Искомое значение> Обязательный
Тип: Произвольный. Выражение со значением, которое требуется найти.
Возвращаемое значение:
Тип: ЭлементСпискаЗначений. Найденный элемент списка значений. Если ни один элемент не хранит значения, равного искомому, возвращается Неопределено.
Описание:
Позволяет найти соответствующий значению элемент списка значений.
Пример:
Если ПолеСписка1.НайтиПоЗначению(Вы6Значение) = Неопределено Тогда
Сообщить("Значение не найдено!");
КонецЕсли;
ОтметитьЭлементы (Checkltems)
Синтаксис:
ОтметитьЭлементы (<Заголовок>)
Параметры:
< Заголовок> Необязательный
Тип: Строка. Заголовок окна диалога.
Значение по умолчанию: Неопределено. Стандартный заголовок системы.
Возвращаемое значение:
Тип: Булево. Истина, если в диалоге пометки нажата кнопка ОК, иначе - Ложь.
Описание:
Позволяет интерактивно установить или снять пометки у элементов списка значений.
Пример:
Если СписокТиповЦен.ОтметитьЭлементы("Отметьте удаляемые типы цен.") Тогда
Для каждого Элемент из СписокТиповЦен Цикл
Если Элемент.Пометка = Истина Тогда
Элемент.Значение.ПолучитьОбъект().УстановитьПометкуУдаления(Истина);
КонецЕсли;
КонецЦикла;
Иначе
Сообщить("Отказ от пометки на удаление типов цен.");
КонецЕсли;
Очистить (Clear)
Синтаксис:
Очистить()
Описание:
Позволяет очистить список значений, удаляя из него все элементы.
Пример:
СписокТиповЦен.Очистить() ;
Сдвинуть (Move)
Синтаксис:
Сдвинуть (< Элемент>, <Смещение>)
Параметры:
<Элемент> Обязательный
Тип: Число, ЭлементСписка Значений. Индекс сдвигаемого элемента списка либо сам элемент.
<Смещение> Обязательный
Тип: Число. Количество позиций, на которое следует сдвинуть элемент. Положительное значение соответствует смещению элемента в сторону конца списка (увеличение индекса), отрицательное - к началу.
Описание:
Позволяет сдвинуть элемент списка значений на заданное количество позиций вперед или назад.
Пример:
// Сдвигаем первый элемент "вниз"
Список.Сдвинуть(0,1);
Скопировать (Copy)
Синтаксис:
Скопировать()
Возвращаемое значение:
Тип: СписокЗначений. Созданный список значений.
Описание:
Позволяет создать копию списка значений.
Пример:
КопияСписка = СписокТиповЦен.Скопировать();
СортироватьПоЗначению (SortByValue)
Синтаксис:
СортироватьПоЗначению(< Направление> )
Параметры:
<Направление> Необязательный
Тип: системное перечисление ТипСортировки. Способ сортировки - по возрастанию или по убыванию.
Значение по умолчанию: Возр.
Описание:
Позволяет упорядочить список значений в порядке возрастания или убывания хранимых элементами значений.
Пример:
СписокТиповЦен.СортироватьПоЗначению(ТипыСортировки.Возр);
СортироватьПоПредставлению (SortByPresent)
Синтаксис:
СортироватьПоПредставлению(< Направление>)
Параметры:
<Направление> Необязательный
Тип: системное перечисление ТипСортировки. Способ сортировки - по возрастанию или по убыванию.
Значение по умолчанию: Возр.
Описание:
Позволяет упорядочить список значений по возрастанию или по убыванию в алфавитном порядке представлений входящих в состав списка значений элементов.
Пример:
СписокТиповЦен.СортироватьПоПредставлению(ТипыСортировки.Убыв);
Удалить (Remove)
Синтаксис:
Удалить(<Элемент>)
Параметры:
<Элемент> Обязательный
Тип: Число, ЭлементСпискаЗначений. Индекс удаляемого элемента либо сам элемент.
Описание:
Позволяет удалить элемент из списка значений.
Пример:
// удаление по индексу в списке
СписокТиповЦен.Удалить(0);
// удаление по элементу
НайденныйЭлемент = СписокТиповЦен.НайтиПоЗначению(ВыбЗначение);
Если НайденныйЭлемент <> Неопределено Тогда
СписокТиповЦен.Удалить(НайденныйЭлемент);
Иначе
Сообщить("Значение не найдено!");
КонецЕсли,