The IEViewer type exposes the following properties.

Properties

 Public

 Protected
 Instance

 Static
 Declared

 Inherited
 XNA Framework Only

 .NET Compact Framework Only

 MemberDescription
AccessibilityObject
Gets the AccessibleObject assigned to the control.
(Inherited from Control.)
AccessibleDefaultActionDescription
Gets or sets the default action description of the control for use by accessibility client applications.
(Inherited from Control.)
AccessibleDescription
Gets or sets the description of the control used by accessibility client applications.
(Inherited from Control.)
AccessibleName
Gets or sets the name of the control used by accessibility client applications.
(Inherited from Control.)
AccessibleRole
Gets or sets the accessible role of the control
(Inherited from Control.)
AllowDrop
Gets or sets a value indicating whether the control can accept data that the user drags onto it.
(Inherited from Control.)
AllowOutOfBitmapMoving
If True (default) objects can go out of background bitmap.
AllowOutOfBitmapPolylines
When true polylines can be painted out of background bitmap bounding box.
Anchor
Gets or sets the edges of the container to which a control is bound and determines how a control is resized with its parent.
(Inherited from Control.)
AutoCursors
If true IEvolution handles mouse cursors (default).
AutoFit

If AutoFit is True and the image is updated (Update method) the Fit is called.

In this way you are not obliged to call fit each time you load a picture or each time the view is resized.

AutoScrollOffset
Gets or sets where this control is scrolled to in ScrollControlIntoView(Control).
(Inherited from Control.)
AutoShrink

When AutoShrink is True IEViewer follows these rules:

- If an image is bigger than IEViewer window it is Shrink to fit;

- If an image is smaller than IEViewer window it is displayed 100%

AutoSize
This property is not relevant for this class.
(Inherited from Control.)
AutoStretch

When AutoStretch is True IEViewer follows these rules:

- If an image is bigger than IEViewer window it is displayed 100%;

- If an image is smaller than IEViewer window it is stretched to fit

BackColor
The background color.
(Overrides Control..::..BackColor.)
BackgroundImage
The background image. Not used.
(Overrides Control..::..BackgroundImage.)
BackgroundImageLayout
Gets or sets the background image layout as defined in the ImageLayout enumeration.
(Inherited from Control.)
BackgroundStyle
Specifies the background style. The background is the component region around the image.
BindingContext
Gets or sets the BindingContext for the control.
(Inherited from Control.)
BorderStyle
Specifies the border style
Bottom
Gets the distance, in pixels, between the bottom edge of the control and the top edge of its container's client area.
(Inherited from Control.)
Bounds
Gets or sets the size and location of the control including its nonclient elements, in pixels, relative to the parent control.
(Inherited from Control.)
CanEnableIme
Gets a value indicating whether the ImeMode property can be set to an active value, to enable IME support.
(Inherited from Control.)
CanFocus
Gets a value indicating whether the control can receive focus.
(Inherited from Control.)
CanRaiseEvents
Determines if events can be raised on the control.
(Inherited from Control.)
CanSelect
Gets a value indicating whether the control can be selected.
(Inherited from Control.)
Capture
Gets or sets a value indicating whether the control has captured the mouse.
(Inherited from Control.)
CausesValidation
Gets or sets a value indicating whether the control causes validation to be performed on any controls that require validation when it receives focus.
(Inherited from Control.)
Center
Center the image
CenterNewObjects
When user inserts new objects with a single click, this property controls if the new object is centered at mouse position (True) or if its top-left side is on the mouse position (False - default).
ClientRectangle
Gets the rectangle that represents the client area of the control.
(Inherited from Control.)
ClientSize
Gets or sets the height and width of the client area of the control.
(Inherited from Control.)
CompanyName
Gets the name of the company or creator of the application containing the control.
(Inherited from Control.)
Container
Gets the IContainer that contains the Component.
(Inherited from Component.)
ContainsFocus
Gets a value indicating whether the control, or one of its child controls, currently has the input focus.
(Inherited from Control.)
ContextMenu
Gets or sets the shortcut menu associated with the control.
(Inherited from Control.)
ContextMenuStrip
Gets or sets the ContextMenuStrip associated with this control.
(Inherited from Control.)
Controls
Gets the collection of controls contained within the control.
(Inherited from Control.)
Created
Gets a value indicating whether the control has been created.
(Inherited from Control.)
CreateParams
Gets the required creation parameters when the control handle is created.
(Inherited from Control.)
CropToolInteraction
Provides access to the methods and properties of the CropToolInteraction class, which is used when EnableCropTool is True.
Cursor
Specifies mouse cursor
(Overrides Control..::..Cursor.)
DataBindings
Gets the data bindings for the control.
(Inherited from Control.)
DefaultCursor
Gets or sets the default cursor for the control.
(Inherited from Control.)
DefaultImeMode
Gets the default Input Method Editor (IME) mode supported by the control.
(Inherited from Control.)
DefaultMargin
Gets the space, in pixels, that is specified by default between controls.
(Inherited from Control.)
DefaultMaximumSize
Gets the length and height, in pixels, that is specified as the default maximum size of a control.
(Inherited from Control.)
DefaultMinimumSize
Gets the length and height, in pixels, that is specified as the default minimum size of a control.
(Inherited from Control.)
DefaultPadding
Gets the internal spacing, in pixels, of the contents of a control.
(Inherited from Control.)
DefaultSize
Gets the default size of the control.
(Inherited from Control.)
DelayDisplaySelection

