1452
правки
Изменения
Нет описания правки
$sum
''Возвращает сумму всех числовых данных столбца C файла 'c:\asdf.xlsx'''
Функции:
BeginDoc – Начинает новый документ.
EndDoc – Закрывает документ
PageHeight – Возвращает высоту страницы в пикселях
PageWidth – Возвращает ширину страницы в пикселях
PageNumber – Возвращает номер текущей страницы документа
Orientation – Возвращает текущую ориентацию страницы (0 – портретная, 1 – ландшафтная)
Printing – Возвращает истину если документ открыт
SetOrientation(Orientation) – Устанавливает ориентацию страницы. При необходимости начинает новый документ, новую страницу.
ShowDialog – Показывает пользовательский диалог печати
NewPage – Начинает новую страницу
Canvas – Предоставляет доступ к объекту TCanvas, связанному с принтером.
PrinterNames – Возвращает список принтеров, установленных в системе, разделенный переносами строк
PrintersCount – Возвращает количество установленных в системе принтеров
SetPrinter(Printer) – Устанавливает текущий принтер. Если передана строка – ищет принтер по названию, иначе – по номеру. Нумерация начинается с 0.
PrintTable(Y, Table) – Выводит на печать таблицу Table типа TTable, начиная с координаты Y. При необходимости таблица печатается на нескольких страницах. Возвращает координату Y конца таблицы.
Предоставляет доступ к холсту объекта для прорисовки изображения.
Функции:
DPIX – Возвращает разрешение холста по горизонтали в точках на дюйм
DPIY – Возвращает разрешение холста по вертикали в точках на дюйм
TextOut(x, y, s[, x1, y1, x2, y2]) – Выводит строку s начиная с точки с координатами x и y. Если указаны параметры x1, y1, x2, y2 – то выводимый текст ограничивается заданным прямоугольником.
TextOutEx(x1, y1, x2, y2, Alignment, Font, s, Indent) – Выводит строку s в прямоугольнике с координатами x1, y1, x2, y2. По горизонтали строка выравнивается в соответствии с Alignment (0 – прижато влево, 1 – вправо, 2 – по центру), по вертикали выравнивается по центру. Используя шрифт Font (см описание ниже). Indent – отступ по горизонтали, расстояние в пикселях между границей прямоугольника и текстом. Функция возвращает координату X фактического окончания текста (правой стороны – если строка прижата влево, и левой – в остальных случаях)
MLTextOut(x1, y1, x2, y2, Alignment, VAlignment, Font, s, Heigth, Indent) – Выводит многострочный текст s в прямоугольнике с координатами x1, y1, x2, y2 с переносом по словам. По горизонтали строки выравниваются в соответствии с Alignment, по вертикали – в соответствии с VAlignment (0 – прижато вверх, 1 – по центру, 2 – прижато вниз). Используя шрифт Font (см описание ниже). Heigth – высота строки. Если опущено или равно нулю – высота определяется автоматически в соответствии с выбранным шрифтом. Indent – отступ по горизонтали, расстояние в пикселях между границей прямоугольника и текстом. Функция возвращает координату Y фактического окончания текста (нижней границы последней строки текста. ''ВНИМАНИЕ! Функция использует координаты прямоугольника для позиционирования текста, однако она не ограничивает его верхней и нижней границами этого прямоугольника!''
DrawPic(x1, y1, x2, y2, Pic, Style, Alignment) – Прорисовывает изображение Pic (ссылка на изображение TPicture.Self) в прямоугольник заданный координатами x1-y2. Style – стиль масштабирования. 0 – растянуть изображение до границ прямоугольника не сохраняя пропорции, 1 – вписать изображение в прямоугольник сохраняя пропорции – вероятно, останутся поля по вертикали или горизонтали, 2 – вписать сохраняя пропорции, обрезав при необходимости изображение по вертикали или горизонтали. Alignment – выравнивание по горизонтали. Работает только в случае если style=1 и при растягивании изображения получились вертикальные поля. 0 – разместить по центру, 1 – прижать влево, 2 – прижать вправо. Функция возвращает координату X правой стороны изображения кроме случая, когда Style=1 и Alignment=2 – в этом случае возвращается координата левой стороны изображения.
FillRect(x1, y1, x2, y2) – Закрашивает прямоугольник цветом BrashColor
Rect(x1, y1, x2, y2) – Закрашивает прямоугольник цветом BrashColor, .
SetFont(Font) – Устанавливает шрифт по-умолчанию.
TextHeight(s) – Возвращает высоту текста s в пикселях без учета многострочности, с учетом текущего шрифта.
TextWidth(s) – Возвращает ширину текста s в пикселях без учета многострочности, с учетом текущего шрифта.
Использование шрифта (Font): У объекта TCanvas есть «глобальные» установки шрифта. Однако для некоторых функций возможно указание шрифта, отличающегося от глобального. Параметры шрифта – это текстовая строка, состоящая из 6-ти параметров, разделенных запятыми: Название, размер, жирный, курсив, подчеркнутый, цвет. Например:
'Times New Roman, 8, Y, N, N, 255'. Любой параметр можно опустить, и тогда вместо него будет использовано значение по-умолчанию: шрифт: arial, размер – 10, не жирный, не курсив, не подчеркнутый, цвет – черный. Например: ', 7' – указывает, что по-умолчанию нужно взять все параметры кроме размера шрифта. Так же можно вместо всей строки указать тире ('-') или пустую строку, и шрифт будет использоваться «глобальный».
Предоставляет функции для работы с графическими изображениями форматов BMP и Jpeg, а так же для формирования штрих-кодов.
Функции:
LoadFromFile(FileName) – Загружает изображение из файла FileName. Возвращает истину, если операция прошла успешно, иначе – ложь.
LoadFromDB(DB, Query) – Загружает изображение из базы данных. DB – ссылка на подключение к базе данных TADO.Self, Query – текст запроса. Запрос должен вернуть в первом поле первой строки BLOB-поле с изображением, все остальные данные возвращаемые запросом игнорируются. Возвращает истину, если операция прошла успешно, иначе – ложь.
CreateEan(Width, Height, BarCode, Textless) – Формирует штрих-код EAN13 c шириной Width и высотой Height. BarCode – текст штрих-кода. Должен быть цифровым 12 или 13 символов (13-й, контрольная сумма рассчитывается автоматически). Булево значение Textless указывает, что в штрих-коде не должно быть человеко-читаемых символов если истинно. Внимание! Ширина штрих-кода Width не является точным значением получаемого на выходе изображения. Ширина изображения рассчитывается как максимальное кратное минимально возможной ширине, но не меньше минимально возможной. Конечную ширину можно получить в соответствующем свойстве объекта.
Create128(Width, Height, BarCode, Textless) – Формирует штрих-код CODE128 c шириной Width и высотой Height. BarCode – текст штрих-кода. Булево значение Textless указывает, что в штрих-коде не должно быть человеко-читаемых символов если истинно. Внимание! Ширина штрих-кода Width не является точным значением получаемого на выходе изображения. Ширина изображения рассчитывается как максимальное кратное минимально возможной ширине, но не меньше минимально возможной. Конечную ширину можно получить в соответствующем свойстве объекта.
Width – Возвращает ширину изображения.
Height – Возвращает высоту изображения.
Rotate(Angle) – Поворачивает изображение по часовой стрелке на угол Angle.
Self – Ссылка на объект с изображением, используется в качестве параметра для функций, работающих с изображениями из данного объекта.
Предоставляет функции для работы с таблицами.
Функции:
LoadFromDB(DB) – Загружает таблицу из набора данных, открытого в объекте DB типа TADO. Таблица загружается вместе с заголовками. Если название поля содержит подстроку «_RecNo» - данная подстрока не попадет в заголовок, а все значения поля будут заменены на порядковый номер записи в наборе данных, начиная с «1». Заголовок – это первая строка таблицы.
Cell(С, R) – Возвращает значение ячейки таблицы с координатами (C, R). Нумерация строк и столбцов начинается с 1.
RowCount – Возвращает количество строк в таблице.
ColCount – Возвращает количество столбцов в таблице.
SetTitleFont(Font) – Задает шрифт заголовка таблицы (первой строки).
SetFont(Font) – Задает шрифт всей таблицы кроме заголовка.
SetIndent(Indent) – Задает отступ от границы ячейки до текста в процентах от ширины страницы.
SetWidth(С, Width) – Задает значение ширины столбца C в процентах от ширины страницы.
SetMinRowHeght (Heght) – Задает значение минимальной высоты строки.
SetBarCode
SetColFont
Self – Ссылка на объект с таблицей, используется в качестве параметра для функций, работающих с таблицами из данного объекта.
Предоставляет функции, базирующиеся на БД системы «Курьерская служба 2008». По-умолчанию, при создании подключается к основной базе данных модуля, в котором выполняется скрипт, если такая определена контекстом, однако это можно изменить, см SetConnection.
Функции:
MakeAddress(s) – возвращает значение, полученное путем преобразований адреса s для приведения его к внутреннему формату программы. В процессе преобразования до нескольких раз происходит замена буквосочетаний по таблице замены (ее редактирование доступно по нажатию кнопки «Автозамена» в интерфейсе импорта БД из Excel системы (см. Руководство пользователя)), поиск улиц по базе КЛАДР с точностью до одного знака, и некоторые другие операции, нацеленные на исправление ошибок в написании адреса.
GetStationCode(s) – возвращает код станции метро, ассоциированный в системе с адресом s. В случае невозможности идентифицировать станцию метро – возвращает 0.
SetConnection(DB) – Подключает объект к базе данных DB, где DB – ссылка на объект TADO.Self.
SetTown(Town) – Устанавливает код текущего города (используется в некоторых функциях объекта) в значение Town. По-умолчанию текущий город – 1.
SetIndexLength(Length) – Устанавливает длину почтового индекса. По-умолчанию – 6.
LogTable(Table, Code, User) – Добавляет в журнал истории запись таблицы с кодом Table, с кодом Code. Если запись отсутствует – добавляется запись об удалении пользователем с кодом User.
GetIndex(Address) – Возвращает почтовый индекс из адреса.
TownByIndex(Index) – Возвращает код города по индексу. В случае ошибки поиска – код текущего города.
TownByName(Name) – Возвращает код города по имени. В случае ошибки поиска – код текущего города.
FillClientInfo(Excel, client, Sheet, Row, Col) – Выводит в эксель информацию о клиенте с кодом client на лист sheet начиная со строки row и столбца col.
Предоставляет функции системы «Курьерская служба 2008». Создается только автоматически контекстом.
Функции:
UserCode - Возвращает код текущего пользователя из таблицы «Пользователи» (users).
UserName - Возвращает имя текущего пользователя из таблицы «Пользователи» (users).
UserBaseCode – Возвращает код текущего пользователя из таблицы «Сотрудники» (kurier).
UserEmail - Возвращает e-mail текущего пользователя.
CurrentTown – Возвращает код текущего города (из таблицы town).
CurrentCity – Возвращает код текущего региона (из таблицы city).
CurrentLocation – Возвращает код текущего филиала (из таблицы store).
Предоставляет функции работы с ini-файлами. В некоторых контекстах создается автоматически для предоставления доступа к настроечному файлу модуля, выполняющего скрипт.
Функции:
IniParam(s) – Существует только если имя экземпляра объекта пустое. Возвращает значение параметра s ini-файла секции «common». В случае отсутствия параметра в файле возвращает пустую строку.
Param(s) – Синоним IniParam с тем отличием, что существует только если имя объекта непустое.
Предназачен для отправки SMS, а так же проверки статуса их доставки.
Функции:
Connect(Provider, Host, User, Pass, SenderName) – Подключает объект к провайдеру provider, используя адрес Host, имя пользователя User и пароль Pass.
Для провайдера доступны значения 'zanzara', 'sms16', 'mirsms', 'megatel'.
SendSMS(Phone, Text, [ID]) – Отправляет SMS с текстом Text на телефон Phone. Для некоторых провайдеров необходим уникальный идентификатор сообщения ID. Возвращает ID провайдера для последующей проверки статуса доставки.
CheckSMS(ProviderID) – Проверяет состояние доставки сообщения с идентификатором ProviderID. Возвращает: 0 – доставляется, 1 – успешно доставлено, 2 – не доставлено.
Предназачен для парсинга XML-данных.
Функции:
SetText(S) – Задает текст XML документа для парсинга, делает текущим корневой элемент.
NodeValue – Возвращает значение текущего элемента.
NodeName – Возвращает имя текущего элемента.
OpenChild(V) – Ищет дочерний элемент и делает его текущим. Если V – число – ищет по номеру, если V – текст – ищет по названию. Возвращает значение найденного элемента, или пустую строку, если элемент не найден.
ChildrenCount – Возвращает количество дочерних элементов.
ChildNodeValue – Ищет дочерний элемент и возвращает его значение. Если V – число – ищет по номеру, если V – текст – ищет по названию.
OpenParent – Делает текущим родительский элемент. Возвращает значение найденного элемента.
AttribCount – Возвращает количество атрибутов текущего элемента.
AttribName(i) – Возвращает имя атрибута с номером i.
Attrib(V) – Ищет атрибут и возвращает его значение. Если V – число – ищет по номеру, если V – текст – ищет по названию.
Reset – Делает текущим корневой элемент, возвращает его значение.
== Применение языка формул ==
'''в различных контекстах системы «Курьерская служба 2008» и сопутствующих проектах'''
В карточке клиента на закладке «Касса» имеется поле для ввода текста, который будет отображаться на кассовых чеках, печатаемых для корреспонденции от данного клиента. В поле может быть введен как просто текст, так и интерпретируемый скрипт, начинающийся с признака скрипта: «<?>». В контексте выполнения скрипта система создает объекты:
TSelfDB с открытым набором данных со строчкой корреспонденции, заказа и клиента, на которую печатается чек
TBaseSupport
TBaseValue
Все объекты создаются с пустыми именами.
Результат работы скрипта печатается на создаваемом чеке, если скрипт не возвращает значение “-1” (число или текст) – в этом случае система чек не создает. Подразумевается, что либо скриптом было принято решение об отсутствии необходимости формирования чека, либо скрипт взял эту функцию на себя.
В поле текста задания может быть введен как текст с командами планировщика (см ниже), так и интерпретируемый скрипт, начинающийся с признака скрипта: «<?>». В контексте выполнения скрипта система создает объекты:
TIniFile, Указывает на настроечный ini-файл планировщика.
Все объекты создаются с пустыми именами.
GetKurierByStation(i) – возвращает код курьера, ассоциированного со станцией метро с кодом i.
GetNewNumber – Возвращает не занятый номер единицы корреспонденции в текущем заказе.