Python から Win32 API 経由で印刷する

Win32 API から印刷をするためには、プリンタデバイスコンテキスト (Printer DC) を利用します。具体的には以下のような順序で印刷します。

  1. プリンタドライバからハンドルを取得する
  2. プリンタドライバのステータス API から印刷可能か同かを取得する
  3. プリンタデバイスコンテキストを作成する
  4. ドキュメントを開始する
  5. 必要であればフォント等を設定し、印字、改ページ処理などをする
  6. ドキュメントを終了する (この時点でプリンタスプールサービスに登録されるようです)
  7. プリンタデバイスコンテキストを開放する
  8. プリンタドライバのステータス API を監視し、印刷が正常に終了したかを取得する
  9. プリンタドライバのハンドルを解放する

太字の手順 (3 - 7) は Win32 API で共通ですが、それ以外の手順 (1, 2, 8, 9) はプリンタドライバに依存しているため、Python から制御したい場合はライブラリを作成する必要があります。これについては、ドライバマニュアルとにらめっこしながら ctypes.windll でがんばります・・・。プリンタ接続、用紙切れ、ミスフィード等のプリントエラーを制御する必要がなければ、書く必要はありません (排他制御が必要なプリンタを除く)。プリンタドライバ毎に変わる部分は置いといて、太字の Win32 API の部分の覚書です。

プリンタデバイスコンテキストを作成する

import win32ui
import win32con

PRINTER_NAME = '[コンパネ -> プリンタとFAX -> に登録しているプリンター名]'
PIXELS_PER_INCH = 1440 # 1 インチ毎のピクセル数
INCH_PER_POINT = 72 # 1 インチ毎のポイント数
SCALE_FACTOR = int(PIXELS_PER_INCH / INCH_PER_POINT) #　わざわざ計算せず 20 と指定する場合が多い

dc = win32ui.CreateDC()
dc.CreatePrinterDC(PRINTER_NAME) # 指定したプリンタ名のプリンタデバイスコンテキストを作成する
self.dc.SetMapMode(win32con.MM_TWIPS) # デバイスコンテキストのマッピングモード (座標単位) を設定する

SetMapMode で win32con.MM_TWIPS を指定しているため、1 インチ毎のポイント数 20 を計算しています。その他の単位で印字したい場合は、msdn のサイトで詳しく解説されています。

ドキュメントを開始する

dc.StartDoc(u'[ドキュメント名]') # 印刷ジョブを区別するためにユニークなドキュメント名を設定する

必要であればフォント等を設定し、印字、改ページ処理などをする

u"""
フォントは以下が指定可能::
    name -- フォント名
    width -- 平均文字幅
    height -- フォントの高さ
    weight -- フォントの太さ
        0 (win32con.FW_DONTCARE) - 1000 (win32con.FW_BLACK) までで指定する。
        標準は 400 (win32con.FW_REGULAR)。
    italic -- 斜体にするかどうか
    underline -- 下線を付けるかどうか
    pitch and family -- ピッチとファミリ
    charset -- 文字セット
        標準は Windows 文字セット (win32con.ANSI_CHARSET)
        日本語の場合はシフト JIS 文字セット (win32con.SHIFTJIS_CHARSET)
詳細: http://msdn.microsoft.com/ja-jp/library/cc428368.aspx
"""
fontdict = {
    "height": SCALE_FACTOR * 10, # 10 ポイント
    "name": u"[フォント名]", # "MS ゴシック" 等のフォント名
    "charset": win32con.SHIFTJIS_CHARSET, # シフト JIS 文字セット
}
font = win32ui.CreateFont(fontdict) # CFont インスタンスを作成

# フォントオブジェクトのセット: http://msdn.microsoft.com/ja-jp/library/cc410576.aspx
# フォントをセットすると今までセットされてたフォントを返してくれるので保持しとく。
oldfont = dc.SelectObject(font) 

# 描画: http://msdn.microsoft.com/ja-jp/library/cc428775.aspx
dc.TextOut(0, SCALE_FACTOR * 10 * -1, u"印字") # 1 行目
dc.TextOut(0, SCALE_FACTOR * 10 * -2, u"印字") # 2 行目
dc.TextOut(0, SCALE_FACTOR * 10 * -3, u"印字") # 3 行目

# フォントを元に戻す
dc.SelectObject(oldfont)

# 改ページ処理
dc.EndPage()

改行処理は手動でする必要があります。私は 1 文字ずつ印字していき、指定した横幅に達したら改行するように制御しています。

# 行の幅と高さを計算: http://msdn.microsoft.com/ja-jp/library/z7e878zz%28VS.80%29.aspx
x, y = dc.GetTextExtent(u"長文 ...")

アライン設定は SetTextAlign を使います。

# テキスト配置フラグ設定: http://msdn.microsoft.com/ja-jp/library/cc428723.aspx
dc.SetTextAlign(win32con.TA_LEFT | win32con.TA_TOP | win32con.TA_NOUPDATECP) # 左寄せ
dc.SetTextAlign(win32con.TA_CENTER | win32con.TA_TOP | win32con.TA_NOUPDATECP) # センタリング
dc.SetTextAlign(win32con.TA_RIGHT | win32con.TA_TOP | win32con.TA_NOUPDATECP) # 右寄せ

ドキュメントを終了する

dc.EndDoc()

プリンタデバイスコンテキストを開放する

dc.DeleteDC()

コメント

コメントを投稿

このブログの人気の投稿

財務諸表 (Financial Statements)

※ 業務 & 英語の勉強 財務諸表 (Financial Statements) の種類 諸表名 英語表記 概要 損益計算書 Profit and Loss Statement [P/L] ※ Income Statement など様々 収益と費用の状態を表す 貸借対照表 Balance sheet [B/S] 資産、負債、純資産を表す キャッシュ・フロー計算書 Cash flow Statement [C/S] 資金の増減を表す 株主資本等変動計算書 Statements of Shareholders' Equity [S/S] 純資産の変動状況を表す 損益計算書 損益計算書とは 収益から費用を差し引いた利益を計算するためのもの 利益 (profit) = 収益 (revenue) - 費用 (expense) 損益計算書の構成 記載内容 英語表記 概要 売上高 Sales 販売した財やサービスの金額 売上原価 Cost of Sales 財やサービスを生み出すための経費 期首繰越高＋当期仕入高－期末棚卸高 - 売上総利益 Gross Profit = 売上高 - 売上原価 ※ 売上高総利益率 [ 粗利益率] (Shareholder Equity Ratio) = 売上総利益 / 売上高 販売費及び一般管理費 Selling and General Administrative expenses [SGA] 売上原価以外の企業を運営するための経費 販売費: 販売手数料、広告宣伝費など 一般管理費: 人件費、福利厚生費、交際費、賃借料、減価償却費、雑費など - 営業利益 Operating Profit = 売上総利益 - 販売費及び一般管理費 営業外収益 Non-operating income 本業以外で経常的に発生する収益 受取利息、有価証券売却益、配当金、不動産賃貸収入など 営業外費用 Non-operating expense 本業以外で経常的に発生する経費 支払利息、有価証券売却損など - 経常利益 Ordinary Profit = 営業利益 + 営業外収益
続きを読む

Django と Python 3 - #python_adv

Django-ja の方からきました。こんにちわ。さて、昨日の Ian 先生のブログ にも書いてある通り、ついに Django にも本格的に Python 3 の足音が近づいてきました。ただし現在 alpha 版が公開されている 1.5 では "実験的" なサポートで、1.6 以降で正式にサポートする予定となっています。あくまでも "実験的" であり、プロダクションでの利用は "非推奨" となっています。Django コミュニティでは、この 1.5 でサポートをテストしてもらい、そのフィードバックを呼びかけています。なのでプロダクションでの利用は 1.6 まで待ちでしょうね。また Python 3 サポートと同時に、Django 1.4 では Python 2.4 がサポートから外れ、1.5 では Python 2.5 がサポートから外れます。これで 1.7 以降から django.utils 配下が軽くなっていくんでしょうかね (現在は 3 サポートのためにさらに増えてる)。 バージョン 下位互換 Python サポート 2.5 2.6 2.7 3.2 3.3 Django 1.4 > 1.2 ○ ○ ○ - - Django 1.5 > 1.3 - >= 2.6.5 ○ >= 2.7.3 △ 実験的 △ 実験的 Django 1.6 > 1.4 - >= 2.6.5 ○ >= 2.7.3 ○ ○ Python 2.5 系を利用している場合は、1.6 のリリースまで (2013 後半ぐらい?) に Python 2.6.5 以上 (2.7.3 以上を強く推奨) への移行が必要です。1.5 は今月 (2012/12) 中にリリース予定とのことなので、今のうちに Python 3 へ移行方法を抑えときたいなと。以下 Django ドキュメントの翻訳作業がてら " Porting to Python 3 " を元にご紹介。さすが
続きを読む