4.2 イメージ自動取込みコントロールのプロパティ

プロパティ 機能 V2.0追加
AcquireCount 取り込むイメージ数  
AcquiredCount 取り込んだイメージ数  
AcquireStartNo 取り込み開始番号  
AspectRatio イメージの縦と横の比率を守る  
AutoSave 取り込んだイメージを自動保存する  
ColorDepth 保存するイメージの色数  
Compression 保存するイメージの圧縮形式  
FileNameFormat 保存ファイル名の生成規則(書式)  
FillingColor 塗りつぶし色  
ImageHeight 保存するイメージの高さ  
ImageWidth 保存するイメージの幅  
InitialNumber ファイル名に使用する通し番号の初期値(開始値)  
InputSource イメージ入力元  
InterlacedImage インターレースの有無(JPEGの場合は、プログレッシブの有無)  
MediaFormat 保存するイメージファイルの形式  
MultiPage マルチページ保存の有無
PcdDataSize Photo CDデータ中のデータサイズ(解像度)  
PcdPath Photo CDのパス名  
Quality 保存するJPEGの圧縮率と品質  
Rotation イメージの回転角度  
SaveDataPath イメージの保存先ディレクトリ名  
ShowUI Photo CD内のイメージ一覧/TWAIN機器読み込みダイアログボックスの表示  
SrcHeight 入力時の取り込み高さ  
SrcLeft 入力時の取り込み位置(左上X位置)  
SrcRectUnit 入力時の取り込み範囲設定の単位  
SrcTop 入力時の取り込み位置(左上Y位置)  
SrcWidth 入力時の取り込み幅  
TwainAutoFeeder TWAIN入力時のオートフィーダ使用  
TwainPaperSize TWAIN入力時の取り込み用紙サイズ  
TwainResolution TWAIN入力時の取り込みデータの解像度  
TwainSourceName TWAINデータソース名  
XResolution 保存するイメージのX方向の解像度
YResolution 保存するイメージのY方向の解像度

AcquireCountプロパティ

[機能]

取り込みを行うイメージの数を設定します。

[書式]

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

[データ型]

長整数型

[設定値]

設定値 説明
取り込むイメージ数 デフォルトは0です。その場合は、取り込める最高枚数となります。

[用法]

設計時 設定、参照

実行時 設定、参照

[参照]

AcquiredCountプロパティAcquireStartNoプロパティAcquireImagesメソッド


AcquiredCountプロパティ

[機能]

取り込んだイメージ数を参照します。

[書式]

C/C++ long AcquiredCount;
Visual Basic [form.]object.AcquiredCount

[データ型]

長整数型

[参照値]

参照値 説明
取り込んだイメージ数 データが取り込まれていない場合は0です。

[用法]

設計時 なし

実行時 参照

[参照]

AcquireCountプロパティAcquireImagesメソッド


AcquireStartNoプロパティ

[機能]

Photo CDから取り込みを行う場合に、取り込み範囲の開始番号を設定します。

[書式]

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

[データ型]

長整数型

[設定値]

設定値 説明
開始番号 デフォルトは0です。その場合、Photo CD中のイメージの先頭からとなります。

[用法]

設計時 設定、参照

実行時 設定、参照

[備考]

本プロパティは、InputSourceプロパティがPhoto CD、かつShowUIプロパティがFalseの場合に有効です。

[参照]

AcquireCountプロパティAcquiredCountプロパティAcquireImagesメソッドInputSourceプロパティ


AspectRatioプロパティ

[機能]

イメージのサイズ変更をする場合に、縦と横の比率を守るかを設定します。

[書式]

C/C++ BOOL AspectRatio;
Visual Basic [form.]object.AspectRatio[={True|False }]

[データ型]

ブール型

[設定値]

設定値 説明
True 縦と横の比率が守られます。(デフォルト)
False 縦と横の比率が守られません。

[用法]

設計時 設定、参照

実行時 設定、参照

[備考]

ImageHeightプロパティImageWidthプロパティに値を設定している場合に有効です。

[参照]

ImageHeightプロパティImageWidthプロパティ


AutoSaveプロパティ

