[column]

対象のプリンターにあわせて調整された2列の書式付きテキストを出力します。

略式コマンド名

コマンド名 column``の代わりに、 ``two-column, col, または 2col を使用することができます。
したがって、 [col] と [column] は同等となります。

パラメーター

列レイアウトを構成するため、またはフォーマットされた列を出力するためにいくつかのパラメーターを提供できます。
あるいは、 [column] コマンドをパラメーターなしで使用すると、インデントなどの設定値がデフォルトにリセットされます。

Parameter

Description

left

左側列のテキストを指定します。

right

右側列のテキストを指定します。

short

left で指定したデータが利用可能な印刷幅に適合しない場合に使用される、 left データの短縮版の代替データを指定します。

variable-left / vl
left で指定したデータが利用可能な印刷幅に適合しない場合に、１行に収まるように left データを省略します。
short と同時に指定した場合、 variable-left が優先されます。

indent
左側のインデントサイズをプリンタードット、mm、または印刷幅の割合で設定します。
これが負の値の場合、インデントは全印刷領域から指定値の絶対値分を差し引いた長さを適用します。
新しいインデント値は、リセット/変更されるまで後続の列に影響することに注意してください。

重要

variable-left オプションは、.NET API (StarMicronics.CloudPRNT-Utilityパッケージ) V1.2.0以降, および CPUtil V1.2.0以降で利用できます。

使い方

columnコマンドは、デバイスの機能、フォントサイズ、用紙幅などの違いを隠す方法で、POSプリンターの一般的な要件を処理します。

使用する際に、 left, right, および short パラメーターの1つ以上が指定されている場合、列の1行が出力されます。
利用可能な印刷領域が狭すぎて、 left および right パラメーター値（現在指定されているフォント）に基づいて列の行を印刷できない場合、 left の代わりに short パラメーター値が使用されます。
short の代わりに利用可能な variable-left / vl パラメーターは、印字領域に収まるように left パラメーターのテキストを省略します。
最後に1行の列を印刷するのに十分なスペースがない場合は、代わりに2列のレイアウトが使用されます。
オプションで、 indent パラメーター値を指定して列の左マージンを設定できます。
これは、列データを指定することなく設定でき、その値は、インデントが変更またはリセットされるまで、後続のすべての行に影響します。
負のインデント値を指定することもできます。
これにより、インデントが負の場合、全印刷領域から指定値の絶対値分を差し引いた長さを設定します。

サンプル

入力

これは、[column] と [cut] コマンドのみを使用した簡単なStar マークアップの例です。

Column Example

Simple Column:
[column: left Item 1; right 1.00]
[column: left Item 2; right 1.00]
[column: left Item 3; right 1.00]

Column with Item fitting: short
[column: left This is a description of Item One;
        short Item 1;
        right 1.00]
[column: left This is a description of Item Two;
        short Item 2;
        right 1.00]
[column: left This is a description of Item Three;
        short Item 3;
        right 1.00]

Column with Item fitting: variable-left
[column: left Item One : long long description;
        vl;
        right 1.00]
[column: left Item Two : long long description;
        vl;
        right 1.00]
[column: left Item Three : long long description;
        vl;
        right 1.00]

Indented Column:
[column: left Item 1; right 1.00; indent 5mm]
[column: left Item 2; right 1.00]
[column: left Item 3; right 1.00]

Indented from right:
[col: indent -20mm]\
[column: left Item 1; right 1.00]
[column: left Item 2; right 1.00]
[column: left Item 3; right 1.00]

[cut]\

出力 58mm幅

これは、Star マークアップシステムを利用して生成した出力結果をmC-Print2 58mm（2inch）プリンターに送信した場合の結果です。

../../_images/column_58mm.jpg

出力 80mm幅

これは、Star マークアップシステムを利用して生成した出力結果をmC-Print3 80mm（3inch）プリンターに送信した場合の結果です。

../../_images/column_80mm.jpg