コンストラクタ (FIE ハンドル指定)

Namespace: FVIL.Data
Assembly: FVILbasic (in FVILbasic.dll) Version: 3.1.0.0 (3.1.0.17)

Syntax

C#
public CFviImage( FHANDLE hImage, int channel, Rectangle region )

Visual Basic
Public Sub New ( hImage As FHANDLE, channel As Integer, region As Rectangle )

Remarks

指定された FIE 画像オブジェクトの指定範囲を参照するチャイルド画像を生成します。
内部では AttachFIE(FHANDLE, Int32, Rectangle) を呼び出しています。

channel に -1 が指定された時は全てのチャネルを参照します。 0 以上の値が指定された場合は単一のチャネルを参照します。
全面を参照する場合は、Rectangle の初期値(始点・幅・高さが全て 0)を region に指定してください。

ここで作成したチャイルド画像は、このクラスの Dispose メソッドで解放されます。チャイルド画像を使用する間、参照先の FIE 画像オブジェクトを解放しないでください。

FIE ハンドルとは FIE ライブラリで使用されるデータ構造のことです。 FIE ハンドルはいくつかの種類がありますが、ここでは F_OBJID_IMG_ROOT と F_OBJID_IMG_CHILD のことを意味します。詳しくは FIE ライブラリ説明書をご参照ください。

設定に失敗した場合は例外を発行します。例外の原因と発生位置を特定するには、発行された例外クラスの ErrorCode メンバと Function メンバを参照してください。

エラーコード：

値	ErrorCode メンバ	内容
51	FVIL.ErrorCode.FAILED_TO_ALLOCATE	ライセンスがありません。
1	FVIL.ErrorCode.FAILED_TO_ALLOCATE	メモリの確保に失敗しました。
11	FVIL.ErrorCode.INVALID_PARAMETER	パラメータが無効です。
12	FVIL.ErrorCode.INVALID_OBJECT	オブジェクトが不正です。

Exception	Condition
FVIL..::..CFviException	この例外の原因については、上記のエラーコード表をご参照ください。