[機能]

取り込んだイメージをファイルへ自動保存するかを設定します。

[書式]

C/C++ BOOL AutoSave;
Visual Basic [form.]object.AutoSave[={True|False }]

[データ型]

ブール型

[設定値]

設定値 説明
True 自動保存されます。(デフォルト)
False 自動保存されません。

[用法]

設計時 設定、参照

実行時 設定、参照

[備考]

GetDIBメソッド、またはGetMemHandleメソッドを使用して、イメージを保存する場合は、AutoSaveプロパティをFalseにしてください。

[参照]

AcquireImagesメソッドGetDIBメソッドGetMemHandleメソッド


ColorDepthプロパティ

[機能]

保存するイメージの色数を設定します。

[書式]

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

[データ型]

整数型

[設定値]

設定値 説明
cwmColorDefault 0 取り込んだ色数で保存されます。(デフォルト)
cwmColorBitmap 1 2色
cwmColor16 4 16色
cwmColor256 8 256色
cwmColorGrayscale 9 256階調グレースケール
cwmColorRGB 12 1677万色

[用法]

設計時 設定、参照

実行時 設定、参照

[参照]

イメージ形式一覧表


Compressionプロパティ

[機能]

保存するイメージの圧縮形式を設定します。

[書式]

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

[データ型]

整数型

[設定値]

設定値 説明
cwmCompNone 1 非圧縮(デフォルト)
cwmCompRLE 101 RLE圧縮
cwmCompPackbits 202 PackBits圧縮
cwmCompHuffman 203 Huffman圧縮
cwmCompMH 204 MH圧縮
cwmCompMR 205 MR圧縮
cwmCompMMR 206 MMR圧縮

[用法]

設計時 設定、参照

実行時 設定、参照

[参照]

イメージ形式一覧表


FileNameFormatプロパティ

[機能]

取り込んだイメージを保存するファイル名の生成規則を設定します。

[書式]

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

[データ型]

文字列型

[設定値]

設定値 説明
書式文字列 以下のキーワードを連ねた文字列を設定します。デフォルトは空文字列です。
キーワード 意味
任意の文字列 ファイル名のサフィックス文字列などに使われます。
<year> 西暦の4ケタ
<year:2> 西暦の下2ケタ
<month> 月2ケタ
<day> 日2ケタ
<hour> 24時間表記の時間
<minute> 分2ケタ
<second> 秒2ケタ
<number:x>
number InitialNumberプロパティで設定した値を初期値とした通し番号
x 通し番号のケタ数
<ext> イメージ形式に応じた拡張子

例:"prefix<year><month><day><number:3>.<ext>"= prefix19970208001.jpg

[用法]

設計時 設定、参照

実行時 設定、参照

[備考]

[参照]

InitialNumberプロパティ


FillingColorプロパティ

[機能]

塗りつぶし色を設定します。

[書式]

C/C++ OLE_COLOR FillingColor;
Visual Basic [form.]object.FillingColor[=FillingColor&]

[データ型]

長整数型

[設定値]

設定値 説明
Red値、Green値、Blue値 RGB値を設定します。(デフォルトは、RGB(255,255,255))

[用法]

設計時 設定、参照

実行時 設定、参照

[備考]

[参照]

AspectRatioプロパティImageHeightプロパティImageWidthプロパティ


ImageHeightプロパティ

[機能]

保存するイメージの高さを設定します。

[書式]

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

[データ型]

長整数型

[設定値]

設定値 説明
保存するイメージの高さ ピクセル値で設定します。デフォルトは0です。その場合、取り込んだイメージの高さとなります。

[用法]

設計時 設定、参照

実行時 設定、参照

[参照]

ImageWidthプロパティ


ImageWidthプロパティ

[機能]

保存するイメージの幅を設定します。

[書式]

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

[データ型]

長整数型

[設定値]

設定値 説明
保存するイメージの幅 ピクセル値で設定します。デフォルトは0です。その場合、取り込んだイメージの幅となります。

[用法]

設計時 設定、参照

実行時 設定、参照

[参照]

ImageHeightプロパティ


InitialNumberプロパティ

