3.3 イメージ編集コントロールのメソッド

メソッド 機能 V2.0追加
AboutBox バージョン情報を表示します。  
AddPage マルチページイメージへページを追加します。
AdjustBrightness イメージの明るさ・コントラストを調整します。  
AdjustColorBalance イメージの色階調を調整します。  
AdjustGamma イメージの輝度レベルを調整します。  
AdjustHue イメージの色相・彩度・明度を調整します。  
Blend 2つのイメージを合成します。  
Blur イメージをぼかします。  
Calculate 2つのイメージ間で演算を行います。  
ChangeColorDepth イメージの色数を変更します。  
ClearRubberBand 矩形選択枠をクリアします。  
ClipRect イメージの矩形切り取りを行います。  
CopyToClipboard クリップボードにイメージをコピーします。
CreateFromClipboard クリップボードのデータから新規イメージを作成します。
Delete 編集中のイメージを削除します。  
DeletePage マルチページイメージからページを削除します。
DistortPinch イメージをつまんだように変形させます。  
DistortSkew イメージを傾けます。  
DistortSphere イメージを球面状に変形させます。  
Emboss イメージを浮き彫りにします。  
EnhanceEdges イメージの輪郭を強調します。  
Equalize イメージの明るさを均等化します。  
FillRect イメージの矩形塗りつぶしを行います。  
FindEdges イメージの輪郭を抽出します。  
Flip イメージの向きを反転します。  
GetDIB DIBを取得します。
GetErrorCode メソッドのエラーを通知します。  
GetMemHandle イメージを格納したメモリを取得します。  
GetPageCount マルチページイメージの総ページ数を取得します。
InsertPage マルチページイメージへページを挿入します。
Invert イメージの色を反転します。  
Load イメージを読み込みます。  
Median イメージのノイズを除去します。  
PasteFromClipboard クリップボードからデータを貼り付けます。
Refresh イメージの再描画を行います。  
ReplacePage マルチページイメージのページを置き換えます。
Reset 編集中のイメージをLoadメソッド実行後の状態に戻します。  
Resize イメージのサイズを変更します。  
Rotate イメージを回転します。(90°単位)  
RotateArbitrary イメージを回転します。(1°単位)  
Save イメージを保存します。  
SelectTwainSource TWAINデータソース選択ダイアログボックスを表示します。  
SetDIB DIBを設定します。
SetMemHandle イメージを格納したメモリを設定します。  
SetRubberBand 矩形選択枠を設定します。  
Sharpen イメージをくっきりさせます。  
Solarize イメージの明るさの中間値を境に、濃淡変化を逆転します。  
Undo 編集中のイメージを1つ前の編集状態に戻します。  

AboutBoxメソッド

[機能]

コントロールのバージョン情報を表示します。

[書式]

C/C++ void AboutBox();
Visual Basic [form.]object.AboutBox

[パラメータ]

なし

[復帰値]

なし


AddPageメソッド

[機能]

マルチページイメージの最終ページへ、現在編集中のイメージを追加します。

[書式]

C/C++ BOOL AddPage(BSTR FileName);
Visual Basic [form.]object.AddPage(FileName$)

[パラメータ]

パラメータ 説明
FileName 文字列型 マルチページイメージのファイル名を設定します。UNCファイル名も設定可能です。

[復帰値]

ブール型
True 正常
False 異常

[備考]

[参照]

SaveMediaFormatプロパティDeletePageメソッドInsertPageメソッドReplacePageメソッド


AdjustBrightnessメソッド

[機能]

イメージの明るさ・コントラストを調整します。

[書式]

C/C++ BOOL AdjustBrightness(short Brightness, short Contrast);
Visual Basic [form.]object.AdjustBrightness(Brightness%,Contrast%)

[パラメータ]

パラメータ 説明
Brightness 整数型 明るさの割合を-100〜100の範囲で設定します。0の場合は変更されません。
Contrast 整数型 コントラストの割合を-100〜100の範囲で設定します。0の場合は変更されません。

[復帰値]

ブール型
True 正常
False 異常

