(Leadtools.Controls)

フレームを表示

AutoDisposeImagesプロパティ




項目イメージ、SVGドキュメントとフローターを自動的に破棄するべきかどうか示します。
構文
public virtual bool AutoDisposeImages {get; set;}
'Declaration
 
Public Overridable Property AutoDisposeImages As Boolean

属性値

項目イメージ、SVGドキュメントとフローターを自動的に破棄するtrue;そうでない場合はfalse。デフォルト値はtrueです
解説

AutoDisposeImagesの値がtrueに設定されるとき、画像ビューワは項目が項目コレクションから削除されるとき、または、コントロール自体が破棄されるとき、項目のimageSvgDocumentフローターの上でRasterImage.Disposeメソッドを自動的に呼び出します。

コントロールは、画像が複数の項目で使用するかどうかを確認します(たとえば、複数の項目で同じ画像を使っているが別のページに表示するなど)。この場合、コントロールは一度だけimageを正しく破棄します。

破棄したくない画像で項目をセットアップし、どこか別の場所で再利用する場合、AutoDisposeImagesプロパティの値をfalseに設定します。

項目の画像を破棄する前に保存する場合は、AutoDisposeImagesプロパティ値を一時的に変更することもできます。たとえば、AutoDisposeImagesプロパティをfalseに設定します、項目を削除するために項目コレクションの上で「削除されて」呼び出します、そして、trueAutoDisposeImagesプロパティをリセットします。

AutoDisposeImages値をfalseに設定している場合にアイテム画像を手動で破棄しなかったときでも、コントロールとこれらの画像への参照が不要になると、最終的に.NETガベージコレクターによってこれらの使用されなくなった画像が検出されて破棄されます。画像データにはアンマネージメモリやリソースが含まれており、オーナーオブジェクトが使われなくなってもシステムに返されないので、この方法はお勧めしません。

詳細については、「画像ビューワの項目」を参照してください。

サンプル

このサンプルは、AutoDisposeImagesのエフェクトを示します。

Copy Code  
Imports Leadtools
Imports Leadtools.Controls
Imports Leadtools.Codecs
Imports Leadtools.Drawing
Imports Leadtools.ImageProcessing
Imports Leadtools.ImageProcessing.Color

' Make a copy of the image in viewer and save it
Dim image2 As RasterImage = _imageViewer.Image
' Set a copy in the viewer, this is the image we will change here
_imageViewer.AutoDisposeImages = False
_imageViewer.Image = image2.Clone()
_imageViewer.AutoDisposeImages = True
using Leadtools;
using Leadtools.Controls;
using Leadtools.Codecs;
using Leadtools.Drawing;
using Leadtools.ImageProcessing;
using Leadtools.ImageProcessing.Color;

// Make a copy of the image in viewer and save it
RasterImage image2 = _imageViewer.Image;
// Set a copy in the viewer, this is the image we will change here
_imageViewer.AutoDisposeImages = false;
_imageViewer.Image = image2.Clone();
_imageViewer.AutoDisposeImages = true;
必要条件

ターゲットプラットホーム

参照

参照

ImageViewerクラス
ImageViewerメンバ