[機能]

ファイル名に使用する通し番号の初期値(開始値)を設定します。

[書式]

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

[データ型]

長整数型

[設定値]

設定値 説明
通し番号の初期値 デフォルトは1です。

[用法]

設計時 設定、参照

実行時 設定、参照

[参照]

FileNameFormatプロパティ


InputSourceプロパティ

[機能]

イメージの入力元を設定します。

[書式]

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

[データ型]

整数型

[設定値]

設定値 説明
cwmSrcTWAIN 2 TWAIN対応機器(イメージスキャナ、デジタルカメラ等)(デフォルト)
cwmSrcPhotoCD 3 Photo CD

[用法]

設計時 設定、参照

実行時 設定、参照

[参照]

AcquireImagesメソッド


InterlacedImageプロパティ

[機能]

イメージをインターレースイメージ、またはプログレッシブJPEGとするかを設定します。

[書式]

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

[データ型]

整数型

[設定値]

設定値 説明
cwmInterlaceNone 1 インターレースイメージ、またはプログレッシブJPEGとなりません。(デフォルト)
cwmInterlaced 2 インターレースイメージ、またはプログレッシブJPEGとなります。

[用法]

設計時 設定、参照

実行時 設定、参照

[備考]

保存するイメージの形式(MediaFormatプロパティ)がPNGおよびJPEGの場合に有効です。

[参照]

MediaFormatプロパティイメージ形式一覧表


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

[用法]

設計時 設定、参照

実行時 設定、参照

[参照]

イメージ形式一覧表


MultiPageプロパティ

[機能]

マルチページイメージで保存するかを設定します。

[書式]

C/C++ BOOL MultiPage;
Visual Basic [form.]object.MultiPage[={ True|False }]

[データ型]

ブール型

[設定値]

設定値 説明
True マルチページイメージで保存されます。
False マルチページイメージで保存されません。(デフォルト)

[用法]

設計時 設定、参照

実行時 設定、参照

[備考]

[参照]

AutoSaveプロパティMediaFormatプロパティGetDIBメソッドGetMemHandleメソッドイメージ形式一覧表


PcdDataSizeプロパティ

[機能]

Photo CDから取り込む時の解像度(データサイズ)を設定します。

[書式]

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

[データ型]

整数型

[設定値]

設定値 説明
cwmPcdResBaseOver64 1 1/64倍(64 x 96)
cwmPcdResBaseOver16 2 1/16倍(128 x 192)
cwmPcdResBaseOver4 3 1/4倍(256 x 384)
cwmPcdResBase 4 標準(512 x 768)(デフォルト)
cwmPcdRes4Base 5 4倍(1024 x 1536)
cwmPcdRes16Base 6 16倍(2048 x 3072)
cwmPcdRes64Base 7 64倍(4096 x 6144)

[用法]

設計時 設定、参照

実行時 設定、参照

[備考]

InputSourceプロパティがPhoto CDの場合に有効となります。

[参照]

InputSourceプロパティ


PcdPathプロパティ

[機能]

Photo CDをセットしたドライブ名、またはパス(ディレクトリ)名を設定します。

[書式]

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

[データ型]

文字列型

[設定値]

設定値 説明
パス名文字列 デフォルトは空文字列です。その場合、 最初に見つかるCD-ROMドライブが使用されます。

[用法]

設計時 設定、参照

実行時 設定、参照

[備考]

InputSourceプロパティがPhoto CDの場合に有効となります。

[参照]

InputSourceプロパティ


Qualityプロパティ

[機能]

保存するイメージの圧縮率と品質を設定します。

[書式]

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

[データ型]

整数型

[設定値]

設定値 説明
圧縮率と品質 1〜10の間で指定します。数字が大きいほど圧縮率が下がり、品質が上がります。デフォルトは2です。

[用法]

設計時 設定、参照

実行時 設定、参照

[備考]

保存するイメージの形式(MediaFormatプロパティ)がJPEGの場合に有効です。

[参照]

MediaFormatプロパティイメージ形式一覧表


Rotationプロパティ

[機能]

取り込んだイメージを回転させる場合の角度を設定します。