If DelayDisplaySelection is True, the selection is displayed with delay.

This allow you to quickly navigate the image (zoom and scroll) and only after you have finished the navigation the selection is displayed.

DelayTimer

IEvolution has a timer that decrements a counter at each tick (you can set the tick delay using DelayTimer property).

This timer controls the selection animation and the application of filters on scrolling (when DelayZoomFilter is True).

If you set negative values DelayTimer changes its behavior. Negative values represent the maximum CPU time that ImageEn can use to show selections. For example setting:

ieViewer1.DelayTimer = -10;

IEvolution will not use much more than 10% of the CPU time.

The default DelayTimer's value is -20 (maximum 20% of the CPU time).

DelayZoomFilter

If DelayZoomFilter is True, the filter is applied with delay.

This allow you to quickly navigate the image (zoom and scroll) and only after you have finished the navigation the filter (quality zoom) is applied.

DesignMode
Gets a value that indicates whether the Component is currently in design mode.
(Inherited from Component.)
DeviceDpi()()()() (Inherited from Control.)
DirectShow

Represents a IEDirectShow object.

It allows control of some DirectShow features, such as video capture, audio capture, multimedia files capture as well video rendering, and multimedia file writing.

DisplayGrid
When DisplayGrid is True and the Zoom is equal or more of 400 a grid is drawn. Each box is equivales to a bitmap pixel.
DisplayGridKind
Enables the display of helper lines over the image.
DisplayGridLyr

Specifies where to draw the grid if DisplayGridKind is PixelGrid.

-1 : current layer (default behavior)

>= 0 : specific layer

DisplayRectangle
Gets the rectangle that represents the display area of the control.
(Inherited from Control.)
Disposing
Gets a value indicating whether the base Control class is in the process of disposing.
(Inherited from Control.)
Dock
Gets or sets which control borders are docked to its parent control and determines how a control is resized with its parent.
(Inherited from Control.)
DoubleBuffered
Gets or sets a value indicating whether this control should redraw its surface using a secondary buffer to reduce or prevent flicker.
(Inherited from Control.)
EnableAlphaChannel

Enable/disable alpha channel

Some formats like Gif, Png, Tiff, Ico, Cur contains an alpha channel that specifies the image’s pixels transparency.

If ZoomFilter is not None IEViewer disables the alpha channel.

