項目の背景色属性の設定（ ps_set_item_bgcolor ）

【提供インタフェース】

【機能説明】

項目の背景色属性を動的に設定します。プリンタ機能でだけ有効な機能です。プリンタ情報ファイルのPRTITEMCTL(項目制御 部拡張指定)で「5」を指定したときに有効です。背景色の詳細については網がけの印刷を参照してください。

【 】

[形式]

void ps_set_item_bgcolor(

PSPUCHAR field, PSUCHAR value);

[パラメタ]

field : 属性を設定する項目を指定します。

value : 設定する背景色属性を指定します。値とその意味は以下のとおりです。

PS_BGCOLOR_NORMAL : 背景色で塗りません。

PS_BGCOLOR_BLUE : 青色で出力します。

PS_BGCOLOR_RED : 赤色で出力します。

PS_BGCOLOR_PINK : 桃色で出力します。

PS_BGCOLOR_GREEN : 緑色で出力します。

PS_BGCOLOR_CYAN : 水色で出力します。

PS_BGCOLOR_YELLOW : 黄色で出力します。

PS_BGCOLOR_WHITE : 白色で出力します。

PS_BGCOLOR_BLACK : 黒色で出力します。

PS_BGCOLOR_GRAY : 灰色で出力します。

PS_BGCOLOR_D_BLUE : 暗い青色で出力します。

PS_BGCOLOR_D_RED : 暗い赤色で出力します。

PS_BGCOLOR_D_PINK : 暗い桃色で出力します。

PS_BGCOLOR_D_GREEN : 暗い緑色で出力します。

PS_BGCOLOR_D_CYAN : 暗い水色で出力します。

PS_BGCOLOR_D_YELLOW : 暗い黄色で出力します。

PS_BGCOLOR_D_GRAY : 暗い灰色で出力します。

PS_BGCOLOR_CUSTOM01 : カスタム色１で出力します。

PS_BGCOLOR_CUSTOM02 : カスタム色２で出力します。

PS_BGCOLOR_CUSTOM03 : カスタム色３で出力します。

PS_BGCOLOR_CUSTOM04 : カスタム色４で出力します。

PS_BGCOLOR_CUSTOM05 : カスタム色５で出力します。

PS_BGCOLOR_CUSTOM06 : カスタム色６で出力します。

PS_BGCOLOR_CUSTOM07 : カスタム色７で出力します。

PS_BGCOLOR_CUSTOM08 : カスタム色８で出力します。

PS_BGCOLOR_CUSTOM09 : カスタム色９で出力します。

PS_BGCOLOR_CUSTOM10 : カスタム色１０で出力します。

PS_BGCOLOR_CUSTOM11 : カスタム色１１で出力します。

PS_BGCOLOR_CUSTOM12 : カスタム色１２で出力します。

PS_BGCOLOR_CUSTOM13 : カスタム色１３で出力します。

PS_BGCOLOR_CUSTOM14 : カスタム色１４で出力します。

PS_BGCOLOR_CUSTOM15 : カスタム色１５で出力します。

PS_BGCOLOR_CUSTOM16 : カスタム色１６で出力します。

[使用例]

定義体を帳票に印刷するときに、項目名"W001"を青色の背景色で出力します。

PSFILE psfile;

SAMPLE samp;

PSUSHORT Error;

psfile = ps_open("PRTFILE",PS_OPEN_PRT,&Error,0);

ps_set_formatsize(psfile,"SAMPLE",s_SAMPLE);

～ レコードデータ領域 samp へのデータ設定 ～ ps_set_item_bgcolor(samp.W001,PS_BGCOLOR_BLUE);

ps_write(psfile,PS_WRITE_NORMAL,"SCREEN",&samp,0);

【 】

[形式]

項目ごとの特殊レジスタEDIT-OPTION2に指定する。

[パラメタ]

特殊レジスタEDIT-OPTION2 : 設定する背景色属性を指定します。値とその意味は以下のとおりで す。

" " (半角の空白) : 背景色で塗りません。

"B" : 青色で出力します。

"R" : 赤色で出力します。

"P" : 桃色で出力します。

"G" : 緑色で出力します。

"T" : 水色で出力します。

"Y" : 黄色で出力します。

"W" : 白色で出力します。

"A" : 黒色で出力します。

"D" : 灰色で出力します。

"K" : 暗い青色で出力します。

"F" : 暗い赤色で出力します。

"J" : 暗い桃色で出力します。

"E" : 暗い緑色で出力します。

"I" : 暗い水色で出力します。

"C" : 暗い黄色で出力します。

"O"(オー) : 暗い灰色で出力します。

"1" : カスタム色１で出力します。

"2" : カスタム色２で出力します。

"3" : カスタム色３で出力します。

"4" : カスタム色４で出力します。

"5" : カスタム色５で出力します。

"6" : カスタム色６で出力します。

"7" : カスタム色７で出力します。

"8" : カスタム色８で出力します。

"9" : カスタム色９で出力します。

"0" : カスタム色１０で出力します。

"H" : カスタム色１１で出力します。

"L" : カスタム色１２で出力します。

"M" : カスタム色１３で出力します。

"N" : カスタム色１４で出力します。

"Q" : カスタム色１５で出力します。

"S" : カスタム色１６で出力します。

[使用例]

定義体を帳票に印刷するときに、項目名"W001"を青色の背景色で出力します。

MOVE "SAMP" TO PRT-FORMAT.

MOVE " " TO PRT-MODE.

MOVE "B" TO EDIT-OPTION2 OF W001.

MOVE "W001" TO PRT-GROUP.

WRITE SAMP.

【注意事項】

－ 画面帳票定義体を使用する場合、定義体作成時に共用しない（5バイト）の項目制御部を定義する必要があります。

－ カスタム色は、帳票定義体に指定された項目のカラーパレットで定義された色で出力されますが、色が定義されていない場合 は、白色で出力されます。

－ 画面帳票定義体でカスタム色を指定した場合の出力結果は保証されません。

－ 本機能の戻り値はありません。