Operation mode property

Official Content
This documentation is valid for:
When set to Single read, the control reads the first code and then stops scanning. When Continuous read is selected, it reads all the codes it can while the control is visible, non-stop.

Values

Continuous read
Single read

Scope

Generators: Android, Apple
Controls: Attribute/Variable (Control Type: Scanner)
Level: Attribute, Domain, Variable

Description

This property is offered in Panel objects for variables or attributes whose Control Type property = Scanner.

It enables the Scanner Control to control how the reading will be handled.

Use the CodeRead or ControlValueChanged events to process it.
The difference between both events is that CodeRead will scan non-stop and possibly repeat the same detection, while ControlValueChanged will not repeat consecutive reads.

This property is available in a Panel object with a variable or attribute Scanner control.

Single Read

The control reads the first code and then stops scanning.

Continuous Read

The control reads all the codes it can while the control is visible (non-stop). Set the control Visible property to false if you want to stop reading codes.

Run-time/Design-time

This property applies only at design-time.

Samples

Define &code1 and &code2 as Varchar variables and set the Scanner control type.

To process different codes, use the ControlValueChanged event:

Event &code1.ControlValueChanged // Inline + Continuous Read
    Composite
        &CodesCollection.Add(&code1)
    EndComposite
Endevent

To process all codes, use the CodeRead event:

Event &code2.CodeRead // Inline + Continuous Read
    Composite
        &CodesCollection.Add(&code1)
    EndComposite
Endevent

How to apply changes

To apply the corresponding changes when the property value is configured, execute a Build with this Only of the object.

Availability

This property is available since GeneXus 17 Upgrade 5.

See Also

Display mode property