Scale.SetSpecialTare Method (POS for .NET v1.14 SDK Documentation)

  • Article

3/2/2014

Sets how the scale uses the tare values to determine net weight and item price.

Namespace: Microsoft.PointOfService
Assembly: Microsoft.PointOfService (in microsoft.pointofservice.dll)

Syntax

'Declaration
Public MustOverride Sub SetSpecialTare ( _
    mode As SpecialTare, _
    data As Integer _
)

public abstract void SetSpecialTare (
    SpecialTare mode,
    int data
)

public:
virtual void SetSpecialTare (
    SpecialTare mode, 
    int data
) abstract

public abstract void SetSpecialTare (
    SpecialTare mode, 
    int data
)

public abstract function SetSpecialTare (
    mode : SpecialTare, 
    data : int
)

Parameters

  • data
    Additional information specific to the mode that determines the characteristics for the tare to be modified.

Remarks

The TareWeight used by the scale usually differs from the data parameter and depends on the rounding rules of the scale. The exact value for data is returned by the DoPriceCalculating method.

If a tare is set, additional SetSpecialTare calls with the same mode are accepted and update the new data value. Other values of the mode parameter may be accepted and depend upon the tare priority indicated by the SetTarePriority or the influence of local jurisdictional laws.

In addition, the tare value may be deleted automatically if this action is required as a result of a prior FreezeValue method call.

This method may cause a PosControlException to be thrown with the following error codes:

Value

Meaning

E_ILLEGAL

The current state of the scale device does not allow this operation.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread-safe. Any instance members are not guaranteed to be thread-safe.

See Also

Reference

Scale Class
Scale Members
Microsoft.PointOfService Namespace