[備考]

イメージの色数が、16色、256色、256階調グレースケール、1677万色の場合に有効です。

[参照]

ColorDepthプロパティ


AdjustColorBalanceメソッド

[機能]

イメージの色の階調を調整します。

[書式]

C/C++ BOOL AdjustColorBalance(short Red, short Green, short Blue);
Visual Basic [form.]object.AdjustColorBalance(Red%,Green%,Blue%)

[パラメータ]

パラメータ 説明
Red 整数型 赤の階調値を-100〜100の範囲で設定します。0の場合は変更されません。
Green 整数型 緑の階調値を-100〜100の範囲で設定します。0の場合は変更されません。
Blue 整数型 青の階調値を-100〜100の範囲で設定します。0の場合は変更されません。

[復帰値]

ブール型
True 正常
False 異常

[備考]

イメージの色数が、16色、256色、1677万色の場合に有効です。

[参照]

ColorDepthプロパティ


AdjustGammaメソッド

[機能]

イメージの輝度レベルを調整(ガンマ補正)します。

[書式]

C/C++ BOOL AdjustGamma(short Gamma);
Visual Basic [form.]object.AdjustGamma(Gamma%)

[パラメータ]

パラメータ 説明
Gamma 整数型 補正値を1〜1000の範囲で設定します。100は1.0として扱われます。

[復帰値]

ブール型
True 正常
False 異常

[備考]

イメージの色数が、16色、256色、256階調グレースケール、1677万色の場合に有効です。

[参照]

ColorDepthプロパティ


AdjustHueメソッド

[機能]

イメージの色相・彩度・明度を調整します。

[書式]

C/C++ BOOL AdjustHue(short Hue, short Saturation, short Lightness);
Visual Basic [form.]object.AdjustHue(Hue%,Saturation%,Lightness%)

[パラメータ]

パラメータ 説明
Hue 整数型 色相値を-180〜180の範囲で設定します。0の場合は変更されません。
Saturation 整数型 彩度値を-100〜100の範囲で設定します。0の場合は変更されません。
Lightness 整数型 明度値を-100〜100の範囲で設定します。0の場合は変更されません。

[復帰値]

ブール型
True 正常
False 異常

[備考]

[参照]

ColorDepthプロパティ


Blendメソッド

[機能]

2つのイメージを合成します。

[書式]

C/C++ BOOL Blend(short Ratio, long DstLeft, long DstTop, long DstWidth, long DstHeight,BSTR SrcFileName, long SrcLeft, long SrcTop);
Visual Basic [form.]object.Blend(Ratio%,DstLeft&,DstTop&,DstWidth&,DstHeight&,SrcFileName$,SrcLeft&,SrcTop&)

[パラメータ]

パラメータ 説明
Ratio 整数型 編集中イメージの合成比率(%)を0〜100の範囲で設定します。100を設定すると合成は行われません。
DstLeft 長整数型 編集中イメージの処理対象域の左上位置(X方向)をイメージ左上からの位置で設定します。(単位はピクセル)
DstTop 長整数型 編集中イメージの処理対象域の左上位置(Y方向)をイメージ左上からの位置で設定します。(単位はピクセル)
DstWidth 長整数型 編集中イメージの処理対象域の幅を設定します。0を設定した場合、イメージの幅全体が処理対象域となります。合成元イメージの処理対象域も同じ幅となります。(単位はピクセル)
DstHeight 長整数型 編集中イメージの処理対象域の高さを設定します。0を設定した場合、イメージの高さ全体が処理対象域となります。合成元イメージの処理対象域も同じ幅となります。(単位はピクセル)
SrcFileName 文字列型 演算対象となる第2のイメージのファイル名を設定します。UNCファイル名やURL名も設定できます。
SrcLeft 長整数型 合成するイメージの左上位置(X方向)をイメージ左上からの位置で設定します。(単位はピクセル)
SrcTop 長整数型 合成するイメージの左上位置(Y方向)をイメージ左上からの位置で設定します。(単位はピクセル)

[復帰値]

ブール型
True 正常
False 異常

