ReceiptPrintJob.DrawRuledLine メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
レシート プリンター ステーションの用紙に描画された罫線を印刷する命令を印刷ジョブに追加します。
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 または罫線エスケープ シーケンスの呼び出しによって垂直方向の罫線が変更または終了されるまで、後続の印刷行の各位置から描画されます。 引数 positionLine に空の文字列を指定すると、垂直の罫線が終了します。 次の例について考えます。
positionList = "0,100,400,500"
この positionList では、データの各行が印刷されるときに、単位位置 "0"、"100"、"400"、および "500" から始まる 4 本の罫線が描画されます。