PrintReport

<< Click to Display Table of Contents >>

マニュアル > コントロールリファレンス > データ > サマリレポートグリッドコントロール > メソッド >

PrintReport


 

サマリサーバにレポートの印刷を指示する。

 


構文

PrintReport(

         summaryName,

         startReferenceDate,

         endReferenceDate,

         groupId,

         pageId,

         printerName,

         bPreview,

         startWaitTime,

         waitMode

         [,pageTargetID = 0]

         [,showProgressBar = T]

         [,reportLayoutMaster = ""]

         [,reportLayoutMasterSheet = ""]

         [,fileType = ""]

         )

 


パラメータ

 

summaryName


型:

文字


DAY/MONTH/YEARなどのサマリ名(集計ログ名)。

 

startReferenceDate


型:

時刻


作成したいサブレポートの期間の開始リファレンス時刻。

リファレンス時刻に関する詳細はサマリマスタの集計ログセクションの「ReferenceOffset」パラメータの記述を参照してください。

 

endReferenceDate


型:

時刻


作成したいサブレポートの期間の終了リファレンス時刻。終了リファレンス時刻ちょうどのレコードは含まれません。

リファレンス時刻に関する詳細はサマリマスタの集計ログセクションの「ReferenceOffset」パラメータの記述を参照してください。

 

groupId


型:

数値


印刷したいレポートのグループを0から始まるインデックスで指定します。

-1        - 全グループを印刷

0以上        - 指定したグループのみを印刷

 

pageId


型:

数値


印刷したいレポートのページを0から始まるインデックスで指定します。

-1        - 全ページを印刷

0以上        - 指定したページのみを印刷

 

printerName


型:

文字


プリンタ名です。空文字""の場合サマリーマスターファイルで指定したデフォルトのプリンタが使用されます。

 

bPreview


型:

ブール


印刷前にプレビュー画面を表示します。テスト時の確認用のためのみに使用してください。

 

startWaitTime


型:

数値


印刷を開始する前の待ち時間(msec)を指定します。

bWaitUntilCreatedにFを指定しPrintReportメソッドを連続的に実行した場合、実際の印刷のタイミングが前後することによりページ順も前後してしまう場合があります。

そのようなとき、印刷開始待時間をそれぞれずらして指定することにより印字の順序を調整します。

 

waitMode


型:

文字


"wait_true"(もしくはブール値のT) : 印刷終了までメソッド終了を待つ。

"wait_false"(もしくはブール値のF) : 印刷終了を待たず、即座にメソッドが終了。

”wait_true_event" : 印刷終了までメソッド終了を待つ。印刷終了後OnSummaryNotification(type="printreport_done")イベントが発生する。

”wait_false_event" : 印刷終了までメソッド終了を待たない。印刷終了後OnSummaryNotification(type="printreport_done")イベントが発生する。

 

pageTargetID


型:

数値


0 - 指定されたグループIDおよびページIDで該当するすべてのページを印刷。

1 - ページプロパティPageTarget1の値に従い印刷。

2 - ページプロパティPageTarget2の値に従い印刷。

x - ページプロパティPageTarge[x]の値に従い印刷。

※ページプロパティについてはSetPagePropertyを参照

 

showProgressBar


型:

ブール


T - プログレスバーを表示

F - プログレスバーを非表示

 

reportLayoutMaster


型:

文字


レイアウトマスターファイルのファイル名。何も指定しないと、標準のレイアウトマスターファイル。

 

reportLayoutMasterSheet


型:

文字


レイアウトマスターファイルのシート名。何も指定しないと、標準のシート。

 

fileType


型:

文字


出力するファイルのタイプ。”excel"のみ選択可能。

 

"excel" - Excelファイル

 

●ファイルタイプがExcelの場合、「excel」以降に以下の文字列を「_」で連結することにより、詳細な形式を設定できます。

 

・date[summarymaster]

サマリマスタファイルのReportTitleDateFormatにしたがって時刻列の文字が決定されます。

・date['@DATETIME']

指定した書式にしたがって時刻列の文字が決定されます。'@DATETIME'の部分は自由に指定できます。

指定可能な書式についてはサマリマスタのReportTitleDateFormatプロパティを参照してください。

・locale[ja-JP]

ロケールを指定します。ja-JPの部分は自由に指定できます。指定しないと、サーバーが動作しているOSのロケールに従います。

ロケールを指定すると、レポートマスターファイル「layoutmaster.xls」の末尾にロケール文字を付加したファイル(例 「layoutmaster_ja-JP.xls」)があった場合、そちらを使用します。言語毎にレポートマスターファイルを分けることができます。

 

例)

"excel"

"excel_date['@[%m月%d日(%a)]']"

"excel_date['@[%m月%d日(%a)]']_locale[ja-JP]"

"excel_date['@DATETIME.%md.[(%a)]]']_locale[de]"

 

 

戻り値



型:

ブール


FALSE - 失敗。TRUE - 成功。実際に印刷が成功したかどうかを取得するためには、印刷終了まで待つ必要があるため、waitModeをTにしてください。

印刷時間に時間がかかる場合、タイムアウト時間(PSTimeOutルートプロパティ)を調整してください。

 


hmtoggle_plus1 解説

 


参照