ReceiptPrintJob.DrawRuledLine Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Добавляет инструкцию к заданию печати для печати нарисованной линии с правилом на бумаге станции чекового принтера.
public:
virtual void DrawRuledLine(Platform::String ^ positionList, PosPrinterLineDirection lineDirection, unsigned int lineWidth, PosPrinterLineStyle lineStyle, unsigned int lineColor) = DrawRuledLine;void DrawRuledLine(winrt::hstring const& positionList, PosPrinterLineDirection const& lineDirection, uint32_t const& lineWidth, PosPrinterLineStyle const& lineStyle, uint32_t const& lineColor);public void DrawRuledLine(string positionList, PosPrinterLineDirection lineDirection, uint lineWidth, PosPrinterLineStyle lineStyle, uint lineColor);function drawRuledLine(positionList, lineDirection, lineWidth, lineStyle, lineColor)Public Sub DrawRuledLine (positionList As String, lineDirection As PosPrinterLineDirection, lineWidth As UInteger, lineStyle As PosPrinterLineStyle, lineColor As UInteger)Параметры
- positionList
-
String
Platform::String
winrt::hstring
Параметры позиции для строки с правилом. Строка символов для positionList отличается в зависимости от того, определяет ли lineDirection горизонтальную или вертикальную линию с правилом (см. примечания).
- lineDirection
- PosPrinterLineDirection
Направление, в котором следует напечатать управленную линию.
- lineWidth
-
UInt32
unsigned int
uint32_t
Ширина линии правила, которую должна напечатать печать. Единица ширины — точка. Если указано неподдерживаемое значение, используется наиболее подходящее значение для принтера.
- lineStyle
- PosPrinterLineStyle
Внешний вид управленной линии, например, является ли она сплошной или сломанной, одиночной или двойной.
- lineColor
-
UInt32
unsigned int
uint32_t
Цвет строки с правилом в виде целочисленного значения, равного значению константы патрона, используемой в свойстве ClaimedReceiptPrinter.ColorCartridge . Если указано неподдерживаемое значение, результаты печати могут быть непредсказуемыми.
Реализации
Комментарии
Аргумент positionList зависит от того, рисуется ли горизонтальная или вертикальная линия.
Для горизонтальных линий с правилами positionList состоит из чисел, разделенных запятыми (единицы измерения определяются свойством MapMode ), которые обозначают начальную позицию и длину каждой строки. За каждой парой следует точка с запятой, если указано несколько управляемых строк. Шаблон повторяется для всех дополнительных горизонтальных линий с правилом. Рассмотрим следующий пример.
positionList = "0,500"
Этот positionList приведет к тому, что строка, начинающаяся с позиции единицы MapMode "0", будет продолжаться для 500 единиц mapMode длины. Вот еще один пример, демонстрирующий несколько горизонтальных линий:
positionList = "0,200;300,100"
Этот positionList приведет к тому, что строка с правилом начинается с позиции единицы "0" и продолжается в течение 200 единиц в длину. Затем другая линия начнется с позиции 300 и продолжится в течение 100 единиц в длину.
Для вертикальных линий positionList состоит из чисел с разделителями-запятыми (единицы измерения определяются свойством MapMode ), которые обозначают позиции для линий вертикально нарисованных правил. Линия продолжения с вертикальным правилом будет отрисовываться из каждой позиции для последующих линий печати до тех пор, пока линии вертикальных правил не будут изменены или не будут завершены вызовом DrawRuledLine или escape-последовательностью управляемых строк. Пустая строка в аргументе positionLine приводит к завершению вертикальных управляемых строк. Рассмотрим следующий пример.
positionList = "0,100,400,500"
Этот positionList приводит к четырем нарисованным линиям с правилами, начиная с позиций единиц "0", "100", "400" и "500" при печати каждой строки данных.