【機能】
|
イメージをファイルに保存します。 |
【書式】
|
[form.]object.Save(String FileName,
Integer SizeUnit, Integer Width,
Integer Height) |
|
【パラメータ】
|
パラメータ |
説明 |
FileName |
イメージを保存するファイル名を指定します。
UNCパスによる指定も可能です。 |
SizeUnit |
イメージサイズの単位を指定します。
cwmgSizeUnitPixel : 0 :
ピクセル単位
cwmgSizeUnitMM : 1 :
ミリメートル単位 |
Width |
イメージの幅を指定します。
0以上の値を指定します。 |
Height |
イメージの高さを指定します。
0以上の値を指定します。 |
|
|
【復帰値】
|
復帰値は、Long型です。
設定値 |
値 |
意味 |
対処 |
cwmgSaveSuccess |
0 |
正常に保存しました。 |
− |
cwmgSaveParameter |
1 |
パラメータが不当です。 |
パラメータおよびプロパティの値を確認してください。 |
cwmgSaveFileAccess |
2 |
ファイルアクセスエラーが発生しました。 |
FileNameパラメータに不当なパスが指定されていないか、または、指定されたファイル名が書き込み禁止になっていないか確認してください。 |
cwmgSaveError |
3 |
|
システムを再起動し、アプリケーションを再実行してください。 |
|
|
【備考】
|
- Width, Heightともに数値を指定した場合、指定されたサイズでイメージを作成します。
- Width、Heightのいずれかに0が指定された場合、コントロールサイズの相似形でイメージを作成します。
- Width、Heightともに0の場合、コントロールサイズでイメージを作成します。
- 画像形式(SaveMediaFormat)と設定可能な色数(SaveColorDepth)の関係を以下に示します。
画像形式(SaveMediaFormat) |
設定可能な色数(SaveColorDepth) |
cwmgFileBMP (非圧縮) |
設定値での全ての値が指定できます。 |
cwmgFileBMP (RLE形式) |
cwmgSaveColor016、cwmgSaveColor256のいずれかが指定できます。 |
cwmgFileJPEG |
cwmgSaveColor256、cwmgSaveColorFullColorのいずれかが指定できます。 |
|
|