Описание внешней компоненты ScanSymb.dll

 

 

Общее описание

Свойства компоненты

Методы компоненты

Значения параметров внешнего события

 

 

Общее описание

Внешняя компонента  ScanSymb.dll предназначена для работы «1Средприятие 8. Расширение для карманных компьютеров» на мобильных устройствах «Symbol», оборудованных встроенным сканером штрих-кодов Данная компонента обеспечивает взаимодействие со сканером штрих-кодов.

 

Компонента удовлетворяет требованиям технологии «1Средприятие 8. Расширение для карманных компьютеров». Поэтому данная компонента может использоваться в мобильных приложениях, создаваемых при помощи «1Средприятие 8. Расширение для карманных компьютеров», для организации работы со сканером штрих-кодов.

 

После загрузки компонента занимает сканер (делает его недоступным для других программ). Для начала сканирования нужно подсоединить сканер путем вызова метода Подсоединить.

 

Имя объекта для использования в мобильных приложениях: ScanSymb.

 

Свойства компоненты

 

УстройствоВключено (DeviceIsEnabled)

 

Тип значения – число. Только чтение.

0 - выключено, 1 – включено

 

Содержит признак того, включено устройство или выключено.

 

Результат (Result)

 

Тип значения – число. Только чтение.

В случае отсутствия ошибок при последнем вызове метода компоненты содержит 0, в противном случае содержит код ошибки.

 

ВремяОжидания(Timeout)

 

Тип значения – число. Чтение и запись.

Содержит время ожидания, задаваемое в миллисекундах.

 

Предназначен для установки времени ожидания результатов сканирования от устройства

 

ПосылкаДанных (DataSend)

 

 

Тип значения – число. Чтение и запись.

0 – не посылать данные, 1 – посылать данные.

Если установлено значение 0, то данные, получаемые от сканера, буферизуются внешней компонентой.

 

Свойство предназначено для управления буферизацией данных, получаемых от сканера. Если данные в данный момент не могут быть обработаны, то они могут накапливаться в буфере внешней компоненты.

 

При удачном сканировании, вызывается внешнее событие, автоматически устанавливая значение свойства «ПосылкаДанных» равным 0. После этого все сообщения будут накапливаться в буфере внешней компоненты сканера, пока либо она не будет очищена посредством вызова метода ОчиститьВыход), либо значение свойства «ПосылкаДанных» не будет установлено равным 1. Если при установке значения свойства «ПосылкаДанных» равным 1 очередь не пуста, вызывается внешнее событие для первого сообщения в очереди и значение свойства «ПосылкаДанных» устанавливается равным 0. Если очередь пуста, то первое же сообщение вызовет внешнее событие и значение свойства «ПосылкаДанных» будет установлено равным 0.

 

 

УстройствоЗанято (Busy)

           

Тип значения – число. Только чтение.

0 – устройство свободно, 1 – занято.

 

Предназначено для определения занятости устройства.

 

Методы компоненты

 

Подсоединить (Connect)

 

Осуществляет подключение к сканеру.

 

Отсоединить (BreakConnection)

 

Выполняет отключение объекта компоненты от сканера. После выполнения метода сканирование невозможно.

 

ОчиститьВыход (CleanOutput)

 

Очищает очередь буфера компоненты.

 

 

Значения параметров внешнего события

 

Для параметров внешнего события, генерируемого компонентой для мобильного приложения, устанавливаются следующие значения:

 

Параметр «Источник»

 

Параметр имеет значение «Symbol Scaner».

 

Параметр «Событие»

 

Может принимать одно из следующих значений:

 

«BarCodeValue» - если параметр «Данные» содержит штрих-код, считанный сканером.

 

«Status» - если параметр «Данные» содержит текст служебного сообщения (как правило, это сообщение об ошибке).

           

 

Параметр «Данные»

 

Содержит штрих-код, считанный сканером. Также может содержать текст служебного сообщения  (см. описание параметра Событие).