[書式]

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

[データ型]

整数型

[設定値]

設定値 説明
cwmRotate0 0 回転しない(デフォルト)
cwmRotate90 1 90度回転
cwmRotate180 2 180度回転
cwmRotate270 3 270度回転

[用法]

設計時 設定、参照

実行時 設定、参照

[備考]

イメージは反時計回りに回転されます。


SaveDataPathプロパティ

[機能]

取り込んだイメージの保存先のパスを設定します。

[書式]

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

[データ型]

文字列型

[設定値]

設定値 説明
パス名文字列 デフォルトは空文字列です。その場合、カレントディレクトリとなります。UNCパスも設定できます。

[用法]

設計時 設定、参照

実行時 設定、参照

[参照]

FileNameFormatプロパティ


ShowUIプロパティ

[機能]

イメージの入力時に、Photo CD内のイメージ一覧/TWAIN機器読み込みダイアログボックスを表示するかを設定します。

[書式]

C/C++ BOOL ShowUI;
Visual Basic [form.]object.ShowUI[={ True|False }]

[データ型]

ブール型

[設定値]

設定値 説明
True 表示します。
False 表示しません。(デフォルト)

[用法]

設計時 設定、参照

実行時 設定、参照

[備考]

利用者にダイアログボックス上で、読み込むイメージの選択や、入力時の細かな設定を行わせる場合に、ShowUIプロパティをTrueに設定してください。

[参照]

InputSourceプロパティ


SrcHeightプロパティ

[機能]

取り込み矩形の高さを設定します。

[書式]

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

[データ型]

単精度浮動小数点型

[設定値]

設定値 説明
取り込み矩形の高さ デフォルトは0です。その場合、使用するTWAIN機器の最大取り込み値となります。

[用法]

設計時 設定、参照

実行時 設定、参照

[備考]

[参照]

SrcLeftプロパティSrcRectUnitプロパティSrcTopプロパティSrcWidthプロパティShowUIプロパティInputSourceプロパティTwainPaperSizeプロパティ


SrcLeftプロパティ

[機能]

取り込み矩形の左上のX座標を設定します。

[書式]

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

[データ型]

単精度浮動小数点型

[設定値]

設定値 説明
取り込み矩形の左上のX座標 デフォルトは0です。

[用法]

設計時 設定、参照

実行時 設定、参照

[備考]

[参照]

SrcHeightプロパティSrcRectUnitプロパティSrcTopプロパティSrcWidthプロパティShowUIプロパティInputSourceプロパティTwainPaperSizeプロパティ


SrcRectUnitプロパティ

[機能]

取り込み矩形の単位を設定します。

[書式]

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

[データ型]

整数型

[設定値]

設定値 説明
cwmUnitPixel 1 ピクセル
cwmUintInch 2 インチ
cwmUnitCentimeter 3 センチメートル(デフォルト)

[用法]

設計時 設定、参照

実行時 設定、参照

[備考]

ShowUIプロパティがFalse、かつInputSourceプロパティがTWAIN対応機器の場合に有効です。

[参照]

SrcHeightプロパティSrcLeftプロパティSrcTopプロパティSrcWidthプロパティShowUIプロパティInputSourceプロパティ


SrcTopプロパティ

[機能]

取り込み矩形の左上のY座標を設定します。

[書式]

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

[データ型]

単精度浮動小数点型

[設定値]

設定値 説明
取り込み矩形の左上のY座標 デフォルトは0です。

[用法]

設計時 設定、参照

実行時 設定、参照

[備考]

[参照]

SrcHeightプロパティSrcLeftプロパティSrcRectUnitプロパティSrcWidthプロパティShowUIプロパティInputSourceプロパティTwainPaperSizeプロパティ


SrcWidthプロパティ

[機能]

取り込み矩形の幅を設定します。

[書式]

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

[データ型]

単精度浮動小数点型

[設定値]

設定値 説明
取り込み矩形の幅 デフォルトは0です。その場合、使用するTWAIN機器の最大取り込み値となります。

[用法]

設計時 設定、参照

実行時 設定、参照

[備考]