[備考]

[参照]

ColorDepthプロパティCalculateメソッド


Blurメソッド

[機能]

イメージをぼかします。

[書式]

C/C++ BOOL Blur();
Visual Basic [form.]object.Blur

[パラメータ]

なし

[復帰値]

ブール型
True 正常
False 異常

[備考]

イメージの色数が、256階調グレースケール、1677万色の場合に有効です。

[参照]

ColorDepthプロパティ


Calculateメソッド

[機能]

2つのイメージ間で演算を行います。

[書式]

C/C++ BOOL Calculate(short CalcOption, long DstLeft, long DstTop, long DstWidth, long DstHeight, BSTR SrcFileName,long SrcLeft, long SrcTop);
Visual Basic [form.]object.Calculate(CalcOption%,DstLeft&,DstTop&,DstWidth&,DstHeight&,SrsFileName$,SrcLeft&,SrcTop&)

[パラメータ]

パラメータ 説明
CalcOption 整数型 設定値 意味
cwmCalcAdd 1 加算
cwmCalcSubtract 2 減算
cwmCalcMultiply 3 乗算
cwmCalcDivide 4 除算
cwmCalcOr 5 論理和
cwmCalcAnd 6 論理積
cwmCalcNor 7 否定論理和
cwmCalcNand 8 否定論理積
cwmCalcXor 9 排他的論理和
cwmCalcDarker 10 比較(暗)
cwmCalcLighter 11 比較(明)
cwmCalcDifference 12 差の絶対値
DstLeft 長整数型 編集中イメージの処理対象域の左上位置(X方向)をイメージ左上からの位置で設定します。(単位はピクセル)
DstTop 長整数型 編集中イメージの処理対象域の左上位置(Y方向)をイメージ左上からの位置で設定します。(単位はピクセル)
DstWidth 長整数型 編集中イメージの処理対象域の幅を設定します。0を設定した場合、イメージの幅全体が処理対象域となります。合成元イメージの処理対象域も同じ幅となります。(単位はピクセル)
DstHeight 長整数型 編集中イメージの処理対象域の高さを設定します。0を設定した場合、イメージの高さ全体が処理対象域となります。合成元イメージの処理対象域も同じ幅となります。(単位はピクセル)
SrcFileName 文字列型 演算対象となる第2のイメージのファイル名を設定します。UNCファイル名やURL名も設定可能です。
SrcLeft 長整数型 変換元イメージの左上位置(X方向)をイメージ左上からの位置で設定します。(単位はピクセル)
SrcTop 長整数型 変換元イメージの左上位置(Y方向)をイメージ左上からの位置で設定します。(単位はピクセル)

[復帰値]

ブール型
True 正常
False 異常

[備考]

[参照]

ColorDepthプロパティBlendメソッド


ChangeColorDepthメソッド

[機能]

イメージの色数を変更します。

[書式]

C/C++ BOOL ChangeColorDepth(short ColorDepth);
Visual Basic [form.]object.ChangeColorDepth(ColorDepth%)

[パラメータ]

パラメータ 説明
ColorDepth 整数型 設定値 意味
cwmColorBitmap 1 2色
cwmColor16 4 16色
cwmColor256 8 256色
cwmColorGrayscale 9 256階調グレースケール
cwmColorRGB 12 1677万色

[復帰値]

ブール型
True 正常
False 異常

[参照]

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


ClearRubberBandメソッド

[機能]

矩形選択枠を消去します。

[書式]

C/C++ void ClearRubberBand();
Visual Basic [form.]object.ClearRubberBand

[パラメータ]

なし

[復帰値]

なし

[参照]

NotifyCancelDragイベントNotifyDraggedRectイベントNotifyDraggingRectイベントSetRubberBandメソッド


ClipRectメソッド

[機能]

イメージの矩形切り取りを行います。設定した矩形範囲の内側がイメージとして残り、外側のイメージは切り捨てます。

[書式]

C/C++ BOOL ClipRect(long Left, long Top, long Width, long Height);
Visual Basic [form.]object.ClipRect(Left&,Top&,Width&,Height&)

[パラメータ]

パラメータ 説明
Left 長整数型 矩形の左上X位置をイメージ左上からのオフセットで設定します。(単位はピクセル)
Top 長整数型 矩形の左上Y位置をイメージ左上からのオフセットで設定します。(単位はピクセル)
Width 長整数型 矩形の幅を設定します。(単位はピクセル)
Height 長整数型 矩形の高さを設定します。(単位はピクセル)

[復帰値]

ブール型
True 正常
False 異常

[備考]

ClipRectメソッド実行後のイメージの幅、高さはそれぞれImageWidthプロパティImageHeightプロパティに設定します。

[参照]

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


CopyToClipboardメソッド

[機能]

クリップボードにイメージをコピーします。イメージ全体、またはイメージの一部分(矩形で指定した)をコピーすることができます。

[書式]

C/C++ BOOL CopyToClipboard(long Left, long Top, long Width, long Height);
Visual Basic [form.]object.CopyToClipboard(Left&,Top&,Width&,Height&)

[パラメータ]

パラメータ 説明
Left 長整数型 矩形の左上X位置をイメージ左上からのオフセットで設定します。(単位はピクセル)
Top 長整数型 矩形の左上Y位置をイメージ左上からのオフセットで設定します。(単位はピクセル)
Width 長整数型 矩形の幅を設定します。0を設定した場合はイメージの幅全体が処理対象域となります。(単位はピクセル)
Height 長整数型 矩形の高さを設定します。0を設定した場合はイメージの高さ全体が処理対象域となります。(単位はピクセル)

[復帰値]

ブール型
True 正常
False 異常

[備考]

クリップボードにコピーされるイメージは、Windowsのデバイス独立型のビットマップ(DIB)の形式です。

[参照]

CreateFromClipboardメソッドPasteFromClipboardメソッド


CreateFromClipboardメソッド

[機能]

クリップボードのデータから新規イメージを作成します。

[書式]

C/C++ BOOL CreateFromClipboard();
Visual Basic [form.]object.CreateFromClipboard

[パラメータ]

なし

[復帰値]

ブール型
True 正常
False 異常

[備考]

[参照]

ColorDepthプロパティImageHeightプロパティImageWidthプロパティXResolutionプロパティYResolutionプロパティCopyToClipboardメソッドPasteFromClipboardメソッド


Deleteメソッド

[機能]

Loadメソッドで読み込み、各種の編集作業を行ったイメージを破棄します。

[書式]

C/C++ BOOL Delete();
Visual Basic [form.]object.Delete

[パラメータ]

なし

[復帰値]

ブール型
True 正常
False 異常

[備考]

Deleteメソッド実行後は、ResetメソッドUndoメソッドは実行できません。

[参照]

LoadメソッドResetメソッドUndoメソッド


DeletePageメソッド

[機能]

マルチページイメージから指定のページを削除します。

[書式]

C/C++ BOOL DeletePage(BSTR FileName, short Page);
Visual Basic [form.]object.DeletePage(FileName$, Page%)

[パラメータ]

パラメータ 説明
FileName 文字列型 マルチページイメージのファイル名を設定します。UNCファイル名も設定可能です。
Page 整数型 削除するページ番号を設定します。1以上の数値を設定します。

[復帰値]

ブール型
True 正常
False 異常

[備考]

[参照]

SaveMediaFormatプロパティAddPageメソッドInsertPageメソッドReplacePageメソッド


DistortPinchメソッド

[機能]

イメージをつまんだように変形します。

[書式]

C/C++ BOOL DistortPinch(short Ratio);
Visual Basic [form.]object.DistortPinch(Ratio%)

[パラメータ]

パラメータ 説明
Ratio 整数型 変形の割合を-100〜100の範囲で設定します。0を設定した場合は変形されません。

[復帰値]

ブール型
True 正常
False 異常

DistortSkewメソッド

[機能]

イメージを傾斜させます(平行四辺形に変形します)。

[書式]

