Advanced Configurations

MatrixScan Find is optimized by default for efficiency, accuracy, and a seamless user experience. 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;
// …