5.2 イメージ印刷コントロールのプロパティ

プロパティ 機能
DocTitle 印刷ドキュメントのタイトル
FileName 印刷するイメージファイル名
FooterText フッターの文字列
FromPage 印刷を開始するページ番号
HeaderFont ヘッダー、フッターで使用するフォント
HeaderText ヘッダーの文字列
MarginBottom 下マージン
MarginLeft 左マージン
MarginRight 右マ−ジン
MarginTop 上マージン
MediaFormat イメージデータの形式
PaperOrientation 印刷する用紙方向
PaperSize 印刷する用紙サイズ
PrintDC プリンタのデバイスコンテキスト
PrintMode 印刷モード
ToPage 印刷を終了するページ番号
TotalPage マルチページイメージの総ページ数

DocTitleプロパティ

[機能]

印刷するドキュメントのタイトルを設定します。

[書式]

C/C++ BSTR DocTitle;
Visual Basic [form.]object.DocTitle[=DocTitle$]

[データ型]

文字列型

[設定値]

設定値 説明
ドキュメントタイトル文字列 印刷するドキュメントのタイトルを設定します。デフォルトは空文字列です。

[用法]

設計時 設定、参照

実行時 設定、参照

[備考]

[参照]

FileNameプロパティFooterTextプロパティHeaderTextプロパティ


FileNameプロパティ

[機能]

印刷するイメージのファイル名を設定します。

[書式]

C/C++ BSTR FileName;
Visual Basic [form.]object.FileName[=FileName$]

[データ型]

文字列型

[設定値]

設定値 説明
イメージのファイル名文字列 通常のファイル名のほかに、UNCファイル名、URL名が設定できます。デフォルトは空文字列です。

[用法]

設計時 設定、参照

実行時 設定、参照

[参照]

DocTitleプロパティSetDIBメソッドSetMemHandleメソッドStartPrintメソッド


FooterTextプロパティ

[機能]

印刷するフッター文字列を設定します。

[書式]

C/C++ BSTR FooterText;
Visual Basic [form.]object.FooterText[=FooterText$]

[データ型]

文字列型

[設定値]

設定値 説明
書式制御文字列 フッター文字列を設定します。以下の書式制御文字列を合わせて設定することができます。
デフォルトは"<tab><tab><day> <time>"です。
キーワード 意味
任意文字列 任意の文字列
<doctitle> ドキュメントタイトル
<page> 現在のページ番号
<totalpage> 総ページ数
<day> 現在の日付
<time> 現在の時間
<br> 強制改行
<tab> 配置間隔(左寄せ<tab>中央<tab>右寄せ)

[用法]

設計時 設定、参照

実行時 設定、参照

[備考]

"Fujitsu<tab><tab><day>"の場合は以下のように印刷されます。

[参照]

DocTitleプロパティHeaderFontプロパティHeaderTextプロパティ


FromPageプロパティ

[機能]

印刷を開始するページ番号を設定します。

[書式]

C/C++ short FromPage;
Visual Basic [form.]object.FromPage[=FromPage%]

[データ型]

整数型

[設定値]

設定値 説明
ページ番号 印刷を開始するページ番号を設定します。指定できる値は1以上の値で、デフォルトは1となります。

[用法]

設計時 なし

実行時 設定、参照

[備考]

[参照]

ToPageプロパティStartPrintメソッド


HeaderFontプロパティ

[機能]

ヘッダー/フッターで使用するフォントを設定します。

[書式]

C/C++ LPDISPATCH HeaderFont;
Visual Basic [form.]object.HeaderFont[=HeaderFont

[データ型]

フォントオブジェクト型

[設定値]

設定値 説明
フォントオブジェクト ヘッダー、フッターで使用するフォントを設定します。デフォルトは”MS Pゴシック”の9ポイントです。
設定方法は以下のようになります。
例) ImagePrint1.HeaderFont.Name = "MS 明朝"
プロパティ 設定値および意味
Bold True指定により太字
Italic True指定により斜体
Name フォント名
Size フォントサイズ(ポイント単位)
StrikeThrough True指定により取り消し線を引く
Underline True指定により下線を引く
Weight 文字の太さ(400〜700)

[用法]

設計時 設定、参照

実行時 設定、参照

[備考]

フォントオブジェクトのプロパティで設定できる値の詳細については、フォントオブジェクトを参照して下さい。

[参照]

FooterTextプロパティHeaderTextプロパティ


HeaderTextプロパティ

[機能]

印刷するヘッダー文字列を設定します。

[書式]

C/C++ BSTR HeaderText;
Visual Basic [form.]object.HeaderText[=HeaderText$]

[データ型]

文字列型

[設定値]

設定値 説明
書式制御文字列 ヘッダー文字列を設定します。以下の書式制御文字列を合わせて設定することができます。デフォルトは"<doctitle><tab><tab><page>/<totalpage>ページ"です。
キーワード 意味
任意文字列 任意の文字列
<doctitle> ドキュメントタイトル
<page> 現在のページ番号
<totalpage> 総ページ数
<day> 現在の日付
<time> 現在の時間
<br> 強制改行
<tab> 配置間隔(左寄せ<tab>中央<tab>右寄せ)

[用法]

設計時 設定、参照

実行時 設定、参照

[備考]

"<doctitle><tab>社外秘<tab><page>/<totalpage>ページ"の場合は以下のように印刷されます。

[参照]

DocTitleプロパティFooterTextプロパティHeaderFontプロパティ


MarginBottomプロパティ

[機能]

用紙の下端からのマージン(余白)を設定します。

[書式]

C/C++ float MarginBottom;
Visual Basic [form.]object.MarginBottom[=MarginBottom!]

[データ型]

単精度浮動小数点型

[設定値]

設定値 説明
下マージン 用紙の下端からのマージンをミリ単位で設定します。指定できる値は0以上の値で、デフォルトは15.0mmです。

[用法]

設計時 設定、参照

実行時 設定、参照

[備考]

[参照]

MarginLeftプロパティMarginRightプロパティMarginTopプロパティSetupPageメソッド


MarginLeftプロパティ

[機能]

用紙の左端からのマージン(余白)を設定します。

[書式]

C/C++ float MarginLeft;
Visual Basic [form.]object.MarginLeft[=MarginLeft!]

[データ型]

単精度浮動小数点型

[設定値]

設定値 説明
左マージン 用紙の左端からのマージンをミリ単位で設定します。指定できる値は0以上の値で、デフォルトは15.0mmです。

[用法]

設計時 設定、参照

実行時 設定、参照

[備考]

[参照]

MarginBottomプロパティMarginRightプロパティMarginTopプロパティSetupPageメソッド


MarginRightプロパティ

[機能]

用紙の右端からのマージン(余白)を設定します。

[書式]

C/C++ float MarginRight;
Visual Basic [form.]object.MarginRight[=MarginRight!]

[データ型]

単精度浮動小数点型

[設定値]

設定値 説明
右マージン 用紙の右端からのマージンをミリ単位で設定します。指定できる値は0以上の値で、デフォルトは15.0mmです。

[用法]

設計時 設定、参照

実行時 設定、参照

[備考]

[参照]

MarginBottomプロパティMarginLeftプロパティMarginTopプロパティSetupPageメソッド


MarginTopプロパティ

[機能]

用紙の上端からのマージン(余白)を設定します。

[書式]

C/C++ float MarginTop;
Visual Basic [form.]object.MarginTop[=MarginTop!]

[データ型]

単精度浮動小数点型

[設定値]

設定値 説明
上マージン 用紙の上端からのマージンをミリ単位で設定します。指定できる値は0以上の値で、デフォルトは15.0mmです。

[用法]

設計時 設定、参照

実行時 設定、参照

[備考]

[参照]

MarginBottomプロパティMarginLeftプロパティMarginRightプロパティSetupPageメソッド


MediaFormatプロパティ

[機能]

イメージの形式を参照します。

[書式]

C/C++ short MediaFormat;
Visual Basic [form.]object.MediaFormat[=MediaFormat%]

[データ型]

整数型

[参照値]

参照値 説明
cwmFileBMP 101 BMP
cwmFileTIFF 102 TIFF
cwmFileJPEG 103 JPEG
cwmFilePCX 104 PCX
cwmFilePNG 106 PNG
cwmUnknown -1 不明(デフォルト)

[用法]

設計時 なし

実行時 参照

[備考]

SetDIBメソッドにより、イメージを設定した場合は、cwmUnknown(-1)となります。

[参照]

SetDIBメソッドイメージ形式一覧表


PaperOrientationプロパティ

[機能]

印刷する用紙方向を設定します。

[書式]

C/C++ short PaperOrientation;
Visual Basic [form.]object.PaperOrientation[=PaperOrientation%]

[データ型]

整数型

[設定値]

設定値 説明
cwmPODefault 0 プリンタの設定値(デフォルト)
cwmPOPortrait 1 ポートレート(用紙の短い辺を上)
cwmPOLandscape 2 ランドスケープ(用紙の長い辺を上)

[用法]

設計時 設定、参照

実行時 設定、参照

[備考]

本プロパティの値は、[印刷]ダイアログボックスおよび[ページ設定]ダイアログボックスを表示するときの初期値となります。また、[印刷]ダイアログボックスおよび[ページ設定]ダイアログボックスで値を変更した場合は、本プロパティに反映されます。

[参照]

PaperSizeプロパティSetupPageメソッド


PaperSizeプロパティ

[機能]

印刷する用紙サイズを設定します。

[書式]

C/C++ short PaperSize;
Visual Basic [form.]object.PaperSize[=PaperSize%]

[データ型]

整数型

[設定値]