EnableAnnotationsZoom
Enables zoom to vectorial objects (lines, boxs,..). This allows to enlarge objects width on zoom-in.
Enabled
Gets or sets a value indicating whether the control can respond to user interaction.
(Inherited from Control.)
EnableEditPolyline
Specifies which mouse activities IEViewer handles automatically.
EnableHandScroll
Specifies which mouse activities IEViewer handles automatically.
EnableInteractionHints
When true (default) enables mouse interaction hints (layers rotation angle, movement position...).
EnableMeasureDistance
Specifies which mouse activities IEViewer handles automatically.
EnableMoveLayers
Specifies which mouse activities IEViewer handles automatically.
EnableMovingScroll
Specifies which mouse activities IEViewer handles automatically.
EnableObjectInserting
Specifies which mouse activities IEViewer handles automatically.
EnableObjectSelect
Specifies which mouse activities IEViewer handles automatically.
EnableResizeLayers
Specifies which mouse activities IEViewer handles automatically.
EnableRotateLayers
Specifies which mouse activities IEViewer handles automatically.
EnableSelectEllipse
Specifies which mouse activities IEViewer handles automatically.
EnableSelectLasso
Specifies which mouse activities IEViewer handles automatically.
EnableSelectMagicWand
Specifies which mouse activities IEViewer handles automatically.
EnableSelectPolygon
Specifies which mouse activities IEViewer handles automatically.
EnableSelectRectangle
Specifies which mouse activities IEViewer handles automatically.
EnableShowSelectionArea
Specifies which mouse activities IEViewer handles automatically.
EnableShowSelectionLen
Specifies which mouse activities IEViewer handles automatically.
EnableZoomOnClick
Specifies which mouse activities IEViewer handles automatically.
EnableZoomOnSelect
Specifies which mouse activities IEViewer handles automatically.
Events
Gets the list of event handlers that are attached to this Component.
(Inherited from Component.)
ExtentX
Returns the width of the area used to show the current image (i.e. the width of the image as it appears onscreen).
ExtentY
Returns the height of the area used to show the current image (i.e. the height of the image as it appears onscreen).
Focused
Gets a value indicating whether the control has input focus.
(Inherited from Control.)
Font
The control Font. Not used.
(Overrides Control..::..Font.)
FontHeight
Gets or sets the height of the font of the control.
(Inherited from Control.)
ForceALTkey

Set ForceALTkey to True to emulate ALT key pression.

It allows to make and modify selections or vectorial objects always maintaining apsect ratio.

Default is False.

ForeColor
The control color. Not used.
(Overrides Control..::..ForeColor.)
Handle
Gets the window handle that the control is bound to.
(Inherited from Control.)
HasChildren
Gets a value indicating whether the control contains one or more child controls.
(Inherited from Control.)
Height
Gets or sets the height of the control.
(Inherited from Control.)
Image
The IEImage object that contains the bitmap
ImageHorizAlignment
Specifies where to align horizontally the image inside the component. Default is Center.
ImageVerticalAlignment
Specifies where to align vertically the image inside the component. Default is Center.
ImeMode
Gets or sets the Input Method Editor (IME) mode of the control.
(Inherited from Control.)
ImeModeBase
Gets or sets the IME mode of a control.
(Inherited from Control.)
InternalCursor
Specifies IEvolution internal cursor default internal cursor is InternalCursorType.Cross2
InvokeRequired
Gets a value indicating whether the caller must call an invoke method when making method calls to the control because the caller is on a different thread than the one the control was created on.
(Inherited from Control.)
IsAccessible
Gets or sets a value indicating whether the control is visible to accessibility applications.
(Inherited from Control.)
IsDisposed
Gets a value indicating whether the control has been disposed of.
(Inherited from Control.)
IsHandleCreated
Gets a value indicating whether the control has a handle associated with it.
(Inherited from Control.)
IsMirrored
Gets a value indicating whether the control is mirrored.
(Inherited from Control.)
LayerOptions

Options to control layer behavior.

Default enabled: AllowMultiSelect, AutoUndoChangesByUser, AutoPromptForImage, AutoFixBorders

LayersCaching

Whether a cached view of every layer is stored in memory.

Supported values:

-1 : A cached view is stored for each layers. This provides the best performance, but can use a lot of memory if there are many layers

0 : No cached views of layers are stored. This uses the least memory

>0 : Specifies a maximum number of cached views to store

Default: 0

LayersCropped

When enabled, any part of layers that are outside the background image (layer 0) area will not be displayed.

If true, it overrides the Cropped property of individual layers.

Default: False

LayersDrawBox

If LayersDrawBox is true, a box is drawn around layers.

If Layers[].VisibleBox is false, no box is displayed (LayersDrawBox doesn't care).

If Layers[].VisibleBox is true and LayersDrawBox is false, a box is drawn only on the selected layer.

If Layers[].VisibleBox is true and LayersDrawBox is true, a box is drawn on all layers.

LayersFastDrawing
Improves the performance of layer rendering by delayed or disabling slow operations.
LayersResizeAspectRatio
Specifies how IEvolution handles layers resizing aspect ratio. Default value is iearALTKey.
LayersRotateStep
Sets the rotate step when user rotates a layer and press SHIFT.
LayersRotationAntialias
Specifies the rotation antialias to use when layers rotation has finished and stabilizied.
LayersRotationUseFilterOnPreview

Displays the user's rotation with the selected anti-alias effect immediately (i.e. before calling LayersFixRotations).

Note: Preview of large rotated images at high quality can be slow, so it is recommended that you also use LayersFastDrawing.

Default: False

LayersSelectConstrains

If true (default) selection constrains are active.

The unique layer selection constrain controlled is IELayer.Selectable.

LayoutEngine
Gets a cached instance of the control's layout engine.
(Inherited from Control.)
Left
Gets or sets the distance, in pixels, between the left edge of the control and the left edge of its container's client area.
(Inherited from Control.)
Location
Gets or sets the coordinates of the upper-left corner of the control relative to the upper-left corner of its container.
(Inherited from Control.)
Margin
Gets or sets the space between controls.
(Inherited from Control.)
MaximumSize
Gets or sets the size that is the upper limit that GetPreferredSize(Size) can specify.
(Inherited from Control.)
MaxSelectionDistance

MaxSelectionDistance indicates the maximum distance (in bitmap pixels) from which an object may be selected.

If you left click in a zone beyond this distance no object will be selected.

-1 (the default) disables maximum selection distance (a click always select an object).

MeasureTrack
If MeasureTrack is True, on measurements will be also calculated the mouse movements.
MinimumSize
Gets or sets the size that is the lower limit that GetPreferredSize(Size) can specify.
(Inherited from Control.)
MouseInteract

Specify which mouse activities are performed when the user interacts with the IEViewer component with the mouse.

Note: Multiple interactions can be specified, but activities that are not mutually compatible will be excluded

MouseWheelAction

MouseWheelXXXXX properties allow application to customize the mouse wheel behavior.

MouseWheelAction specifies the task to perform on mouse wheel events.

Specify MouseWheelActions.None for no operation, MouseWheelActions.VScroll for vertical image scroll or MouseWheelActions.Zoom for zoom-in/out (default MouseWheelActions.Zoom).

MouseWheelInvertDirection

MouseWheelXXXXX properties allow application to customize the mouse wheel behavior.

If MouseWheelInvertDirection is True it inverts wheel direction (default False).

MouseWheelValue

MouseWheelXXXXX properties allow application to customize the mouse wheel behavior.

Value or percentage of variation (default 8).

MouseWheelVariation

MouseWheelXXXXX properties allow application to customize the mouse wheel behavior.

MouseWheelVariation specifies how much scrolls or zoom in response to mouse wheel rotation.

If MouseWheelVariation is MouseWheelVariations.Absolute, MouseWheelValue will contains the absolute value to add or substract from current value.

If MouseWheelVariation is MouseWheelVariations.Percentage, MouseWheelValue will contains the percentage of variation from current value (default MouseWheelVariations.Percentage).

MouseWheelZoomPosition

MouseWheelXXXXX properties allow application to customize the mouse wheel behavior.

If MouseWheelAction is Zoom, MouseWheelZoomPosition specifies where the zoom act.

The default is the center of the control (MouseWheelZoomPositions.Center), otherwise (MouseWheelZoomPositions.Mouse) zoom at the mouse position.

Name
Gets or sets the name of the control.
(Inherited from Control.)
ObjectMaxMovingDistance

Represents the maximum pointer distance from the object (in pixels) that allows object moving.

Default is 1.

ObjectsEnableFastDrawing

When true (default), moving objects or doing other visual operation disables antialiasing and shadows.

If you have a fast machine, disable this property to increase user graphical experience.

ObjectsSelectOnMouseDown
If SelectOnMouseDown is True, then a mouse down action selects an object, otherwise it waits mouse up to select.
ObjectsUseCentralGrip
If True (default) allows to move an object only using the central grip. If False, allows to move an object just clicking on it (the central grip disappairs).
ObjGripShape
Specifies the grip's shape as shown when an object is selected.
OffsetX

Returns the horizontal position where the image has been drawn. If ImageHorizAlignment is Left, OffsetX will be zero, whereas for iehCenter it will be (Control Width - Image Width) / 2.

Note: This value only indicates the initial draw position for an image, it is not related to scrolling (unlike ViewX).

OffsetY

Returns the vertical position where the image has been drawn. If ImageVertAlignment is Top, OffsetY will be zero, whereas for ievCenter it will be (Control Height - Image Height) / 2.

Note: This value only indicates the initial draw position for an image, it is not related to scrolling (unlike ViewY).

Padding
Gets or sets padding within the control.
(Inherited from Control.)
Parent
Gets or sets the parent container of the control.
(Inherited from Control.)
PreferredSize
Gets the size of a rectangular area into which the control can fit.
(Inherited from Control.)
ProductName
Gets the product name of the assembly containing the control.
(Inherited from Control.)
ProductVersion
Gets the version of the assembly containing the control.
(Inherited from Control.)
RecreatingHandle
Gets a value indicating whether the control is currently re-creating its handle.
(Inherited from Control.)
Region
Gets or sets the window region associated with the control.
(Inherited from Control.)
RenderRightToLeft Obsolete.
This property is now obsolete.
(Inherited from Control.)
ResizeRedraw
Gets or sets a value indicating whether the control redraws itself when resized.
(Inherited from Control.)
Right
Gets the distance, in pixels, between the right edge of the control and the left edge of its container's client area.
(Inherited from Control.)
RightToLeft
Not used.
(Overrides Control..::..RightToLeft.)
RulerParams
Allows you to configure the properties of your rulers.
SavedSelectionsCount
Returns the number of saved selections using SaveSelection method.
ScaleChildren
Gets a value that determines the scaling of child controls.
(Inherited from Control.)
ScrollBars
Specifies whether the IEViewer includes horizontal and vertical scroll bars.
ScrollBarsAlwaysVisible
When this property is True the scroll bars specified in ScrollBars property will be always visible, even if this is not necessary.
Selected
Specifies if there is a selection
SelectionAbsHeight
Specifies the fixed selection height, when SelectionAspectRatio is 0.
SelectionAbsWidth
Specifies the fixed selection width, when SelectionAspectRatio is 0.
SelectionAspectRatio

Specifies the selection aspect ratio.

If SelectionAspectRatio is -1, the aspect ratio is active only when user press the ALT key, and it is automatically calculated.

If SelectionAspectRatio is 0, the size of the selection is fixed and determined by SelectionAbsWidth and SelectionAbsHeight properties.

If SelectionAspectRatio is >0, ImageEn maintains the specified aspect.

SelectionGridSize
When > 1, a grid of SelectionGridSize size will be displayed on rectangular selections. Default is 1.
SelectionMarkOuter
Makes grayed the unselected area (the area out of selection).
SelectionOptions
Provides access to selection behavior options.
SelectionVisible
SelectionVisible shows or hides current selection.
SelectTransparentLayers
If true then transparent areas of a layer are selectable.
ShowFocusCues
Gets a value indicating whether the control should display focus rectangles.
(Inherited from Control.)
ShowHorizontalRuler
Specify whether horizontal ruler is shown on the IEViewer. Rulers show the current position of the cursor and can include optional grips to mark the position of other objects. Use RulerParams to configure the ruler properties.
ShowKeyboardCues
Gets a value indicating whether the user interface is in the appropriate state to show or hide keyboard accelerators.
(Inherited from Control.)
ShowVerticalRuler
Specify whether vertical ruler is shown on the IEViewer. Rulers show the current position of the cursor and can include optional grips to mark the position of other objects. Use RulerParams to configure the ruler properties.
Site
Gets or sets the site of the control.
(Inherited from Control.)
Size
Gets or sets the height and width of the control.
(Inherited from Control.)
SmoothScrollValue

Specifies the scrolling smooth when SetViewXYSmooth is called or when EnableMovingScroll is true.

Large values increase smooth. "0" disables smooth (acts like SetViewXY).

SoftCrop
Specifies the operation to perform when a layer is outside of the background layer (layer 0). I.e. to provide a visual indication to the user.
SoftCropValue

If SoftCrop is AlphaBlend then the SoftCropValue specifies the level of transparency from 0 (minimal) to 255 (fully)

If SoftCrop is Add then the SoftCropValue specifies the amount of color shift from 0 (minimal) to 255 (extreme)

TabIndex
Gets or sets the tab order of the control within its container.
(Inherited from Control.)
TabStop
Gets or sets a value indicating whether the user can give the focus to this control using the TAB key.
(Inherited from Control.)
Tag
Gets or sets the object that contains data about the control.
(Inherited from Control.)
Text
The control text. Not used.
(Overrides Control..::..Text.)
Top
Gets or sets the distance, in pixels, between the top edge of the control and the top edge of its container's client area.
(Inherited from Control.)
TopLevelControl
Gets the parent control that is not parented by another Windows Forms control. Typically, this is the outermost Form that the control is contained in.
(Inherited from Control.)
TransitionTiming
TransitionTiming allows you to select how the transition progresses (linear, logarithmic, exponential).
UseGDIPlus
If True ImageEn used GDIPlus instead of GDI, when available.
UseWaitCursor
Gets or sets a value indicating whether to use the wait cursor for the current control and all child controls.
(Inherited from Control.)
ViewX

ViewX is the first column displayed on left-upper side of the component.

You can set ViewX to simulate horizontal scroll-bar movement.

ViewY

ViewY is the first row displayed on left-upper side of the component.

You can set ViewY to simulate vertical scroll-bar movement.

Visible
Gets or sets a value indicating whether the control and all its child controls are displayed.
(Inherited from Control.)
Width
Gets or sets the width of the control.
(Inherited from Control.)
WindowTarget
This property is not relevant for this class.
(Inherited from Control.)
Zoom
Zoom property zoom-in or zoom-out the image. No modifications are made to the image.
ZoomFilter

ZoomFilter specifies the filter to apply in zoom-in (Zoom property) operations.

The fastest way to zoom a picture is to set ZoomFilter to None (default).

ZoomSelectionAspectRatio

This property is active when EnableZoomOnSelect is enabled.

If true (default) the selected rectangle is adjusted to maintain aspect ratio.

Otherwise (false) the image losses aspect ratio (ZoomX!=ZoomY and Zoom value is invalid) making it stretched inside the component.

ZoomX

ZoomX specifies the horizontal Zoom.

Using this property (and/or ZoomY) you loss the image aspect ratio and some functions, which require aspect ratio, may not properly work.

Setting ZoomX and ZoomY to the same value is equivalent to set Zoom.

ZoomY

ZoomY specifies the vertical Zoom.

Using this property (and/or ZoomX) you loss the image aspect ratio and some functions, which require aspect ratio, may not properly work.

Setting ZoomX and ZoomY to the same value is equivalent to set Zoom.

See Also