Конструкторы
Синтаксис:
Новый Картинка(<Имя файла>)
Параметры:
<Имя файла > Обязательный
Тип: Строка. Имя файла, из которого будет загружена картинка.
Описание:
Позволяет загрузить картинку из указанного файла картинки.
Синтаксис:
Новый Картинка()
Описание:
Позволяет сформировать пустую картинку.
Конструкторы
Синтаксис:
Новый ДиалогВыбораФайла(< Режим работы>)
Параметры:
<Режим работы> Обязательный
Тип: РежимДиалогаВыбораФайла. Режим работы конструируемого диалога.
Описание:
Позволяет создать диалог выбора файла с заданным режимом работы.
| «««««««««« | 1С:Предприятие 8.0 | »»»»»»»»»» |
Конструкторы
Синтаксис:
Новый ТекстовыйДокумент()
Описание:
Позволяет создать новый текстовый документ.
| «««««««««« | 1С: Предприятие 8.0 | »»»»»»»»»» |
Конструкторы
Синтаксис:
Новый ТабличныйДокумент()
Описание:
Позволяет создать новый табличный документ.
| «««««««««« | 1С:Предприятие 8.0 | »»»»»»»»»» |
Конструкторы
Синтаксис:
Новый Файл(< Имя>)
Параметры:
<Имя>Обязательный
Полное имя файла или каталога, с которым будет связан конструируемый объект.
Описание:
Позволяет создать новый файловый объект, связанный с указанным файлом.
| «««««««««« | 1С:Предприятие 8.0 | »»»»»»»»»» |
Конструкторы
Синтаксис:
Новый XBase(<Путь к базе>. <Путь к индексу> , <Только чтение>}
Параметры:
<Путь к базе> Необязательный
Тип: Строка. Полное имя файла таблицы базы данных в формате DBF.
<Путь к индексу> Необязательный
Тип: Строка. Путь к индексному файлу таблицы.
<Только чтение> Необязательный
Тип: Булево. Истина - открывать файл только для чтения, Ложь - открывать файл для чтения и записи.
Значение по умолчанию: Ложь
Описание:
Позволяет создать объект XBase. При создании могут быть сразу открыты файлы таблицы и индекса.
См. также:
XBase, метод ОткрытьФайл.
| «««««««««« | 1С:Предприятие 8.0 | »»»»»»»»»» |
Конструкторы
Синтаксис:
Новый КвалификаторыДаты (< Части даты> )
Параметры:
<Части даты> Необязательный
Тип: системное перечисление ЧастиДаты. Допустимые части даты.
Значение по умолчанию: ДатаВремя.
Описание:
Позволяет создать объект, задав допустимые части даты.
Конструкторы
Синтаксис:
Новый ОписаниеТипов(<Типы> , <Квалификаторы числа> , <Квалификаторы строки> , <Квалификаторы даты>)
Параметры:
<Типы> Обязательный
Тип: Массив. Массив значений типа Тип, состоящий из типов, которые будут использованы в объекте.
<Квалификаторы числа> Необязательный
Тип: КвалификаторыЧисла. Квалификаторы числа, описывающие допустимые значения числового типа.
Значение по умолчанию: Если не указан, числа хранить нельзя.
<Квалификаторы строки> Необязательный
Тип: КвалификаторыСтроки. Квалификаторы строки, описывающие допустимые значения строкового типа.
Значение по умолчанию: Если не указан, используется неограниченная длина строки.
<Квалификаторы даты> Необязательный
Тип: КвалификаторыДаты. Квалификаторы даты, описывающие допустимые значения типа Дата.
Значение по умолчанию: Если не указан, используются обе части даты (дата + время)
Описание:
Позволяет создать описание типов на основании заданных типов и квалификаторов для типов Число, Строка, Дата.
На основании объекта ОписаниеТипов
Синтаксис:
Новый ОписаниеТипов (<Исходное ОписаниеТипов > , <Добавляемые типы> , <Вычитаемые типы> , <Квалификаторы числа> , <Квалификаторы строки> , <Квалификаторы даты> )
Параметры:
<Исходное ОписаниеТипов> Необязательный
Тип: ОписаниеТипов. Исходное описание типов, на основании которого будет строиться новое.
<Добавляемые типы> Необязательный
Тип: Массив. Массив, содержащий значения типа Тип, добавляемые к типам, используемых в исходном описании типов.
<Вычитаемые типы> Необязательный
Тип: Массив. Массив, содержащий значения типа Тип, исключаемые из типов, используемых в исходном описании типов.
<Квалификаторы числа> Необязательный
Тип: КвалификаторыЧисла. Квалификаторы числа, описывающие допустимые значения числового типа.
<Квалификаторы строки> Необязательный
Тип: КвалификаторыСтроки. Квалификаторы строки, описывающие допустимые значения строкового типа.
<Квалификаторы даты> Необязательный
Тип: КвалификаторыДаты. Квалификаторы даты, описывающие допустимые значения типа Дата.
Описание:
Позволяет создать описание типов на основании другого описания типов, путем добавления одних и исключения других типов. Если новый квалификатор не указан, будут оставлены Квалификаторы исходного описания типов.
Конструкторы
Синтаксис:
Новый КвалификаторыЧисла(< Число разрядов> , <Число разрядов дробной части> , <Допустимый знак> )
Параметры:
<Число разрядов> Необязательный
Тип: Число. Общее число разрядов числа.
Значение по умолчанию: 0
<Число разрядов дробной части> Необязательный
Число разрядов дробной части числа.
Значение по умолчанию: 0
<Допустимый знак> Необязательный
Тип: системное перечисление ДопустимыйЗнак. Допустимый знак числа.
Значение по умолчанию: Любой.
Описание:
Позволяет создать объект, задав общее число разрядов, число разрядов дробной части и допустимый знак.
Конструкторы
Синтаксис:
Новый КвалификаторыСтроки (< Длина строки>, <Допустимая длина>)
Параметры:
<Длина строки> Необязательный
Тип: Число.
Значение по умолчанию: Если параметр не указан или равен 0, то строка по длине не ограничивается.
<Допустимая длина> Необязательный
Тип: системное перечисление ДопустимаяДлина. Вариант ограничения длины строки, если задана длина строки, отличная от 0.
Описание:
Позволяет создать объект, задав длину строки.
Конструкторы
Синтаксис:
Новый Массив (< Количество элементов 1>, ..., <Количество элементов N> )
Параметры:
<Количество элементов 1>, ..., <Количество элементов N> Необязательный
Тип: Число. Каждый параметр определяет количество элементов массива в соответствующем измерении. Может задаваться неограниченное количество параметров.
Значение по умолчанию: Если ни один параметр не указан, создается одномерный массив с нулевым количеством элементов.
Описание:
Позволяет создать массив из указанного количества элементов. Если задано несколько параметров, то будет создан массив, элементами которого являются массивы (и т.д. в зависимости от количества параметров). Фактически, конструктор позволяет создать массивы массивов, которые могут являться аналогом многомерного массива.
| «««««««««« | 1С:Предприятие 8.0 | »»»»»»»»»» |
Конструкторы
Синтаксис:
Новый Структура (<Ключи>)
Параметры:
<Ключи> Необязательный
Тип: Строка. Строка, содержащая имена ключей, разделенные запятыми.
Описание:
Позволяет создать структуру с ключами, значения которых передаются в параметре конструктора.
Конструкторы
Синтаксис:
Новый Шрифт(< Имя шрифта>, <Размер>, <Жирный>, <Наклонный> , <Подчеркнутый> , <3ачеркнутый>)
Параметры:
<Имя шрифта> Необязательный
Тип. Строка. Системное наименование шрифта.
Значение по умолчанию: Пустая строка, то есть не изменять относительно стиля.
<Размер> Необязательный
Тип: Число. Размер шрифта.
Значение по умолчанию: -1, то есть не изменять относительно стиля
<Жирный> Необязательный
Тип: Булево. Признак жирности шрифта.
Значение по умолчанию: Неопределено, то есть не изменять относительно стиля.
<Наклонный> Необязательный
Тип. Булево. Признак наклонного начертания шрифта.
Значение по умолчанию: Неопределено, то есть не изменять относительно стиля.
<Подчеркнутый> Необязательный
Тип Булево. Признак подчеркнутого начертания шрифта.
Значение по умолчанию: Неопределено, то есть не изменять относительно стиля.
<3ачеркнутый> Необязательный
Тип. Булево. Признак зачеркнутого начертания шрифта.
Значение по умолчанию: Неопределено, то есть не изменять относительно стиля
Описание:
Используется для формирования шрифта из отдельных параметров
Синтаксис:
Новый Шрифт(<Шрифт>, <Ими шрифта>, <Размер> , <Жирный>, <Наклонный>, <Подчеркнутый>, <3ачеркнутый>)
Параметры:
<Шрифт> Обязательный
Тип Шрифт Шрифт, на основании которого будет формироваться новый шрифт.
<Имя шрифта> Необязательный
Тип Строка. Системное наименование шрифта.
Значение по умолчанию: Пустая строка, то есть не изменять относительно исходного шрифта.
<Размер> Необязательный
Тип Число. Размер шрифта.
Значение по умолчанию: -1, то есть не изменять относительно исходного шрифта.
<Жирный> Необязательный
Тип Булево. Признак жирности шрифта.
Значение по умолчанию: Неопределено, то есть не изменять относительно исходного шрифта.
<Наклонный> Необязательный
Тип Булево. Признак наклонного начертания шрифта.
Значение по умолчанию: Неопределено, то есть не изменять относительно исходного шрифта.
<Подчеркнутый> Необязательный
Тип Булево. Признак подчеркнутого начертания шрифта.
Значение по умолчанию: Неопределено, то есть не изменять относительно исходного шрифта.
<3ачеркнутый> Необязательный
Тип- Булево. Признак зачеркнутого начертания шрифта.
Значение по умолчанию: Неопределено, то есть не изменять относительно исходного шрифта.
Описание:
Используется для формирования шрифта на основании имеющегося шрифта. Все параметры могут быть взяты из исходного шрифта, при этом параметры, указанные в конструкторе, имеют приоритет над исходными.
| «««««««««« | 1С:Предприятие 8.0 | »»»»»»»»»» |
Конструкторы
Синтаксис:
Новый Рамка(< Тип рамки>, <Толщина>)
Параметры:
<Тип рамки> Обязательный
Тип: системное перечисление ТипРамкиЭлементаУправления. Тип рамки.
<Толщина> Необязательный
Тип: Число. Толщина рамки (в логических единицах). Значение по умолчанию: 1
Описание:
Позволяет создать рамку требуемого типа и толщины.
Конструкторы
Синтаксис:
Новый Линия (< Тип линии> , <Толщина>)
Параметры:
<Тип линии> Обязательный
Тип: ТипЛинииРисункаТабличногоДокумента, ТипЛинииЯчейкиТабличногоДокумента, ТипЛинииДиаграммы. Тип линии. Тип параметра зависит от того, в каком объекте будет использоваться линия.
<Толщина> Необязательный
Тип: Число. Толщина линии (в логических единицах).
Описание:
Позволяет создать линию заданного типа и толщины
| «««««««««« | 1С:Предприятие 8.0 | »»»»»»»»»» |
Конструкторы
Синтаксис:
Новый Действие(< Имя процедуры>)
Параметры:
<Имя процедуры> Обязательный
Тип: Строка. Имя процедуры модуля.
Описание:
Предназначен для формирования объекта из процедуры модуля.
Конструкторы
Синтаксис:
Новый СочетаниеКлавиш(< Клавиша>, <Alt>, <Control>, <Shift>)
Параметры:
<Клавиша> Необязательный
Тип: системное перечисление Клавиша. Основная клавиша сочетания.
<Alt> Необязательный
Тип: Булево. Истина - комбинация клавиш включает Alt, Ложь - иначе.
<Сопtrol> Необязательный
Тип: Булево. Истина - комбинация клавиш включает Control, Ложь - иначе.
<Shift> Необязательный
Тип: Булево. Истина - комбинация клавиш включает Shift, Ложь - иначе.
Описание:
Позволяет сформировать сочетание из заданной клавиши и клавиш Alt, Control и Shift.
Конструкторы
Синтаксис:
Новый Соответствие()
Описание:
Позволяет создать пустое соответствие (без элементов).
Конструкторы
Синтаксис:
Новый Запрос (<Текст запроса>)
Параметры:
<Текст запроса> Необязательный
Тип: Строка. Текст запроса. Значение по умолчанию: Пустая строка.
Описание:
Позволяет создать запрос с указанным текстом.
Конструкторы
Синтаксис:
Новый НастройкаПериода()
Описание:
Позволяет создать новую настройку периода. По умолчанию у созданного объекта свойства определены следующим образом:
• РедактироватьКакИнтревал - Истина;
• РедактироватьКакПериод - Истина;
• ВариантНачала - ВезОграничения;
• ВариантОкончания - БезОграничения;
• ВариантНастройки - Интервал.
Конструкторы
Синтаксис:
Новый МоментВремени (<Дата>. <Ссылка>)
Параметры:
<Дата> Обязательный
Тип: Дата. Дата и время.
<Ссылка> Необязательный
Тип: Любая ссылка на объект ИБ. Ссылка на любой объект в базе данных.
Описание:
Позволяет сформировать момент времени по дате и ссылке на объект в базе данных.
Конструкторы
Синтаксис:
Новый Граница (< Значение> , <Вид границы> )
Параметры:
<3начение> Обязательный
Значение границы.
<Вид границы> Необязательный
Тип: ВидГраницы. Включение/исключение граничного значения.
Значение по умолчанию: Если параметр не задан, используется вариант границы с включением граничного значения.
При определении значения параметра используется системное перечисление ВидГраницы ( BoundKind).
Описание:
Позволяет создать новую границу с заданными характеристиками.
| «««««««««« | 1С:Предприятие 8.0 | »»»»»»»»»» |
Красный (R)
Использование:
Только чтение.
Описание:
Тип: Число. Содержит красную составляющую цвета.
Примечание:
Если цвет задан не абсолютным, то содержит -1.
Критерии отбора
Критериями отбора задаются предопределенные правила, по которым может выполняться отбор документов в списках и журналах документов, элементов справочников в списках справочников.
Критерии отбора могут иметь одну или несколько форм для визуального представления результатов отбора.
Настройка критериев отбора производится на этапе конфигурирования прикладной задачи.
КритерииОтбораМенеджер ( FiltersManager )
Объект предназначен для управления критериями отбора и предоставляет доступ к значениям типа КритерииОтбораМенеджер. Доступ к объекту осуществляется через свойство глобального контекста КритерииОтбора.
Данный объект является коллекцией значений. В качестве элемента коллекции выступает значение типа КритерииОтбораМенеджер.<Имя критерия> Для объекта доступен обход коллекции посредством оператора Для каждого ... из ... Цикл. При обходе выбираются элементы коллекции.
Пример:
ФормаОтб = КритерииОтбора.Контрагенты.ПолучитьФорму("ОсновнаяФорма");
См. также:
Глобальный контекст, свойство КритерииОтбора.
КритерииОтбораМенеджер. < Имя критерия>
Предназначен для управления критерием отбора, как объектом конфигурации. С помощью этого объекта можно получить ссылки на объекты, отобранные по критерию и работать с формами конкретного критерия отбора. Доступ к объекту осуществляется через свойство объекта КритерииОтбораМенеджер.
Полное имя типа объекта определяется с учетом имени критерия отбора конфигурации. Например, для критерия отбора Контрагенты имя типа будет выглядеть КригерийОтбораМенеджер.Контрагенты.
КритерийОтбораСписок.<Имя критерия>
Предназначен для управления списком отобранных документов и/или элементов справочников, отображаемых в табличном поле (списком критерия отбора).
КвалификаторыЧисла (NumericQualifiers)
Используется для описания допустимых значений числового типа.
Пример:
Знак = ДопустимыйЗнак.Неотрицательный;
ПараметрыЧисла = Новый КвалификаторыЧисла (10, 2, Знак);
См. также:
ОписаниеТипов, свойство КвалификаторыЧисла.
КвалификаторыДаты (DateQualifiers)
Используется для описания допустимых значений типа Дата.
Пример:
ПараметрыДаты = Новый КвалифихаторыДаты(ЧастиДаты,Дата);
См. также:
ОписаниеТипов, свойство КвалификаторыДаты.
КвалификаторыСтроки (StringQualifiers)
Используется для описания допустимых значений строкового типа.
Пример:
ПараметрыСтроки = Новый КвалификаторыСтроки(20);
См. также:
ОписаниеТипов, свойство КвалификаторыСтроки.
Линия (Line)
Объект предназначен для определения и хранения параметров линии. Используется для определения типов линий, используемых в объектах ОбпастьТабличногоДокумента, РисунокТабличногоДокумента, ОбластьПостроения диаграммы.
Логические выражения в языке запросов
В языке запросов в операциях выбора и в условиях отборов используются логические выражения:
<Выражение> |
<Выражение> <Операция сравнения> <Выражение> |
<Выражение> [НЕ] В [ИЕРАРХИИ] (<Список значений>)
<Выражение> [НЕ] В [ИЕРАРХИИ] <Описание запроса> |
<Выражение> [НЕ] МЕЖДУ <Выражение> И <Выражение> |
<Выражение> ЕСТЬ [НЕ] NULL |
<Выражение> ССЫЛКА <Имя таблицы> |
<Выражение> [НЕ] ПОДОБНО <Литерал типа СТРОКА> [СПЕЦСИМВОЛ <Литерал типа СТРОКА>]
> | < | = | >= | <= | <>
<Выражение> [, <Выражение> [, ...] ]
Логическим выражением может быть:
• обычное <Выражение> языка запросов, если его результат имеет логический тип;
• <Операция сравнения> двух выражений языка запросов; выполняются в соответствии с правилами сравнения значений описанными на стр. 360;
• оператор проверки совпадения / не совпадения значения выражения с одним из перечисленных или со значениями, содержащимися в результате другого запроса;
• оператор проверки вхождения значения выражения в диапазон;
• оператор проверки значения выражения на NULL;
• оператор проверки ссылочного значения выражения на ссылку на определенную таблицу;
• оператор проверки строкового значения на подобие шаблону.
При сравнении значений используются правила сравнения значений, описанные на стр. 360.
Правила сравнения значений
Поскольку в языке запросов могут сравниваться значения разных типов, определены правила, по которым выполняется сравнение двух значений. Данные правила используются для:
• сравнения значений в операторах сравнения;
• определения максимального и минимального значений в агрегатных функциях МИНИМУМ и МАКСИМУМ;
• упорядочивания записей результата запроса в соответствии с порядком, заданным в предложении УПОРЯДОЧИТЬ ПО.
Если типы значений отличаются друг от друга, то отношения между значениями определяются на основании приоритета типов:
• тип NULL (самый низший);
• тип булево;
• тип число;
• тип дата;
• тип строка;
• ссылочные типы.
Отношения между различными ссылочными типами определяются на основе ссылочных номеров таблиц, соответствующих тому или иному типу.
Если типы данных совпадают, то производится сравнение значений по следующим правилам:
• у типа булево значение ИСТИНА больше значения ЛОЖЬ;
• у типа число обычные правила сравнения для чисел;
• у типа дата более ранние даты меньше более поздних;
• у типа строка сравнения производится в соответствии с установленными национальными особенностями базы данных;
• ссылочные типы сравниваются на основе своих значений (номера записи и т. п.).
Важно!
Любая операция сравнения двух значений, в которой участвует хотя бы одно значение NULL, дает результат, аналогичный значению ЛОЖЬ.
Оператор проверки совпадения значения с одним из перечисленных
Оператор В
позволяет проверить, совпадает ли значение выражения, указанного справа от него, с одним из значений, описанных слева. Если совпадает хотя бы с одним - результатом оператора будет ИСТИНА, иначе - ЛОЖЬ. Применение НЕ изменяет действие оператора на обратное. Сравнение значений производится по правилам, описанным на стр. 360.
Пример:
Выбрать
Справочник.Номенклатура.Наименование
Где
Справочник.Номенклатура.Родитель.Наименование В ("Бытовая техника", "Оргтехника")
Для справочников проверка может осуществляться и на принадлежность по иерархии. Результатом оператора В ИЕРАРХИИ будет ИСТИНА, если значение выражения слева является ссылкой на элемент справочника и входит во множество значений справа или иерархически принадлежит какой-нибудь группе, содержащейся в этом множестве.
Пример:
//В качестве параметра Группа в запрос передается ссылка
//на какую-либо группу справочника Номенклатура.
Выбрать
Справочник.Номенклатура.Наименование
Где
Справочник.Номенклатура.Ссылка В ИЕРАРХИИ (&Группа)
В качестве множества значений, на совпадение с которыми выполняется проверка, может фигурировать и результат запроса. В этом случае справа от оператора В необходимо указать описание запроса.
Пример:
Выбрать
Справочник.Номенклатура.Наименование
Где
Справочник.Номенклатура.Ссылка В ИЕРАРХИИ
(ВЫБРАТЬ
Справочник.Номенклатура.Ссылка
ГДЕ
Справочник.Номенклатура.Наименование = "Одежда" )
Оператор проверки вхождения значения в диапазон
Оператор МЕЖДУ позволяет проверить, входит ли значение выражения, указанного справа от него, в диапазон, указанный слева. Если входит - результатом оператора будет ИСТИНА, иначе -ЛОЖЬ Применение НЕ изменяет действие оператора на обратное. Сравнение значений производится по правилам, описанным на стр. 360.
Пример:
Выбрать
Справочник.Номенклатура.Наименование,
Справочник.Номенклатура.ЗакупочнаяЦена
Где
Справочник.Номенклатура.ЗакупочнаяЦена МЕЖДУ 100 И 1000
Оператор проверки значения на NULL
Оператор ЕСТЬ NULL позволяет проверить значение выражения слева от него на NULL. Если значение равно NULL результатом оператора будет ИСТИНА, иначе - ЛОЖЬ. Применение НЕ изменяет действие оператора на обратное.
Пример:
Выбрать
Справочник.Номенклатура.Наименование,
Справочник.Номенклатура.ЗакупочнаяЦена
Где
Справочник.Номенклатура.ЗакупочнаяЦена Есть NULL
Оператор проверки ссылочного значения
Оператор ССЫЛКА позволяет проверить, является ли значение выражения, указанного справа от него, ссылкой на таблицу, указанную слева Если да - результатом оператора будет ИСТИНА, иначе - ЛОЖЬ. Разыменование таблиц описано на стр. 345.
Пример:
ВЫБРАТЬ
Справочник.Номенклатура.Наименование,
Справочник.Номенклатура.ЕдиницаИзмерения
ГДЕ
Справочник.Номенклатура.ЕдиницаИзмерения ССЫЛКА Справочник.ЕдиницыИзмерения
Оператор проверки строки на подобие шаблону
Оператор ПОДОБНО позволяет сравнить значение выражения, указанного слева от него, со строкой шаблона, указанной справа. Значение выражения должно иметь тип строка. Если значение выражения удовлетворяет шаблону - результатом оператора будет ИСТИНА, иначе - ЛОЖЬ.
Следующие символы в строке шаблона являются служебными и имеют смысл, отличный от символа строки:
• % (процент): последовательность, содержащая любое количество произвольных символов
• _ (подчеркивание): один произвольный символ.
• [...] (в квадратных скобках один или несколько символов): любой одиночный символ из перечисленных внутри квадратных скобок. В перечислении могут встречаться диапазоны, например a-z, означающие произвольный символ, входящий в диапазон, включая концы диапазона.
• [^...] (в квадратных скобках значок отрицания, за которым следует один или несколько символов): любой одиночный символ, кроме тех, которые перечислены следом за значком отрицания.
Любой другой символ означает сам себя и не несет никакой дополнительной нагрузки.
Если в качестве самого себя необходимо записать один из перечисленных символов, то ему должен предшествовать <Спецсимвол>. Сам <Спецсимвол> (любой подходящий символ) определяется в этом же операторе после ключевого слова СПЕЦСИМВОЛ.
Например, шаблон "%АБВ[0-9][абвг]\_абв%" СПЕЦСИМВОЛ "\" означает подстроку, состоящую из последовательности символов:
буквы А, буквы Б; буквы В; одной цифры, одной из букв а, 6, в или г; символа подчеркивания; буквы а; буквы б; буквы в. Причем перед этой последовательностью может располагаться произвольный набор символов.
| «««««««««« | 1С:Предприятие 8.0 | »»»»»»»»»» |
Массив
Объекты этого типа представляют собой упорядоченную совокупность значений любого типа, в том числе и типа массив, что, в частности, позволяет организовывать многомерные массивы.
Массив (Array)
Предназначен для доступа к элементам массива, его методам и конструктору.
Данный объект является коллекцией значений. Для объекта доступен обход коллекции посредством оператора Для каждого ... из ... Цикл. При обходе выбираются значения элементов массива. Возможно обращение к значению элемента посредством оператора [...]. В качестве аргумента передается индекс значения.
Пример:
М = Новый Массив(4);
Сообщить("Количество: " +М.Количество());
Сообщить("Наибольший индекс массива: " +М.ВГраница());
М.Удалить(2);
Сообщить("Количество после удаления: "+М.Количество());
// Этот элемент массива имеет тип Строка:
М.Добавить("Добавили строку");
// Этот элемент массива имеет тип Число:
М.Добавить(123.45);
Сообщить("Количество после добавления: " +М.Количество());
// Добавим элемент по индексу, большему, чем: ВГраница():
М.Вставить(8,"Метод добавил 4 новых элемента");
Сообщить("Количество после добавления: "+М.Количество)));
// Массив может хранить разные типы данных:
Сообщить("Типы элементов: "+Символы.ПС+
" Для 3-го элемента: "+ТипЗнч(М[3])+Символы.ПС+
" Для 4-го элемента: "+ТипЗнч(М[4])+Символы.ПС+
" Для 5-го элемента: "+ТипЗнч(М[5]));
Результат выполнения:
Количество: 4
Наибольший индекс массива: 3
Количество после удаления: 3
Количество после добавления: 5
Количество после добавления: 9
Типы элементов:
Для 3-го элемента: Строка
Для 4-го элемента: Число
Для 5-го элемента: Неопределено
МенеджерВнешнихОбработок ( ExternalProcessingsManager )
Объект предназначен для управления внешними обработками и позволяет получать значения типа ВнешняяОбработка при помощи метода Создать. Доступ к объекту осуществляется через свойство глобального контекста ВнешниеОбработки.
Месяц (Month)
| «««««««««« | 1С:Предприятие 8.0 | »»»»»»»»»» |
Синтаксис:
Месяц(<Дата>)
Параметры:
<Дата> - Обязательный
Тип: Дата. Исходная дата.
Возвращаемое значение:
Тип: Число. Месяц в указанной дате.
Описание:
Определяет месяц в указанной дате.
Синтаксис:
Минута (<Дата>)
Параметры:
<Дата> - Обязательный
Тип: Дата. Исходная дата.
Возвращаемое значение:
Тип: Число. Минута в указанной дате.
Описание:
Определяет минуту в указанной дате.
Синтаксис:
НачалоГода (< Дата> )
Параметры:
<Дата> - Обязательный
Тип: Дата. Исходная дата.
Возвращаемое значение:
Тип: Дата. Дата и время начала года.
Описание:
Определяет дату и время начала года для указанной даты.
Синтаксис:
НачалоДня(<Дата>)
Параметры:
<Дата> - Обязательный
Тип: Дата. Исходная дата.
Возвращаемое значение:
Тип: Дата. Дата и время начала дня.
Описание:
Определяет дату и время начала дня для указанной даты.
НачалоКвартала (BeginOfQuarter)
Синтаксис:
НачалоКвартала (< Дата>)
Параметры:
<Дата> - Обязательный
Тип: Дата. Исходная дата.
Возвращаемое значение:
Тип: Дата. Дата и время начала квартала.
Описание:
Определяет дату и время начала квартала для указанной даты.
Синтаксис:
НачалоМесяца(< Дата>)
Параметры:
<Дата> - Обязательный
Тип: Дата. Исходная дата.
Возвращаемое значение:
Тип: Дата. Дата и время начала месяца.
Описание:
Определяет дату и время начала месяца для указанной даты.
Синтаксис:
НачалоМинуты (< Дата>)
Параметры:
<Дата> - Обязательный
Тип: Дата. Исходная дата.
Возвращаемое значение:
Тип: Дата. Дата и время начала минуты.
Описание:
Определяет дату и время начала минуты для указанной даты.
Синтаксис:
НачалоНедели(<Дата>)
Параметры:
<Дата> - Обязательный
Тип: Дата. Исходная дата.
Возвращаемое значение:
Тип: Дата. Дата и время начала недели.
Описание:
Определяет дату и время начала недели для указанной даты.
НачалоЧаса (BeginOfHour)
Синтаксис:
НачалоЧаса(<Дата>)
Параметры:
<Дата> - Обязательный
Тип: Дата. Исходная дата.
Возвращаемое значение:
Тип: Дата. Дата и время начала часа.
Описание:
Определяет дату и время начала часа для указанной даты.
Неделя Года (WeekOfYear)
Синтаксис:
НеделяГода(<Дата>)
Параметры:
<Дата> - Обязательный
Тип: Дата. Исходная дата.
Возвращаемое значение:
Тип: Число. Номер недели в году.
Описание:
Определяет номер недели в году для указанной даты.
Секунда (Second)
Синтаксис:
Секунда(<Дата>)
Параметры:
<Дата> - Обязательный
Тип: Дата. Исходная дата.
Возвращаемое значение:
Тип: Число. Секунда в указанной дате.
Описание:
Определяет секунду в указанной дате.
ТекущаяДата (CurrentDate)
Синтаксис:
ТекущаяДата()
Возвращаемое значение:
Тип: Дата. Текущая (системная) дата.
Описание:
Определяет текущую (системную) дату на компьютере.
Час (Hour)
Синтаксис:
Час(<Дата>)
Параметры:
<Дата> - Обязательный
Тип: Дата. Исходная дата.
Возвращаемое значение:
Тип: Число. Час в указанной дате.
Описание:
Определяет час в указанной дате.
| «««««««««« | 1С:Предприятие 8.0 | »»»»»»»»»» |
Методы
Синтаксис:
Получить()
Возвращаемое значение:
Тип: Произвольный. Значение, содержащееся в хранилище.
Описание:
Метод позволяет извлечь из хранилища сохраненное в нем значение.
Пример:
МояКартинка = ХраиилищеКартинки.Получить();
Методы
Синтаксис:
Записать(<Имя файла> )
Параметры:
<Имя файла> Обязательный
Тип: Строка. Полное имя файла, в котором будет сохранена картинка. Если имя каталога не указано, то картинка будет сохранена в каталог исполняемых файлов программы.
Описание:
Позволяет сохранить картинку в файл с указанным именем.
Пример:
Картинка.Записать("С:\Му Documents\My Pictures\Miome.bmp");
ФильтрИменФайлов (FileNameFilter)
Синтаксис:
ФильтрИменФайлов()
Возвращаемое значение:
Тип: Строка. Фильтр для диалога выбора файлов.
Описание:
Позволяет получать фильтры для диалога выбора файлов, соответствующие формату картинки.
Пример:
ФильтрДиалога = Картинка.ФильтрИменФайлов();
Методы
Синтаксис:
Выбрать()
Возвращаемое значение:
Тип: Булево. Истина - выбор/сохранение завершено успешно, Ложь - иначе.
Описание:
Открывает окно диалога выбора файла.
Пример:
ДиалогОткрытияФайда.Выбрать();
Методы
Синтаксис:
ВставитьСтроку (<Номер строки> , < Строка>)
Параметры:
<Номер строки> Обязательный
Тип: Число. Номер вставляемой строки.
<Строка> Обязательный
Тип: Строка. Вставляемая строка.
Описание:
Вставляет в текстовый документ строку с указанным номером.
Пример:
ТекстДок.ВставитьСтроку(23, "Новая строка");
Синтаксис:
ДобавитьСтроку (<Строка>)
Параметры:
<Строка> Необязательный
Тип: Строка. Добавляемая строка.
Описание:
Добавляет строку в конец текстового документа.
Пример:
ТекстДок.ДобавитьСтроку("Новая строка");
Синтаксис:
ЗаменитьСтроку (<Номер строки> , <Строка>)
Параметры:
<Номер строки> Обязательный
Тип: Число. Номер замещаемой строки.
<Строка> Обязательный
Тип: Строка. Замещающая строка.
Описание:
Заменяет строку с указанным номером на переданную.
Пример:
ТекстДок.ЗаменитьСтроку(23, "Строка с исправлениями");
Синтаксис:
Записать(<Имя файла>, <Тип файла>)
Параметры:
<Имя файла> Обязательный
Тип: Строка. Имя файла для сохранения текста.
<Тип файла> Необязательный
Тип: ТипКодировкиТекста. Тип кодировки файла. Значение по умолчанию: UTF8.
При определении значения параметра используется системное перечисление ТипКодировкиТекста.
Описание:
Записывает текстовый документ в файл с указанным именем.
Пример:
ТекстДок.Записать("price.txt");
КоличествоСтрок (LinesCount)
Синтаксис:
КоличествоСтрок()
Возвращаемое значение:
Тип: Число. Количество строк в тексте.
Описание:
Получает количество строк в тексте.
Пример:
ВсегоСтрок = Текст.КоличествоСтрок();
Очистить (Clear)
Синтаксис:
Очистить()
Описание:
Очищает содержимое текстового документа.
Пример:
ТекстДок.Очистить();
Показать (Show)
Синтаксис:
Показать (< Заголовок> , <Имя файла>)
Параметры:
<3аголовок> Необязательный
Тип: Строка. Заголовок окна редактирования. Значение по умолчанию: Пустая строка.
<Имя файла> Необязательный
Тип: Строка. Имя файла, в котором будет предлагаться сохранение текста при закрытии окна текстового редактора. Если файла с указанным именем не существует, то будет создан новый файл с таким именем для сохранения текста.
Значение по умолчанию: Пустая строка - не предлагать сохранение текста в файле.
Описание:
Открывает текст в текстовом редакторе 1C: Предприятия для просмотра и редактирования.
Пример:
ТекстДок.Показать("Редактирование прайс-листа", "catalog.txt");
ПолучитьСтроку (GetLine)
Синтаксис:
ПолучитьСтроку(< Номер строки> )
Параметры:
<Номер строки> Обязательный
Номер строки текста.
Возвращаемое значение:
Тип: Строка.
Описание:
Получает строку текстового документа по номеру.
Пример:
Стр = Текст.ПолучитьСтроку(Ном);
ПолучитьТекст (GetText)
Синтаксис:
ПолучитьТекст()
Возвращаемое значение:
Тип: Строка. Строка, содержащая текст из текстового документа.
Описание:
Получает текст, находящийся в текстовом документе.
Прочитать (Read)
Синтаксис:
Прочитать(<Имя файла>, <Tип файла>)
Параметры:
<Имя файла> Обязательный
Тип: Строка. Имя текстового файла.
<Тип файла> Необязательный
Тип: ТипКодировкиТекста. Тип кодировки текстового файла. Значение по умолчанию: UTF8.
При определении значения параметра используется системное перечисление ТипКодировкиТекста.
Описание:
Считывает текстовый документ из файла.
Пример:
ТекстДок.Прочитать("catalog.txt"); :
УдалитьСтроку (DeleteLine)
Синтаксис:
УдалитьСтроку(<Номер строки>)
Параметры:
<Номер строки> Обязательный
Тип: Число. Номер удаляемой строки.
Описание:
Удаляет из текстового документа строку с указанным номером.
Пример:
ТекстДок.УдалитьСтроку(23);
УстановитьТекст (SetText)
Синтаксис:
УстановитьТекст (< Текст для установки> )
Параметры:
<Текст для установки> Обязательный
Тип: Строка. Текст, помещаемый в текстовый документ.
Описание:
Помещает в текстовый документ текст из переданной строки. Текст, содержащийся в текстовом документе до исполнения метода, удаляется.
Пример:
ТекстовыйДокумент.УстановитьТекст("
|Этот
| текст
| установлен на строки");
Методы
Синтаксис:
ВставитьОбласть(< Исходная область>, <Область приемник>, <Сдвиг>)
Параметры:
<Исходная область> Обязательный
Тип: ОбластьЯчеекТабличногоДокумента. Исходная область.
<0бласть приемник> Необязательный
Тип: ОбластьЯчеекТабличногоДокумента. Область-приемник.
Значение по умолчанию: Если параметр не задан, то сразу за исходной областью.
<Сдвиг> Необязательный
Тип: ТипСмещенияТабличногоДокумента. Определяет смещение ячеек таблицы при вставке.
Значение по умолчанию: БезСмещения.
При определении значения параметра используется системное перечисление ТипСмещенияТабличногоДокумента.
Описание:
Вставляет копию исходной области табличного документа в область-приемник.
Примечание:
Если размеры исходной области не соответствуют результирующей области, то при выполнении метода возникает ошибка.
Пример:
ТабДок = Новый ТабличныйДокумеит;
ИТОГ = 0;
Для К=1 По 10 Цикл
ТабДок.Область("R" + (K+1) +"С1").Текст = "Строка "+К;
ТабДок.О6ласть("R" + (К+1) + "С2").Текст = К*10;
Итог = Итог+К*10;
КонецЦикла;
ТабДок.ВставитьОбласть(ТабДок.Область("R2"), ТабДок.Область("R3"),
ТипСмещенияТабличногоДокумента.ПоГоризонтали);
ТабДок.Область("R2C1").Текст = "Итого:";
ТабДок.Область("R2C2").Текст = Итог;
Рамка = Новый Линия(ТипЛинииЯчейкиТабличногоДокумента.Сплошная, 1);
ТабДок.Область("R2С1:R2С2").Обвести(,Рамка,,Рамка);
ТабДок.ОтображатьСетку = Ложь;
ТабДок.Защита = Ложь;
ТабДок.ТолькоПросмотр = Истина;
ТабДок.Показать("Пример использования метода ВставитьОбласть()");
Синтаксис:
Вывести (< Таблица>, <Уровень> , <Имя группы>, <Открыта>)
Параметры:
<Таблица> Обязательный
Тип: ТабличныйДокумент. Выводимая таблица.
<Уровень> Необязательный
Тип: Число. Уровень используется для автоматической группи ровки строк табличного документа. Соседние строки с одинаковым уровнем будут отнесены к одной группе.
<Имя группы> Необязательный
Тип: Строка. Название группы, к которой относятся выводимые строки.
Значение по умолчанию: Пустая строка.
<Открыта> Необязательный
Тип: Булево. Истина - выведенная группа будет открыта, Ложь - группа будет выведена в свернутом виде.
Значение по умолчанию: Истина.
Описание:
Выводит табличный документ в результирующий табличный документ, добавляя его со следующей строки вслед за самой нижней выведенной строкой, начиная с первой колонки.
Пример:
ТабДок = Новый ТабличныйДокумент;
Секция = ТабДок.ПолучитьОбласть("R1");
Секция.Область("R1C1").Текст = "Численность сотрудников";
ТабДок.НачатьАвтогруппировкуСтрок();
ТабДок.Вывести(Секция,1,"Группа",Истина);
Итого = 0;
Для Н=1 По 3 Цикл
Значение = Н; Итог = 0;
Секция.Область("R1С1").Текст = "Отдел "+Н;
Секция.Область("R1C2") .Текст = "";
ТабДок.Вывести(Секция,2,"Группа 1",Истина);
Секция.Область("R1C1").Текст = "Группа";
Секция.Область("R1C2") .Текст = "Численность";
ТабДок.Вывести(Секция,2,"Группа 1",Истина);
Для К=1 По 10 Цикл
Секция.Область("R1C1").Текст = "А"+Н+К;
Секция.Область("R1C2").Текст = Значение;
ТабДок.Вывести(Секция,3,"Группа 2",Истина);
Итог = Итог + Значение;
Значение = Значение + 10;
КонецЦикла;
Секция.Область("R1C1").Текст = "Итого"+Н;
Секция.Область("R1C2").Текст = Итог;
ТабДок.Вывести(Секция,2,"Группа 1",Истина);
Секция.Область("R1C1:R1C2").Текст = "";
ТабДок.Вывести(Секция);
Итого = Итого + Итог;
КонецЦикла;
Секция.Область("R1С1").Текст = "Всего:";
Секция.Область("R1C2").Текст = Итого;
ТабДок.Вывести(Секция,1,"Группа",Истина);
ТабДок.ЗакончитьАвтогруппировкуСтрок();
ТабДок.ИтогиСнизу = Истина;
ТабДок.ОтображатьСетку = Ложь;
ТабДок.Защита = Ложь;
ТабДок.ТолькоПросмотр = Истина;
ТабДок.Показать("Пример использования верт. группировки");
См. также:
ТабличныйДокумент, метод Присоединить.
ВывестиВертикальныйРазделительСтраниц (PutVerticalPageBreak)
Синтаксис:
ВывестиВертикальныйРазделительСтраниц()
Описание:
Вставляет в результирующую таблицу вертикальный разделитель страниц.
Пример:
ТабДок.ВывестиВертикальныйРазделительСтраниц() ;
ВывестиГоризонтальныйРазделительСтраниц (PutHorizontalPageBreak)
Синтаксис:
ВывестиГоризонтальныйРазделительСтраниц()
Возвращаемое значение:
Тип: Число.
Описание:
Вставляет в результирующую таблицу горизонтальный разделитель страниц.
Пример:
ТабДок.ВывестиГоризонтальныйРазделительСтраниц() ;
ЗакончитьАвтогруппировкуКолонок (EndColumnsAutoGroup)
Синтаксис:
ЗакончитьАвтогруппировкуКолонок()
Описание:
Заканчивает автоматическую группировку колонок, ранее начатую методом НачатьАвтогруппировкуКолонок.
Пример:
ТабДок.ЗакончитьАвтогруппировкуКолонок();
См. также:
ТабличныйДокумент, метод НачатьАвтогруппировкуКолонок.
ЗакончитьАвтогруппировкуСтрок(EndRowsAutoGroup)
Синтаксис:
ЗакончитьАвтогруппировкуСтрок()
Описание:
Заканчивает автоматическую группировку строк, ранее начатую при помощи метода НачатьАвтогруппировкуСтрок.
Пример:
ТабДок.ЗакончитьАвтогруппировкуСтрок() ;
См. также:
ТабличныйДокумент, метод НачатьАвтогруппировкуСтрок.
3aкончитьГруппуКолонок(EndColumnsGroup)
Синтаксис:
ЗакончитьГруппуКолонок()
Описание:
Закадчивает последнюю из начатых ранее групп колонок.
Пример:
ТабДок.НачатьГруппуКолонок("По всем складам", Истина);
//...
ТабДок.начатьГруппуКолонок("На складе", Истина);
//...
ТабДок.ЗакончитьГруппуКолонок (); // окончить группу "На складе"
ТабДок.ЗакончитьГруппуКолонок(); // окончить группу "По всем складам"
См. также:
ТабличныйДокумент, метод НачатьГруппуКолонок.
ЗакончитьГруппуСтрок(EndRowsGroup)
Синтаксис:
ЗакончитьГруппуСтрок()
Описание:
Заканчивает последнюю из начатых ранее групп строк.
Пример:
ТабДок.НачатьГруппуСтрок("Сводно за месяц", Истина);
ТабДок.НачатьГруппуСтрок("По дням", Истина);
//...
ТабДок. ЗакончитьГруппуСтрок (); // закончить группу "По дням"
ТабДок.ЗакончитьГруппуСтрок(); // закончить группу "Сводно за месяц"
См. также:
ТабличныйДокумент, метод НачатьГруппуСтрок.
Записать (Write)
Синтаксис:
Записать(<Имя файла>. <Тип файла таблицы> )
Параметры:
<Имя файла> Обязательный
Тип: Строка. Имя файла, в котором сохраняется табличный документ.
<Тип файла таблицы> Необязательный
Тип: ТипФайлаТабличногоДокумента. Формат, в котором будет сохранен табличный документ.
Значение по умолчанию: MXL.
При определении значения параметра используется системное перечисление ТипФайлаТабличногоДокумента.
Описание:
Записывает табличный документ в файл.
Пример:
ТабДок.Записать("С: \Му Documents \Таблица2.mxl ");
НайтиЗначение (FindValue)
Синтаксис:
Найти3начение(<3начение> , <Начало> , <Где>, <Искать по строкам>, <Искать вперед>)
Параметры:
<3начение> Обязательный
Тип: Произвольный. Искомое значение.
<Начало> Необязательный.
Тип: ОбластьЯчеекТабличногоДокумента. Область, после которой начинать поиск.
Значение по умолчанию: Если параметр не задан, то поиск с начала таблицы.
<Где> Необязательный
Тип: ОбластьЯчеекТабличногоДокумента. Область, в которой осуществляется поиск.
Значение по умолчанию: Если параметр не задан, то поиск во всей таблице.
<Искать по строкам> Необязательный
Тип: Булево. Определяет последовательность обхода ячеек при поиске.
Истина - искать по текущей строке, затем переходить на следующую и т.д. в общем направлении поиска. Ложь - искать по текущему столбцу, затем переходить на следующий и т.д. в общем направлении поиска.
Значение по умолчанию: Истина.
<Искать вперед> Необязательный
Тип: Булево. Направление поиска:
Истина - искать вперед, Ложь - искать назад. Значение по умолчанию: Истина.
Возвращаемое значение:
Тип: ОбластьЯчеекТабличногоДокумента, РисунокТабличногоДокумента. Область, содержащая искомое значение. Если значение не найдено - значение Неопределено.
Описание:
Позволяет искать значение в ячейках табличного документа.
Пример:
Если Не ТабДок.НайтиЗначение(ВыбЗнач) Тогда
Сообщить("Значение не найдено!");
Иначе
Сообщить("Значение найдено.");
КонецЕсли;
НайтиТекст (FindText)
Синтаксис:
НайтиТекст(< Строка>, <Начало>, <Где>, <Искать по строкам>, <Ячейка целиком> , <Искать вперед> , <Чувствительность к регистру> )
Параметры:
<Строка> Обязательный
Тип: Строка. Искомый текст.
<Начало> Необязательный
Тип: ОбластьЯчеекТабличногоДокумента. Область, после которой начинать поиск.
Значение по умолчанию: Если параметр не задан, то поиск с начала таблицы.
<Где> Необязательный
Тип: ОбластьЯчеекТабличногоДокумента. Область, в которой осуществляется поиск.
Значение по умолчанию: Если параметр не казан, то вся таблица.
<Искать по строкам> Необязательный
Тип: Булево. Определяет последовательность обхода ячеек при поиске.
Истина - искать по текущей строке, затем переходить на следующую и т.д. в общем направлении поиска. Ложь - искать по текущему столбцу, затем переходить на следующий и т.д. в общем направлении поиска.
Значение по умолчанию: Истина.
<Ячейка целиком> Необязательный
Тип: Булево. Истина - искать только такие ячейки, в которых с искомым текстом совпадает весь текст ячейки, Ложь -искать часть текста ячейки.
Значение по умолчанию: Ложь.
<Искать вперед> Необязательный
Тип: Булево. Направление поиска:
Истина - искать вперед, Ложь - искать назад.
Значение по умолчанию: Истина.
<Чувствительность к регистру> Необязательный
Тип: Булево. Истина - поиск с учетом регистра. Ложь - без учета регистра.
Значение по умолчанию: Ложь.
Возвращаемое значение:
Тип: ОбластьЯчеекТабличногоДокумента, РисунокТабличногоДокумента. Область, содержащая искомый текст. Если текст не найден - значение Неопределено.
Описание:
Позволяет искать текст в ячейках табличного документа.
Пример:
// чтобы посмотреть работу данного метода, добавьте
// следующие строки в конец примера метода НачатьГруппуСтрок()
Отдел = "Итого2";
Обл=ТабДок.НайтиТекст(Отдел);
Если ТипЗнч(Обл)=Тип("Неопределено") Тогда
Сообщить("Значение не найдено!");
Иначе
Поз = Найти(Обл.Имя,"С");
Имя= Лев(Обл.Имя,Поз)+Строка(Число(Прав(Обл.Имя,СтрДлина(Обл.Имя)-Поз) )+1);
Сообщить ("Итог по отделу 2 = " + ТабДок.Область(Имя).Текст);
КонецЕсли;
Напечатать (Print)
Синтаксис:
Напечатать(<Диалог печати> )
Параметры:
<Диалог печати> Необязательный
Тип: Булево. Показ диалога перед печатью:
Истина - выводить диалог печати. Ложь - не выводить диалог печати.
Значение по умолчанию: Ложь.
Описание:
Выводит табличный документ на печать.
Пример:
ТабДок.Напечатать();
| «««««««««« | 1С:Предприятие 8.0 | »»»»»»»»»» |
Методы
Синтаксис:
Индекс(Область)
Синтаксис:
Количество()
Возвращаемое значение:
Количество элементов в коллекции.
Описание:
Получает количество элементов в коллекции.
Синтаксис:
Найти(НаименованиеОбласти)
| «««««««««« | 1С:Предприятие 8.0 | »»»»»»»»»» |
Методы
Синтаксис:
Обвести(<Граница сверху> , <Граница слева> , <Граница справа>, <Граница снизу>)
Параметры:
<Граница сверху > Необязательный
Тип: Линия. Задает тип верхней границы.
Значение по умолчанию: Если параметр не указан, верхняя граница не рисуется.
<Граница слева> Необязательный
Тип: Линия. Задает тип границы слева.
Значение по умолчанию: Если параметр не указан, граница слева не рисуется.
< Граница справа > Необязательный
Тип: Линия. Задает тип границы справа.
Значение по умолчанию: Если параметр не указан, граница справа не рисуется.
<Граница снизу> Необязательный
Тип: Линия. Задает тип нижней границы.
Значение по умолчанию: Если параметр не указан, нижняя граница не рисуется.
Описание:
Обводит область рамкой.
Синтаксис:
Объединить()
Описание:
Объединяет ячейки области.
Пример:
Область = ТабДок.Область(2,2,3,3);
Область.Объединить();
См. также:
ОбластьЯчеекТабличногоДокумента, метод Разъединить.
Синтаксис:
Очистить ( <Очищать текст> , <Очищать форматирование , <Очищать рамки> )
Параметры:
<Очищать текст> Необязательный
Тип: Булево. Истина - очищать текст ячеек таблицы. Ложь - не очищать текст ячеек.
Значение по умолчанию: Истина.
«Очищать форматирование> Необязательный
Тип: Булево. Истина - очищать формат ячеек таблицы, Ложь - не очищать формат ячеек.
Значение по умолчанию: Ложь.
<Очищать рамки> Необязательный
Тип: Булево. Истина - удалять рамки ячеек области. Ложь - не удалять рамки ячеек.
Значение по умолчанию: Ложь.
Описание:
Очищает содержимое области.
Пример:
Область.Очистить() ;
Разгруппировать (Ungroup)
Синтаксис:
Разгруппировать()
Описание:
Позволяет разгруппировать строки или столбцы области. Может использоваться только для областей, состоящих из строк или
столбцов.
Пример:
Область.Разгруппировать();
См. также:
ОбластьЯчеекТабличногоДокумента, метод Сгруппировать.
Разъединить (Unmerge)
Синтаксис:
Разъединить()
Описание:
Разъединяет объединенные в области ячейки.
Пример:
Область = ТабДок.Область(2,2,3,3) ;
Область.Объединить();
Область.Разъединить();
См. также:
ОбластьЯчеекТабличногоДокумента, метод Объединить.
Сгруппировать (Group)
Синтаксис:
Сгруппировать(< Имя группы>}
Параметры:
<Имя группы>Необязательный
Тип: Строка. Название группы.
Описание:
Позволяет сгруппировать область, состоящую из строк или столбцов.
Пример:
Область.Сгруппировать("Товар");
См. также:
ОбластьЯчеекТабличногоДокумента, метод Разгруппировать.
УстановитьЭлементУправления (SetControl)
Синтаксис:
УстановитьЭлементУправления (< Тип элемента управления> )
Параметры:
<Тип элемента управления> Обязательный
Тип: Тип. Тип устанавливаемого элемента управления.
Описание:
Устанавливает элемент управления, которым будут изменяться ячейки в области табличного документа.
| «««««««««« | 1С:Предприятие 8.0 | »»»»»»»»»» |
Методы
Синтаксис:
Добавить(< Тип рисунка>)
Параметры:
<Тип рисунка> Обязательный
ТипРисункаТабличногоДокумента. Тип добавляемого рисунка.
Возвращаемое значение:
Тип: РисунокТабличногоДокумента. Добавленный рисунок.
Описание:
Добавляет рисунок в коллекцию рисунков табличного документа.
Синтаксис:
Индекс(< Рисунок>)
Параметры:
<Рисунок> Обязательный
Тип: РисунокТабличногоДокумента. Рисунок табличного документа, индекс которого нужно определить.
Возвращаемое значение:
Тип: Число. Индекс рисунка в коллекции.
Описание:
Позволяет определить индекс рисунка в коллекции.
Синтаксис:
Количество()
Возвращаемое значение:
Тип: Число. Количество рисунков в коллекции.
Описание:
Получает количество рисунков в коллекции.
Синтаксис:
Очистить()
Описание:
Удаляет все рисунки из табличного документа.
Синтаксис:
Удалить(< Рисунок>)
Параметры:
<Рисунок> Необязательный
Тип: РисунокТабличногоДокумента. Удаляемый рисунок.
Описание:
Удаляет рисунок из коллекции рисунков табличного документа.
| «««««««««« | 1С:Предприятие 8.0 | »»»»»»»»»» |
Методы
Синтаксис:
Расположить(< Область ячеек>)
Параметры:
<Область ячеек> Обязательный
Тип: ОбластьЯчеекТабличногоДокумента. Область, в которой будет расположен рисунок.
Описание:
Позволяет расположить рисунок в указанной области ячеек табличного документа.
Пример:
ТабДок = Новый ТабличныйДокумент;
МояКартинка = Новый Картинка( "C:\My Documents\qwerty .bmp") ;
Рис=ТабДок.Рисунки.Добавить(ТилРисункаТабличногоДокумента.Картинка) ;
Индекс=ТабДок,Рисунки.Индекс(Рис);
ТабДок.Рисунки[Индекс].Картинка = МолКартинка;
ТабДок.Рисунки[Индекс].Расположить(ТабДок.Область("R1C1:R4C4"));
ТабДок.Показать();
УстановитьЭлементУправления (SetControl)
Синтаксис:
УстановитьЭлементУправления (< Тип элемента управления>)
Параметры;
<Тип элемента управления> Обязательный
Тип: Тип. Задает тип элемента управления, который устанавливается.
Описание:
Позволяет установить элемент управления для редактирования значения рисунка типа "Текст".
Примечание:
Применяется только для рисунков типа Текст. Доступно, если свойство СодержитЗначение равно Истина.
| «««««««««« | 1С:Предприятие 8.0 | »»»»»»»»»» |
Методы
Синтаксис:
Заполнить(Объект)
Синтаксис:
Количество()
Возвращаемое значение:
Тип: Число. Количество параметров в коллекции.
Описание:
Получает количество параметров в коллекции.
Методы
Синтаксис:
Представление()
Возвращаемое значение:
Тип: Строка.
Описание:
Возвращает строковое представление объекта метаданных. Как правило, в качестве строкового представления выступает синоним, а при его отсутствии имя объекта метаданных, как оно задано в конфигураторе.
Пример:
Для каждого Объект Из Метаданные.Справочники Цикл
Сообщить(Объект.Представление());
КонецЦикла;
Синтаксис:
Родитель()
Возвращаемое значение:
Тип: Объект описания метаданного.
Описание:
Позволяет определить объект описания метаданного, которому подчинен данный объект.
Пример:
// В данном примере метод вернет значение
// Метаданные.Документы.РасхНакладная
Метаданные.Документы.РасхНакладная.Реквизиты.Цена.Родитель();
Методы
Синтаксис:
Индекс(ОписаниеМетаданного)
Синтаксис:
Количество()
Возвращаемое значение:
Тип: Число. Количество элементов коллекции.
Описание:
Позволяет определить количество элементов коллекции.
Синтаксис:
Найти(Наименование)
| «««««««««« | 1С:Предприятие 8.0 | »»»»»»»»»» |
Методы
Синтаксис:
ПолучитьВремяИзменения()
Возвращаемое значение:
Тип: Дата. Время последнего изменения файла.
Описание:
Позволяет получить время последнего изменения файла.
Примечание:
Применим только к файлам или каталогам, которые реально существуют.
Пример:
ВремяИзмекения = ВыбФайл.ПолучитьВремяИзменения();
ПолучитьНевидимость (GetHidden)
Синтаксис:
ПолучитьНевидимость()
Возвращаемое значение:
Тип: Булево. Истина - у файла установлен атрибут "Скрытый", Ложь - у файла атрибут "Скрытый" не установлен.
Описание:
Получает значение атрибута файла "Скрытый" ("Hidden").
Примечание:
Применим только к файлам или каталогам, которые реально существуют.
Пример:
Невидимость = ВыбФайл.ПолучитьНевидимость();
ПолучитьТолькоЧтение (GetReadOnly)
Синтаксис:
ПолучитьТолькоЧтение()
Возвращаемое значение:
Тип: Булево. Истина - у файла установлен атрибут "Только чтение", Ложь - у файла атрибут "Только чтение" не установлен.
Описание:
Получает значение атрибута файла "Только чтение" ("Read only').
Примечание:
Применим только к файлам или каталогам, которые реально существуют.
Пример:
ТолькоЧтение = ВыбФайл.ПолучитьТолькоЧтение();
Синтаксис:
Размер()
Возвращаемое значение:
Тип:Число.
Описание:
Позволяет определить размер файла (в байтах).
Примечание:
Применим только к файлам, которые реально существуют.
Пример:
РазмерФайла = ВыбФайл.Размер();
Синтаксис:
Существует()
Возвращаемое значение:
Тип: Булево. Истина - файл существует, Ложь - файл не существует.
Описание:
Определяет, существует ли файл, соответствующий данному объекту.
Пример:
Если Не ВыбФайл-Существует() Тогда
Предупреждение ('Указанный файл не существуете);
КонецЕсли ;
УстановитьВремяИзменения (SetModifiedTime)
Синтаксис:
УстановитьВремяИзменения(< Время изменения>)
Параметры:
<Время иэмвнения> _Обязательный
Тип: Дата. Устанавливаемое время изменения файла или каталога.
Описание:
Устанавливает время последнего изменения файла.
Примечание:
Применим только к файлам или каталогам, которые реально существуют.
Пример:
ВыбФайл.УстановитьВремяИзменения (ТекущаяДата ());
УстановитьНевидимость (SetHidden)
Синтаксис:
УстановитьНевидимость (< Невидимость>)
Параметры:
<Невидимость> Обязательный
Тип: Булево. Истина - установить атрибут "Скрытый", Ложь - снять атрибут "Скрытый".
Описание:
Устанавливает значение атрибута файла "Скрытый" ("Hidden").
Примечание:
Применим только к файлам или каталогам, которые реально существуют.
Пример:
ВыбФайл.УстановитьНевидимость(Истина);
УстановитьТолькоЧтение (SetReadOnly)
Синтаксис:
УстановитьТолькоЧтение (< Только чтение> )
Параметры:
<Толъко чтение> Обязательный
Тип: Булево. Истина - установить атрибут "Только чтение", Ложь - снять атрибут "Только чтение".
Описание:
Устанавливает значение атрибута файла "Только чтение" ("Read only").
Примечание:
Применим только к файлам или каталогам, которые реально существуют.
Пример:
ВыбФайл.УстановитьТолькоЧтение(Истина);
ЭтоКаталог (IsDirectory)
Синтаксис:
ЭтоКаталог()
Возвращаемое значение:
Тип: Булево. Истина - объект соответствует каталогу. Ложь - объект соответствует файлу.
Описание:
Позволяет определить, соответствует файловый объект каталогу или файлу.
Примечание:
Применим только к файлам, которые реально существуют.
Пример:
Если Не ВыбФайл.ЭтоКаталог() Тогда
Предупреждение("Укажите каталог!");
КонецЕсли;
Этофайл (IsFile)
Синтаксис:
ЭтоФайл()
Возвращаемое значение:
Тип: Булево. Истина - объект соответствует файлу. Ложь -объект соответствует каталогу.
Описание:
Позволяет определить, соответствует файловый объект файлу или каталогу.
Примечание:
Противоположен методу ЭтоКаталог. Применим только к файлам, которые реально существуют.
Пример:
Если Не ВыбФайл.ЭтоФайл() Тогда
Предупреждение("Укажите файл!");
КонецЕсли;
Методы
Синтаксис:
ВКонце()
Возвращаемое значение:
Тип: Булево. Истина - указатель в файле находится за последней записью; Ложь - конец файла не достигнут.
Описание:
Получает признак достижения указателем текущей записи конца файла.
Пример:
// Максимальное значение поля COST
хВ.Первая() ;
МаксСтоимость = 0 ;
Пока Не хВ.ВКонцеО Цикл
Если xB.COST > МаксСтоимость Тогда
МаксСтоимость = xB.COST;
КонецЕсли ;
хВ.Следующая();
КонецЦикла;
Синтаксис:
ВНачале()
Возвращаемое значение:
Тип: Булево. Истина - указатель в файле находится перед первой записью; Ложь - начало файла не достигнуто.
Описание:
Получает признак достижения указателем текущей записи начала файла.
Пример:
// Среднее значение поля COST
хВ.Последняя();
Стоимость = 0;
Записей =0;
Пока Не хВ.ВНачале() Цикл
Стоимость = Стоимость + xB.COST;
Записей = Записей +1;
хВ.Предыдущая();
КонецЦихла;
Если Записей > 0 Тогда
Стоимость = Стоимость / Записей ;
КонецЕсли;
Синтаксис:
Восстановить()
Описание:
Снимает с текущей записи пометку удаления.
Пример:
// Восстановление всех удаленных записей
хВ.ПоказыватьУдаленные = истина;
хВ.Первая();
Пока Не хВ.Вконце() Цикл;
хВ. Восстановить();
хВ.Следующая();
КонецЦикла; .
Синтаксис:
Добавить()
Описание:
Добавляет новую пустую запись. При этом поля и свойства объекта Ключ очищаются. Для записи изменений в таблицу базы данных необходимо инициировать запись.
Пример:
хВ.Добавить();
xB.CODE = "00004";
xB.NAME = "Клавиатура";
хВ.Записать();
Синтаксис:
ЗакрытьФайл()
Описание:
Закрывает ранее открытую или созданную таблицу базы данных формата DBF.
Пример:
Если хВ.Открыта() Тогда;
хВ.ЗакрытьФайл();
КонецЕсли;
Записать (Save)
Синтаксис:
Записать()
Описание:
Выполняет запись изменений в таблицу базы данных. До его вызова все изменения объекта производились только в памяти и будут потеряны при осуществлении перехода к другой записи или закрытии таблицы базы данных, если отключен режим автосохранения.
См. также:
XBase, свойство Автосохранение.
ЗаписьУдалена (RecDeleted)
Синтаксис:
ЗаписьУдалена()
Возвращаемое значение:
Тип: Булево. Истина - запись удалена; Ложь - запись не удалена.
Описание:
Получает пометки удаления текущей записи.
Пример:
хВ.ПоказыватьУдаленные = Истина;
хВ.Первая();
Пока Не хВ.ВконцеО Цикл
Если хВ.ЗаписьУдалена () Тогда
Сообщить("Удаленная запись: " + хВ.НомерЗаписи());
КонецЕсли;
хВ.Следующая();
КонецЦикла;
КодОшибки (ErrorCode)
Синтаксис:
КодОшибки()
Возвращаемое значение:
Тип: Число. Код последней ошибки. Возвращаемые коды ошибок:
• -10 - Ошибка закрытия файла;
• -20 - Ошибка создания файла;
• -30 - Ошибка определения длины файла;
• -40 - Ошибка установки длины файла;
• -50 - Ошибка при попытке заблокировать файл;
• -60 - Ошибка при открытии файла;
• -70 - Ошибка чтения файла;
• -80 - Ошибка удаления файла;
• -90 - Ошибка переименования файла;
• -100 - Ошибка позиционирования в файле;
• -110 - Ошибка снятия блокировки с файла;
• -120 - Ошибка записи в файл;
• -200 - Файл не является базой данных DBF-формата;
• -210 - Неопознанное имя поля;
• -220 - Неопознанный тип поля;
• -230 - Запись слишком длинная;
• -300 - Индексный файл не содержит информации о записи;
• -310 - Нарушение структуры индексного файла;
• -330 - Указанное имя индекса недоступно;
• -340 - Ошибка уникальности индекса;
• -400 - Ожидается запятая или скобка;
• -410 - Выражение не завершено;
• -422 - IIF() требует параметров одинаковой длины;
• -425 - У STR() и SUBSTR() 2-й и 3-й параметры - константы;
• -430 - Неверное число параметров;
• -440 - Слишком сложное выражение;
• -450 - Пропущена правая скобка;
• -460 - Неверный тип подвыражения;
• -470 - Неопознанная функция;
• -480 - Неопознанный оператор;
• -490 - Неопознанное значение;
• -500 - Выражение не завершено символом двойной кавычки;
• -920 - Недостаточно памяти.
Описание:
Получает код завершения последней выполненной операции.
Пример:
Если хВ.КодОшибки () = -60 Тогда
Сообщить("Не удалось открыть файл DBF");
КонецЕсли ;
КоличествоЗаписей (RecCount)
Синтаксис:
КоличествоЗаписей()
Возвращаемое значение:
Тип: Число. Количество записей в базе.
Описание:
Получает количество записей в таблице базы данных вместе с помеченными на удаление записями.
Пример:
Предупреждение(" Записей " + Строка (хВ.КодичествоЗаписей ()));
Найти (Find)
Синтаксис:
Найти(<Ключ>, <Режим>)
Параметры:
<Ключ> Обязательный
Тип: Строка. Значение выражения текущего индекса.
<Режим> Обязательный
Тип: Строка. Режим поиска записей:
"=" - ищет запись на точное соответствие ключу;
">=" - ищет запись на точное соответствие с ключом или большую;
">" - ищет запись с большим ключом;
"<=" - ищет запись на точное соответствие с ключом или меньшую;
"<" - ищет запись с меньшим ключом.
Возвращаемое значение:
Тип: Булево. Истина - запись найдена; Ложь - запись не найдена.
Описание:
Позволяет найти запись, соответствующую указанному значению ключа по текущему индексу и режиму поиска, переданному в качестве параметра. Указатель устанавливается на найденную запись.
Примечание:
Следует отметить, что вычисление значения индекса при работе XBase-объекта с таблицей базы данных производится объектом самостоятельно на основании выражения, переданного ему при создании ключа. При вызове данного метода значение Ключ должно быть вычислено средствами встроенного языка, что может представлять определенные трудности, если индекс составной, поля, включенные в выражение индекса, отличны от строковых, и т.д. Поэтому применимость данного метода ограничена случаем использования простых строковых выражений индекса. В более сложных случаях следует применять универсальный метод НайтиПоКлючу.
Пример:
// Поиск записи по значению ключа
хВ.ТекущийИндекс = хВ.Индексы.IDXCODE; // индекс CODE
ЗаписьНайдена = хВ.Найти("00001" , ">=");
См. также:
XBase, свойство ТекущийИндекс.
НайтиПоКлючу (FindByKey)
Синтаксис:
НайтиПоКлючу (< Режим> )
Параметры:
<Peжим> Обязательный
Тип: Строка. Режим поиска записей:
"=" - ищет запись на точное соответствие ключу;
">=" - ищет запись на точное соответствие с ключом или большую;
">" - ищет запись с большим ключом;
"<=" - ищет запись на точное соответствие с ключом или меньшую;
"<" - ищет запись с меньшим ключом.
Возвращаемое значение:
Тип: Булево. Истина - запись найдена; Ложь - запись не найдена.
Описание:
Позволяет найти запись, соответствующую значениям свойств объекта типа Ключ XBase-объекта по текущему индексу и режиму поиска, переданному в качестве параметра. Указатель устанавливается на найденную запись. Перед вызовом метода следует установить значения всех свойств объекта типа Ключ, которые участвуют в вычислении выражения текущего индекса.
Пример:
// Поиск по составному ключу
хВ.ТекущийИндекс = хВ.Индексы.IDXCNAME; // индекс CODE + TRIM(NAME)
хВ.Ключ. CODE = "00001";
хВ.Ключ. NAME = "Системный блок";
ЗаписьНайдена = хВ.НайтиПоКлючу("=");
См. также:
XBase, свойство Ключ. XBase, свойство ТекущийИндекс.
НомерЗаписи (RecNo)
Синтаксис:
НомерЗаписи()
Возвращаемое значение:
Тип: Число. Номер текущей записи.
Описание:
Получает физический порядковый номер текущей записи в таблице базы данных, начиная с единицы. Результат не зависит от установки текущего индекса.
Пример:
Если хВ.ЗаписьУдалена() Тогда
Сообщить ("Удаленная запись: " + хВ. НомерЗаписи());
КонецЕсли;
| «««««««««« | 1С:Предприятие 8.0 | »»»»»»»»»» |
