クリップボードへのコピー

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

Syntax

C#
public void CopyToClipboard(
	Rectangle region
)
Visual Basic
Public Sub CopyToClipboard ( 
	region As Rectangle
)

Parameters

region
Type: System.Drawing..::..Rectangle
コピー範囲 (画像上の座標)

Remarks

画像上の指定の範囲をクリップボードにコピーします。

引数 region には画像座標をピクセル単位で指定してください。 region の右と下の1画素分のラインはコピー範囲に含まれません。

region に指定された矩形は以下の手順で正規化が行われますが、 正規化後に矩形領域の幅または高さが 0 以下になる場合はエラーとなります。

正規化手順:

  • 矩形の上下及び左右の反転を正規化します。 -
  • 左座標が 0 未満の場合は 0 にします。 -
  • 右座標が 画像幅を超える場合は 画像幅 にします。 -
  • 上座標が 0 未満の場合は 0 にします。 -
  • 下座標が 画像高さを超える場合は 画像高さ にします。 -

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

エラーコード:

ErrorCode メンバ内容
11FVIL.ErrorCode.INVALID_PARAMETER 指定された範囲の幅と高さが 0 以下です。
26FVIL.ErrorCode.NOT_CREATED描画に必要なリソースが生成されていません。
81FVIL.ErrorCode.HAVE_NOT_IMAGE画像オブジェクトが設定されていません。
1FVIL.ErrorCode.FAILED_TO_ALLOCATE引数に指定された画像オブジェクトの領域確保に失敗しました。

Exceptions

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

See Also