設定値 説明
cwmPSDefault 0 プリンタの設定値(デフォルト)
cwmPSLetter 1 Letter
cwmPSLetterSmall 2 Letter Small
cwmPSTabloid 3 Tabloid
cwmPSLedger 4 Ledger
cwmPSLegal 5 Legal
cwmPSStatement 6 Statement
cwmPSExecutive 7 Executive
cwmPSA3 8 A3
cwmPSA4 9 A4
cwmPSA4Small 10 A4 Small
cwmPSA5 11 A5
cwmPSB4 12 B4
cwmPSB5 13 B5
cwmPSFolio 14 Folio
cwmPSQuarto 15 Quarto
cwmPS10X14 16 10×14 インチ
cwmPS11X17 17 11×17 インチ
cwmPSNote 18 Note
cwmPSEnv9 19 封筒 #9 
cwmPSEnv10 20 封筒 #10
cwmPSEnv11 21 封筒 #11
cwmPSEnv12 22 封筒 #12
cwmPSEnv14 23 封筒 #14
cwmPSCSheet 24 C サイズシート
cwmPSDSheet 25 D サイズシート
cwmPSESheet 26 E サイズシート
cwmPSEnvDL 27 封筒 DL
cwmPSEnvC5 28 封筒 C5
cwmPSEnvC3 29 封筒 C3
cwmPSEnvC4 30 封筒 C4
cwmPSEnvC6 31 封筒 C6
cwmPSEnvC65 32 封筒 C65
cwmPSEnvB4 33 封筒 B4
cwmPSEnvB5 34 封筒 B5
cwmPSEnvB6 35 封筒 B6
cwmPSEnvItaly 36 封筒 Italy
cwmPSEnvMonarch 37 封筒 Monarch
cwmPSEnvPersonal 38 封筒 Personal
cwmPSFanFoldUS 39 US Std Fanfold
cwmPSFanFoldStdGM 40 ドイツ Std Fanfold
cwmPSFanFoldLegalGM 41 ドイツ Legal Fanfold
cwmPSISOB4 42 B4 (ISO)
cwmPSJapanesePostcard 43 日本ハガキ
cwmPS9X11 44 9×11 インチ
cwmPS10X11 45 10×11 インチ
cwmPS15X11 46 15×11 インチ

[用法]

設計時 設定、参照

実行時 設定、参照

[備考]

本プロパティの値は、[印刷]ダイアログボックスおよび[ページ設定]ダイアログボックスを表示するときの初期値となります。また、[印刷]ダイアログボックスおよび[ページ設定]ダイアログボックスで値を変更した場合は、本プロパティに反映されます。

[参照]

PaperOrientationプロパティSetupPageメソッド


PrintDCプロパティ

[機能]

印刷するプリンタのデバイスコンテキストのハンドルを設定します。

[書式]

C/C++ long PrintDC;
Visual Basic [form.]object.PrintDC[=PrintDC&]

[データ型]

長整数型

[設定値]

設定値 説明
プリンタデバイスコンテキスト プリンタのデバイスコンテキストのハンドルを設定します。デフォルトは0です。

[用法]

設計時 なし

実行時 設定、参照

[備考]

[参照]

PaperOrientationプロパティPaperSizeプロパティStartPrintメソッド


PrintModeプロパティ

[機能]

印刷モードを設定します。

[書式]

C/C++ short PrintMode;
Visual Basic [form.]object.PrintMode[=PrintMode%]

[データ型]

整数型

[設定値]

設定値 説明
cwmPMPaperFitSize 1 印刷する用紙サイズに合わせて、イメージを拡大または縮小して印刷されます。(デフォルト)
なお、イメージの縦横比率は守られます。
cwmPMViewSize 2 ディスプレイに表示されているサイズとほぼ同じサイズで用紙に印刷されます。
なお、用紙をはみ出す部分は印刷されません。
cwmPMActualSize 3 イメージデータに設定されている解像度の情報をもとに原寸サイズで印刷されます。イメージデータに解像度が設定されていない場合は、200DPIで印刷されます。
なお、用紙をはみ出す部分は印刷されません。

[用法]

設計時 設定、参照

実行時 設定、参照

[備考]

[参照]

PaperSizeプロパティSetupPageメソッド


ToPageプロパティ

[機能]

印刷を終了するページ番号を設定します。

[書式]

C/C++ short ToPage;
Visual Basic [form.]object.ToPage[=ToPage%]

[データ型]

整数型

[設定値]

設定値 説明
ページ番号 印刷を終了するページ番号を設定します。指定できる値は1以上の値で、デフォルトはTotalPageプロパティの値となります。

[用法]

設計時 なし

実行時 設定、参照

[備考]

[参照]

FromPageプロパティTotalPageプロパティStartPrintメソッド


TotalPageプロパティ

[機能]

マルチページイメージの総ページ数を参照します。

[書式]

C/C++ short TotalPage;
Visual Basic [form.]object.TotalPage[=TotalPage%]

[データ型]

整数型

[参照値]

参照値 説明
総ページ数 マルチページイメージの総ページ数を参照します。イメージデータを設定していない場合は0となります。またマルチページイメージでない場合は1となります。

[用法]

設計時 なし

実行時 参照

[参照]

ToPageプロパティ