PaintProperties Property (ImageViewer)

public virtual RasterPaintProperties PaintProperties {get; set;}

'Declaration
 

Public Overridable Property PaintProperties As RasterPaintProperties

Property Value

The ImageViewer will create an instance of RasterPaintProperties and sets it in PaintProperties upon initialization. It will then use this instance to render any RasterImage instance or their regions.

The viewer creates an instance using RasterPaintProperties.Default and then modifies the values as follows:

These options will provide optimal viewing experience for any type of images, color and bitonal. After that, the ImageViewer will use RasterImagePainter.Paint to render the RasterImage objects into the surface of the viewer.

RasterPaintProperties is a value type (structure), and hence, you cannot change the values directly by modifying the PaintProperties property. Instead, you should save the value into a temporary variable, modify it and then set it back:

            // Turn on Bicubic instead of Resample for colored images
            RasterPaintProperties paintProperties = viewer.PaintProperties;
            paintProperties.PaintDisplayMode = RasterPaintDisplayModeFlags.Bicubic | RasterPaintDisplayModeFlags.ScaleToGray;
            viewer.PaintProperties = paintProperties;
            

Important:RasterPaintEngine.Gdi is not supported by this ImageViewer, setting the engine value to anything other than RasterPaintEngine.GdiPlus will have no effect and the viewer will still internally use GDI+ to render tha images. This is required because the viewer relies on setting a transform matrix in Graphics to translate, scale and rotate the images. This is not supported when the paint engine uses Windows API native StretchBlt function.

Target Platforms

Reference

ImageViewer Class
ImageViewer Members