ImageGear for .NET User Guide > Using ImageGear for .NET > Displaying Images > ImGearPageDisplay Functions |
ImGearPageDisplay Class provides a great deal of display-related properties and methods. All of the methods, and most of these properties, are used by your application program to control the way the image is displayed in the application.
The following ImGearPageDisplay Class properties and methods effect the display of an image only, not the image itself (as contained in the ImGearPage Class object). They do not alter the image bitmap. To alter the image itself, use the Image Manipulation facilities of ImageGear, described below.
A few of these properties are "read-only", and provide information about the rendered image to your application. The ImGearPageDisplay Class properties are grouped into data-value objects as a way to organize them. The data-value objects, and the properties that they contain, are as follows (for complete descriptions of these properties and methods, see the ImageGear.Display Namespace).
IImGearAntiAlias Interface |
Properties used to make scanned text more readable, by removing or minimizing the "aliasing" (jagged edges of characters and other thin lines). For example: Original Image
Image with AntiAliasing These properties can be referenced directly, using the AntiAliasing Property of ImGearPageDisplay Class:
| ||||||||
IImGearBackground Interface |
Controls the appearance of the area that is inside ImGearPageView Class, but outside of the displayed image. For example: Default Background Your application can set the background to a solid color or disable background drawing. These properties can be referenced directly, using the Background Property of ImGearPageDisplay Class:
| ||||||||
ImGearScrollInfo Structure |
Controls the way a portion of a large image is visible within the smaller ImGearPageView Class. Scrolling can either be automatic (ImageGear takes care of it) or manual (your application has to react to mouse events and tell ImGearPageDisplay Class how to position the image). The scroll properties are all interrelated, and so they are "gotten" from ImGearPageDisplay Class as a group, and they are "updated" in ImGearPageDisplay Class as a group. Access them as follows:
Change the properties as follows:
| ||||||||
ImGearZoomInfo Structure |
Controls the way that an image is magnified before being displayed in the ImGearPageView Class. For example: Actual Size 300% Zoom The zoom properties are all interrelated, and so they are "gotten" from ImGearPageDisplay Class as a group, and they are "updated" in ImGearPageDisplay Class as a group. Access them as follows:
Change the properties as follows:
| ||||||||
ImGearPageDisplay.Layout Property |
Controls the geometric appearance (full image or partial image, centered or not, etc.) of the image as displayed in ImGearPageView Class. Layout settings include three rectangles (ImageRect, ClipRect and DeviceRect) that can be used to control the layout of the image as rendered a see ImageRect, ClipRect, and DeviceRect for a description of these rectangles. Normally your application won't reference these rectangles, as they default to the size of the image and the size of the ImGearPageView Class client area, respectively. The most commonly used layout properties are Alignment and FitMode: Alignment.Horizontal: Left Fit: To Window Height These properties can be referenced directly, using the Layout Property of ImGearPageDisplay Class:
|
The Orientation Property attribute is accessible directly from the ImGearPageDisplay Class object:
ImGearPageDisplay.Orientation Property |
Another control that determines the geometric appearance of the image as displayed in ImGearPageView Class. For example: BOTTOM_RIGHT RIGHT_BOTTOM These properties can be referenced directly:
|
The following ImGearPageDisplay Class methods can be used to change the way the ImGearPage Class image is rendered: