ReceiptPrintJob.PrintBarcode 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
將指令新增至列印工作,以在收據印表機站上列印具有指定資料和符號的條碼。
public:
virtual void PrintBarcode(Platform::String ^ data, unsigned int symbology, unsigned int height, unsigned int width, PosPrinterBarcodeTextPosition textPosition, PosPrinterAlignment alignment) = PrintBarcode;
void PrintBarcode(winrt::hstring const& data, uint32_t const& symbology, uint32_t const& height, uint32_t const& width, PosPrinterBarcodeTextPosition const& textPosition, PosPrinterAlignment const& alignment);
public void PrintBarcode(string data, uint symbology, uint height, uint width, PosPrinterBarcodeTextPosition textPosition, PosPrinterAlignment alignment);
function printBarcode(data, symbology, height, width, textPosition, alignment)
Public Sub PrintBarcode (data As String, symbology As UInteger, height As UInteger, width As UInteger, textPosition As PosPrinterBarcodeTextPosition, alignment As PosPrinterAlignment)
參數
- data
-
String
Platform::String
winrt::hstring
要表示為條碼的資料。
- symbology
-
UInt32
unsigned int
uint32_t
條碼的符號 (編碼) 。 這可以根據 BarcodeSymbologies 類別靜態方法來決定。
- height
-
UInt32
unsigned int
uint32_t
條碼的高度,以 ClaimedPosPrinter.MapMode 屬性所表示的度量單位表示。
- width
-
UInt32
unsigned int
uint32_t
條碼的寬度。
此值會以下列兩種方式之一解譯:
整個條碼的寬度,以 ClaimedPosPrinter.MapMode 屬性所表示的度量單位表示。
或者 (,雖然我們不建議使用此方法) 如果值小於或等於 6,但會交錯,如下所示:
ESC/POS 控制語言用於大部分的 Windows POS 裝置通訊,而 ESC/POS 只接受 2 到 6 的整數。 每個值都包含條碼之精簡和粗元素的相符度量。 為了讓條碼正確讀取,線條的寬度很重要,特別是在縮放時。 此外,最小寬度功能會依印表機型號而有所不同。
實際大小取決於目標印表機的功能,但接受值的近似大小為:
寬度值 | 精簡元素 | 粗元素 |
---|---|---|
2 | 0.250 - 0.282 公釐 | 0.625 - 0.706 公釐 |
3 | 0.375 - 0.423 公釐 | 1.000 - 1.129 公釐 |
4 | 0.500 - 0.564 公釐 | 1.250 - 1.411 公釐 |
5 | 0.625 - 0.706 公釐 | 1.625 - 1.834 公釐 |
6 | 0.750 - 0.847 公釐 | 2.000 - 2.258 公釐 |
如需 ESC/POS 的詳細資訊,請參閱 POS 印表機 中的備註。
- textPosition
- PosPrinterBarcodeTextPosition
條碼文字相對於條碼的垂直位置。
- alignment
- PosPrinterAlignment
頁面上條碼的水準對齊方式。
實作
M:Windows.Devices.PointOfService.IReceiptOrSlipJob.PrintBarcode(System.String,System.UInt32,System.UInt32,System.UInt32,Windows.Devices.PointOfService.PosPrinterBarcodeTextPosition,Windows.Devices.PointOfService.PosPrinterAlignment)
M:Windows.Devices.PointOfService.IReceiptOrSlipJob.PrintBarcode(Platform::String,unsigned int,unsigned int,unsigned int,Windows.Devices.PointOfService.PosPrinterBarcodeTextPosition,Windows.Devices.PointOfService.PosPrinterAlignment)
M:Windows.Devices.PointOfService.IReceiptOrSlipJob.PrintBarcode(winrt::hstring,uint32_t,uint32_t,uint32_t,Windows.Devices.PointOfService.PosPrinterBarcodeTextPosition,Windows.Devices.PointOfService.PosPrinterAlignment)