Advanced Configurations

MatrixScan Find is optimized by default for efficiency, accuracy, and responsiveness. However, there are multiple advanced settings available to further customize MatrixScan Find to best fit your needs.

BarcodeFind Listener

You may want more fine-grained knowledge over the different events happening during the life of the BarcodeFind mode, such as when the search starts, pauses and stops. To do this, you can directly register a IBarcodeFindListener on the mode itself.

Be aware that these listeners will be called from a background thread.

public class BarcodeFindListener : IBarcodeFindListener
{
public void OnSearchPaused(ICollection<BarcodeFindItem> foundItems)
    {
    // The mode was paused
    }

    public void OnSearchStarted()
    {
    // The mode was started
    }

    public void OnSearchStopped(ICollection<BarcodeFindItem> foundItems)
{
// The mode was stopped after the finish button was clicked
}
}

private void Initialize()
{
barcodeFind.AddListener(new BarcodeFindListener())
}

Alternatively it is possible to subscribe to corresponding events BarcodeFind.SearchPaused, BarcodeFind.SearchStarted or BarcodeFind.SearchStopped. For example:

barcodeFind.SearchStarted += (object? sender, EventArgs args) =>
{
// The mode was started
};
barcodeFind.SearchPaused += (object? sender, BarcodeFindEventArgs args) =>
{
// The mode was paused
};
barcodeFind.SearchStopped += (object? sender, BarcodeFindEventArgs args) =>
{
// The mode was stopped after the finish button was clicked
};

UI configuration

The BarcodeFindView will by default show a set of UI elements, which can be optionally hidden:

• A play/pause button
• A finish button
• A searched items carousel
• Guidance hints

There is also a progress bar but this is hidden by default.

Each of these elements can be shown or hidden at will.

barcodeFindView.ShouldShowCarousel = false;
barcodeFindView.ShouldShowProgressBar = true;
// …