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

3/2/2014

Determines and controls the state of the tare and unit price values used by the scale.

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

Syntax

'Declaration
Public MustOverride Sub FreezeValue ( _
    item As Integer, _
    freeze As Boolean _
)
public abstract void FreezeValue (
    int item,
    bool freeze
)
public:
virtual void FreezeValue (
    int item, 
    bool freeze
) abstract
public abstract void FreezeValue (
    int item, 
    boolean freeze
)
public abstract function FreezeValue (
    item : int, 
    freeze : boolean
)

Parameters

  • item
    The bitwise value of FreezeValueType flags that sets the state of the selected parameter item or items.
  • freeze
    If true, the item is not automatically set to zero when the item is removed from the scale.

Remarks

This method performs a bitwise logical OR function to determine the state of the item or items selected after a ReadWeight or a DoPriceCalculating method is called. If the item bit value is true, then the scale does not clear (set to zero) the associated tare values and/or unit price. If item bit value is false, then the scale will clear (set to zero) the associated tare values and/or unit price.

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 the freezing of the requested tare or unit price value.

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