ReceiptPrintJob.DrawRuledLine Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Fügt dem Druckauftrag eine Anweisung hinzu, um eine gezeichnete, regelte Linie auf dem Papier der Belegdruckerstation zu drucken.
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)Parameter
- positionList
-
String
Platform::String
winrt::hstring
Die Positionsparameter für die gewertete Linie. Die Zeichenfolge für positionList unterscheidet sich je nachdem, ob lineDirection eine horizontale oder eine vertikale ruled Linie angibt (siehe Hinweise).
- lineDirection
- PosPrinterLineDirection
Die Richtung, in der die direktionale Zeile gedruckt werden soll.
- lineWidth
-
UInt32
unsigned int
uint32_t
Die Breite der vom Druck zu druckenen strichenen Linie. Die Einheit der Breite ist Punkt. Wenn ein nicht unterstützter Wert angegeben wird, wird der am besten geeignete Wert für den Drucker verwendet.
- lineStyle
- PosPrinterLineStyle
Das Aussehen der regelten Linie, z. B. ob sie einfarbig oder unterbrochen oder single oder double ist.
- lineColor
-
UInt32
unsigned int
uint32_t
Die Farbe der Regellinie als ganzzahliger Wert, der dem Wert der Patronenkonstante entspricht, die in der ClaimedReceiptPrinter.ColorCartridge-Eigenschaft verwendet wird. Wenn ein nicht unterstützter Wert angegeben wird, sind die Druckergebnisse möglicherweise unvorhersehbar.
Implementiert
Hinweise
Das argument positionList variiert je nachdem, ob eine horizontale oder eine vertikale regelte Linie gezeichnet wird.
Bei horizontalen regelden Linien besteht positionList aus durch Kommas getrennten Zahlen (Maßeinheiten werden durch die MapMode-Eigenschaft definiert), die die Startposition und Länge jeder Zeile angeben. Jedem Paar folgt ein Semikolon, wenn mehrere ruled Zeilen angegeben sind. Das Muster wird für alle zusätzlichen horizontalen Linien wiederholt. Betrachten Sie das folgende Beispiel:
positionList = "0,500"
Diese positionList führt dazu, dass eine regelte Linie ab MapMode-Einheitsposition "0" für 500 MapMode-Einheiten der Länge fortgesetzt wird. Hier sehen Sie ein weiteres Beispiel, das mehrere horizontale Linien veranschaulicht:
positionList = "0,200;300,100"
Diese positionList würde zu einer regelten Linie führen, die bei der Einheitsposition "0" beginnt und für eine Länge von 200 Einheiten fortgesetzt wird. Dann würde eine andere Zeile an Position 300 beginnen und für 100 Einheiten länge fortgesetzt.
Bei vertikal geregelten Linien besteht positionList aus durch Kommas getrennten Zahlen (Maßeinheiten werden durch die MapMode-Eigenschaft definiert), die die Positionen für die vertikal gezeichneten Regellinien bezeichnen. Von jeder Position für die folgenden Drucklinien wird eine vertikale Regellinie weiter gezeichnet, bis die vertikalen Regellinien durch einen Aufruf von DrawRuledLine oder einer Escapesequenz für regelte Linien geändert oder beendet werden. Eine leere Zeichenfolge im Argument positionLine bewirkt, dass die vertikalen ruled Zeilen beendet werden. Betrachten Sie das folgende Beispiel:
positionList = "0,100,400,500"
Diese positionList führt zu vier gezeichneten Strichen, die an den Einheitenpositionen "0", "100", "400" und "500" beginnen, wenn jede Datenzeile gedruckt wird.