C/C++ BOOL DistortSkew(short Axis, short Angle);
Visual Basic [form.]object .DistortSkew(Axis%,Angle%)

[パラメータ]

パラメータ 説明
Axis 整数型 設定値 意味
cwmDirectionHorz 2 水平方向
cwmDirectionVert 3 垂直方向
Angle 整数型 傾斜角度を−60°〜60°の範囲で設定します。反時計回りが正方向です。

[復帰値]

ブール型
True 正常
False 異常

[備考]

[参照]

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


DistortSphereメソッド

[機能]

イメージを球面状に変形します。

[書式]

C/C++ BOOL DistortSphere(short Direction, short Ratio);
Visual Basic [form.]object.DistortSphere(Direction%,Ratio%)

[パラメータ]

パラメータ 説明
Direction 整数型 設定値 意味
cwmDirectionBoth 1 両方向
cwmDirectionHorz 2 水平方向
cwmDirectionVert 3 垂直方向
Ratio 整数型 変形の割合を−100〜100の範囲で設定します。0の場合は変形されません。

[復帰値]

ブール型
True 正常
False 異常

Embossメソッド

[機能]

イメージを浮き彫りにします。

[書式]

C/C++ BOOL Emboss();
Visual Basic [form.]object.Emboss

[パラメータ]

なし

[復帰値]

ブール型
True 正常
False 異常

[備考]

イメージの色数が、256階調グレースケール、1677万色の場合に有効です。

[参照]

ColorDepthプロパティ


EnhanceEdgesメソッド

[機能]

イメージの輪郭を強調します。

[書式]

C/C++ BOOL EnhanceEdges();
Visual Basic [form.]object.EnhanceEdges

[パラメータ]

なし

[復帰値]

ブール型
True 正常
False 異常

[備考]

イメージの色数が、256階調グレースケール、1677万色の場合に有効です。

[参照]

ColorDepthプロパティ


Equalizeメソッド

[機能]

イメージ内の明るさの値を、明るさのレベル範囲全体に均等化するよう再配分します。

[書式]

C/C++ BOOL Equalize();
Visual Basic [form.]object.Equalize

[パラメータ]

なし

[復帰値]

ブール型
True 正常
False 異常

[備考]

イメージの色数が、256階調グレースケール、1677万色の場合に有効です。

[参照]

ColorDepthプロパティ


FillRectメソッド

[機能]

イメージの一部を矩形で塗りつぶします。指定した矩形範囲の内側をFillingColorプロパティで設定した色で塗りつぶします。

[書式]

C/C++ BOOL FillRect(long Left, long Top, long Width, long Height);
Visual Basic [form.]object.FillRect(Left&,Top&,Width&,Height&)

[パラメータ]

パラメータ 説明
Left 長整数型 矩形の左上位置(X方向)をイメージ左上からのオフセットで設定します。(単位はピクセル)
Top 長整数型 矩形の左上位置(Y方向)をイメージ左上からのオフセットで設定します。(単位はピクセル)
Width 長整数型 矩形の幅を設定します。(単位はピクセル)
Height 長整数型 矩形の高さを設定します。(単位はピクセル)

[復帰値]

ブール型
True 正常
False 異常

[参照]

FillingColorプロパティ


FindEdgesメソッド

[機能]

イメージの輪郭を抽出します。イメージ内で明確な色の変化がある部分を識別し、その部分の輪郭を検出します。

[書式]

C/C++ BOOL FindEdges();
Visual Basic [form.]object.FindEdges

[パラメータ]

なし

[復帰値]

ブール型
True 正常
False 異常

[備考]

イメージの色数が、256階調グレースケール、1677万色の場合に有効です。

[参照]

ColorDepthプロパティ


Flipメソッド

[機能]

イメージの向きを反転します。

[書式]

C/C++ BOOL Flip(short Direction);
Visual Basic [form.]object.Flip(Direction%)

[パラメータ]

パラメータ 説明
Direction 整数型 設定値 意味
cwmDirectionHorz 2 左右方向
cwmDirectionVert 3 上下方向

[復帰値]

ブール型
True 正常
False 異常