[参照]

SrcHeightプロパティSrcLeftプロパティSrcRectUnitプロパティSrcTopプロパティShowUIプロパティInputSourceプロパティTwainPaperSizeプロパティ


TwainAutoFeederプロパティ

[機能]

TWAIN機器から入力する場合に、オートフィーダーを使用するかを設定します。

[書式]

C/C++ BOOL TwainAutoFeeder;
Visual Basic [form.]object.TwainAutoFeeder[={True|False}]

[データ型]

ブール型

[設定値]

設定値 説明
True オートフィーダーが使用されます。
False オートフィーダーが使用されません。(デフォルト)

[用法]

設計時 設定、参照

実行時 設定、参照

[備考]

ShowUIプロパティがFalseの場合に有効です。

[参照]

InputSourceプロパティShowUIプロパティ


TwainPaperSizeプロパティ

[機能]

TWAIN機器から入力する場合に、読み込む用紙サイズを設定します。

[書式]

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

[データ型]

整数型

[設定値]

設定値 説明
cwmSizeDefault 0 TWAIN機器の設定値(デフォルト)
cwmSizeMaximum 1 最大
cwmSizeUserDefined 2 ユーザ定義
cwmSizePortA3 3 A3(縦)
cwmSizePortA4 4 A4(縦)
cwmSizePortA5 5 A5(縦)
cwmSizePortB4 6 B4(縦)
cwmSizePortB5 7 B5(縦)
cwmSizeLandA3 8 A3(横)
cwmSizeLandA4 9 A4(横)
cwmSizeLandA5 10 A5(横)
cwmSizeLandB4 11 B4(横)
cwmSizeLandB5 12 B5(横)
cwmSizeLetter 13 Letter
cwmSizeLegal 14 Legal
cwmSizePortPostcard 15 ハガキ(縦)
cwmSizeLandPostcard 16 ハガキ(横)

[用法]

設計時 設定、参照

実行時 設定、参照

[備考]

[参照]

ShowUIプロパティSrcHeightプロパティSrcLeftプロパティSrcRectUnitプロパティSrcTopプロパティSrcWidthプロパティInputSourceプロパティ


TwainResolutionプロパティ

[機能]

TWAIN機器から入力する場合に、読み込むイメージの解像度(1インチあたりのピクセル数)を設定します。

[書式]

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

[データ型]

整数型

[設定値]

設定値 説明
解像度(DPI) 0以上の値を設定します。デフォルトは0です。その場合は、TWAIN機器の設定値となります。

[用法]

設計時 設定、参照

実行時 設定、参照

[備考]

ShowUIプロパティがFalseの場合に有効です。

[参照]

InputSourceプロパティShowUIプロパティ


TwainSourceNameプロパティ

[機能]

TWAIN機器から入力する場合に、使用するTWAINデータソース名を設定します。

[書式]

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

[データ型]

文字列型

[設定値]

設定値 説明
データソース名文字列 デフォルトは空文字列です。その場合、システムデフォルトのデータソースが使用されます。

[用法]

設計時 設定、参照

実行時 設定、参照

[備考]

SelectTwainSourceメソッドを実行しデータソースを選択すると、本プロパティに選択したデータソース名が設定されます。

[参照]

SelectTwainSourceメソッド


XResolutionプロパティ

[機能]

保存するイメージのX方向の解像度を設定します。

[書式]

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

[データ型]

整数型

[設定値]

設定値 説明
解像度(DPI) X方向の1インチあたりのピクセル数を指定します。デフォルトは0です。

[用法]

設計時 設定、参照

実行時 設定、参照

[備考]

[参照]

MediaFormatプロパティYResolutionプロパティイメージ形式一覧表


YResolutionプロパティ

[機能]

保存するイメージのY方向の解像度を設定します。

[書式]

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

[データ型]

整数型

[設定値]

設定値 説明
解像度(DPI) Y方向の1インチあたりのピクセル数を指定します。デフォルトは0です。

[用法]

設計時 設定、参照

実行時 設定、参照

[備考]

[参照]

MediaFormatプロパティXResolutionプロパティイメージ形式一覧表