| Name | Description | |
|---|---|---|
 | AccessibleDescription | (Inherited from System.Windows.Forms.Control) |
| AccessibleName | (Inherited from System.Windows.Forms.Control) |
| AccessibleRole | (Inherited from System.Windows.Forms.Control) |
| AllowDrop | (Inherited from System.Windows.Forms.Control) |
| AllowDropFile | Specifies if a user is able to drag-and-drop files from the file explorer directly to the control, for example using the mouse.
If this property is set to true and a file is dropped within the control, the DropFile event is raised. |
| Anchor | (Inherited from System.Windows.Forms.Control) |
| AnimateGIF | Specifies whether the GdViewer control must animate the currently loaded multi-frame GIF image by defaut, for example when displaying the image or refreshing the control. If this property is set to true, the image will playing in the loop. |
| AnnotationDropShadow | Determines whether all GdPicture/XMP annotations are rendered with a very light and gentle drop shadow effect on the screen. The shadow effect is not applicable when saving annotations to a file. |
| AnnotationEnableMultiSelect | Specifies if multi selection in enabled for the GdPicture/XMP annotations. Default value is true. |
| AnnotationResizeRotateHandlesColor | Gets or sets the color that is used when drawing the resizing and rotating handles when selecting GdPicture XMP annotations. This value is common for all annotations.
The handles are displayed as visible dots (round marks) respecting both the AnnotationResizeRotateHandlesColor and the AnnotationResizeRotateHandlesScale properties. |
| AnnotationResizeRotateHandlesScale | Gets or sets a factor that is used to scale (enlarge or reduce) the size of the resizing and rotating handles when selecting GdPicture XMP annotations. This value is common for all annotations.
The handles are displayed as visible dots (round marks) respecting both the AnnotationResizeRotateHandlesScale and the AnnotationResizeRotateHandlesColor properties. |
| AnnotationSelectionLineColor | Gets or sets the line color of the line that is used to draw the selection rectangle when selecting GdPicture XMP annotations. This value is common for all annotations.
The annotation selection displays as the rectangle, which borders the annotation, so that the line of this rectangle respects the defined annotation selection line color. |
| AutoSize | (Inherited from System.Windows.Forms.UserControl) |
| AutoSizeMode | (Inherited from System.Windows.Forms.UserControl) |
| AutoValidate | (Inherited from System.Windows.Forms.UserControl) |
| BackColor | Overridden. |
| BorderStyle | (Inherited from System.Windows.Forms.UserControl) |
| CausesValidation | (Inherited from System.Windows.Forms.Control) |
| ClipAnnotsToPageBounds | Specifies if GdPicture/XMP annotations must be clipped to page bounds. Default value is true. |
| ClipRegionsToPageBounds | Specifies if region areas must be clipped to page bounds. Default value is false. |
| ContextMenuStrip | (Inherited from System.Windows.Forms.Control) |
| ContinuousViewMode | Determines whether the GdViewer control display pages in the multipage document continuously one below another when the user scrolls the current page.
This property is designed for viewing multipage documents. That said, be sure you have set the PageDisplayMode property to PageDisplayMode.MultiplePagesView to allow continuous viewing. |
| CurrentPage | Gets the page number of the currently selected and displayed page of the document loaded in the GdViewer control. The pages are numbered starting from 1. |
| Cursor | Overridden. Gets or sets the cursor that is displayed when the mouse pointer is over the control. |
| DataBindings | (Inherited from System.Windows.Forms.Control) |
| DisplayQuality | Specifies the level of displaying quality according to the used algorithm when manipulating with images.
If you turn off the automatic level of displaying quality using the DisplayQualityAuto property, then the previously defined value of this property other than automatic is used. |
| DisplayQualityAuto | Specifies if the level of displaying quality according to the used algorithm when manipulating with images is automatic or not.
If you turn off the automatic level of displaying quality by setting this property to false, the previously defined value of the DisplayQuality property other than automatic is used. |
| DisplayRectangle | (Inherited from System.Windows.Forms.ScrollableControl) |
| Dock | (Inherited from System.Windows.Forms.Control) |
| DocumentAlignment | Gets or sets the default page alignment within the GdViewer control when the area of the control is smaller than the document to be displayed in its current zoom configuration. For example, setting this property to ViewerDocumentAlignment.DocumentAlignmentTopLeft displays the most top-left part of the current page during the zoom-in operation. |
| DocumentFormat | Specifies the format of the current document. |
| DocumentPosition | Gets or sets the default page position within the GdViewer control when the rendering area of the displayed document in its current zoom configuration is smaller than area of the control.
The toolkit only supports ViewerDocumentPosition.DocumentPositionMiddleCenter if the PageDisplayMode property is other than PageDisplayMode.SinglePageView. |
| DrawPageBorders | Specifies if borders are to be drawn around the pages displayed in the GdViewer control, for example, to provide the contrast between the page background and the control background.
You can define the page border's color and its size as well. |
| Enabled | (Inherited from System.Windows.Forms.Control) |
| EnableDeferredPainting | Specifies if page painting is deferred in the GdViewer control.
Displaying large bitmaps or complex vector document pages may cause performance issues. In such situations, it might be useful to use deferred page painting. |
| EnabledProgressBar | Specifies if a progress bar is displayed in the GdViewer control when performing an operation, which raises a progression callback.
Turning this property to true activated the progress bar when loading or saving files using web transfer. If you set this property to false, the progress bar will not display. |
| EnableFuzzySearch | Specifies if fuzzy match is activated during any text search operation. When enabled, a text search operation searches for text that matches a term closely instead of exactly. |
| EnableICM | Specifies whether the GdViewer control uses the color correction technique when manipulating with files that embed an ICC profile.
The ICM stands for Image Color Matching and this technique maps color profiles to allows the color system used by one computer device to match the colors used by other applications and devices. |
| EnableMenu | Enables or disables displaying the contextual menu in the GdViewer control. |
| EnableMouseWheel | Specifies whether the GdViewer control will respond to the mouse wheel event. You can use the MouseWheelMode property to define how the mouse wheel event is handled. |
| EnableTextSelection | Specifies if text selection is enabled in the GdViewer control, that means, for example, also the ability to copy text from the currently displayed page of the text-based document.
The line selection mode is used by default, holding the Alt-key during selection permits you to switch to the column selection mode. |
| Font | (Inherited from System.Windows.Forms.Control) |
| ForceScrollBars | Determines if both scrollbars must always be visible, whatever the zoom configuration is.
Turning this property to true forces the viewer to always display the scrollbars. If you set this property to false, both scrollbars will display according to the ScrollBars property. |
| ForceTemporaryMode | Forces the GdViewer control to use a temporary copy of the file when working (loading, displaying, saving) with your document.
Setting this property to true allows you to overwrite the displayed document, otherwise, the GdPictureStatus.AccessDenied status is returned when saving. Be sure to set this property to the required value before loading the document. Otherwise, it is not taking into account. |
| ForeColor | (Inherited from System.Windows.Forms.Control) |
| Gamma | Specifies the gamma value (gamma encoding), which represents the brightness of the displayed document in the GdViewer control.
Gamma values range from 0.1 to 5.0, usually 0.1 to 2.2. A value less than 1 lightens the image, a value of 1 leaves the image unaffected, and a value greater than 1 darkens the image. |
| HorizontalResolution | Gets the horizontal resolution in DPI (dots per inch) of the current page of the document displayed in the GdViewer control. |
| HQAnnotationRendering | Specifies if annotations are rendered in high quality mode. |
| HScrollVisible | Returns if the horizontal scrollbar is visible, means displayed, or not in the GdViewer control. |
| IgnoreDocumentResolution | Gets or sets whether the GdViewer control will ignore vertical and horizontal resolutions measurement while displaying a document. |
| ImeMode | (Inherited from System.Windows.Forms.Control) |
| KeepDocumentPosition | Specifies whether the GdViewer control will keep the page position when the displayed page changes or when a new document is loaded.
If the PageDisplayMode property is other than PageDisplayMode.SinglePageView, this property must be set to false. |
| Location | (Inherited from System.Windows.Forms.Control) |
| LockViewer | Enables or disables refreshing the GdViewer control.
Turning this property to true avoids refreshing the control. Otherwise, the control will refresh if needed. |
| MagnifierHeight | Gets or sets the height, in pixels, of the magnifier tool used in the GdViever control. You can enable the use of the magnifier tool in your application by setting the MouseMode property to ViewerMouseMode.MouseModeMagnifier. |
| MagnifierWidth | Gets or sets the width, in pixels, of the magnifier tool used in the GdViever control. You can enable the use of the magnifier tool in your application by setting the MouseMode property to ViewerMouseMode.MouseModeMagnifier. |
| MagnifierZoomX | Gets or sets the current horizontal zoom (scale) factor of the magnifier tool used in the GdViewer control. You can enable the use of the magnifier tool in your application by setting the MouseMode property to ViewerMouseMode.MouseModeMagnifier.
Please use the value 1 to define the 100% zoom factor, 1.5 to define 150%, 2 to define the 200% zoom factor, etc. |
| MagnifierZoomY | Gets or sets the current vertical zoom (scale) factor of the magnifier tool used in the GdViewer control. You can enable the use of the magnifier tool in your application by setting the MouseMode property to ViewerMouseMode.MouseModeMagnifier.
Please use the value 1 to define the 100% zoom factor, 1.5 to define 150%, 2 to define the 200% zoom factor, etc. |
| Margin | (Inherited from System.Windows.Forms.Control) |
| MaximumSize | (Inherited from System.Windows.Forms.Control) |
| MinimumSize | (Inherited from System.Windows.Forms.Control) |
| MouseButtonForMouseMode | Gets or sets the mouse button used for the current mouse mode configuration in the GdViewer control. |
| MouseMode | Gets or sets the mouse mode, that is how the mouse is used to manipulate with the displayed document. |
| MouseWheelMode | Gets or sets the mouse wheel mode, that is how the mouse wheel is used to manipulate with the displayed document.
Be aware, that you need to enable the EnableMouseWheel property to properly apply the mouse wheel mode. |
| Padding | (Inherited from System.Windows.Forms.Control) |
| PageBordersColor | Gets or sets the page border color of the page borders, which are drawn around the pages displayed in the GdViewer control. This property is only meanigful when the page borders are enabled using the DrawPageBorders property. |
| PageBordersPenSize | Gets or sets the page border size (the border width), in pixels, of the page borders, which are drawn around the pages displayed in the GdViewer control. This property is only meanigful when the page borders are enabled using the DrawPageBorders property. |
| PageCount | Gets the total number of pages in the document currently displayed in the GdViewer control. |
| PageDisplayMode | Gets or sets the current page display mode of the GdViewer control.
The single page viewing mode displays only one page at a time in the viewer area. The multi page viewing mode displays all pages one after another. |
| PageHeight | Returns the height, in pixels, of the current page of the document displayed in the GdViewer control. |
| PageRenderRotation | Returns the final rendering rotation of the current page of the document displayed in the GdViewer control. It is the sum of the values of the ViewRotation and the PageRotation properties. |
| PageRotation | Returns the rotation and flipping of the current page of the document displayed in the GdViewer control. |
| PageWidth | Returns the width, in pixels, of the current page of the document displayed in the GdViewer control. |
| PdfDisplayFormField | Specifies whether the GdViewer control will render and print form fields and annotations included in the loaded PDF documents. |
| PdfEnableFileLinks | Specifies whether the GdViewer control will automatically navigate to the linked file when a user clicks the associated file link in the displayed PDF document.
PDF documents are often designed to contain links to other files. Such an option is provided through a GoToR action handled by particular objects such as bookmarks or file links. Setting this property to true allows users to navigate to the linked file. Turning this property to false will disable this behaviour. The PdfFileNavigation event is raised before displaying the linked file. |
| PdfEnableLinks | Specifies whether the GdViewer control will follow a hyperlink contained in the displayed PDF document when a user clicks that hyperlink.
Setting this property to true allows users to open web links contained in the loaded PDF documents. Turning this property to false will disable this behaviour. The PdfUriNavigation event is raised before navigating to the specified hyperlink. |
| PdfIncreaseTextContrast | Specifies if the rendering engine should increase text contrast on low zoom to enhance readability. This feature can decrease rendering speed performances on old machines. |
| PdfShowDialogForPassword | Enables or disables the option that allows you to utilize your own dialog box requesting a password if the PDF document to display is protected.
If this property is set to true, the GdViewer control prompts the user automatically with the dialog box to insert the password if the PDF to display is protected. Changing this property to false will force the control to use your own dialog box. Then you will have to catch the PdfPasswordRequest event to display your dialog box for entering the password. |
| PdfShowOpenFileDialogForDecryption | Enables or disables the option that allows you to utilize your own dialog box requesting a certificate file if the PDF document to display is protected.
If this property is set to true, the GdViewer control prompts the user automatically with the dialog box to insert the file if the PDF to display is protected. Changing this property to false will force the control to use your own dialog box. Then you will have to catch the PdfCertificateRequest event to display your dialog box for entering the certificate file. |
| PdfVerifyDigitalCertificates | Specifies if the GdViewer control is responsible to check digital certificate when rendering a PDF document containing a digital signature. Depending on the outcome of the certificate audit, the visible appearance associated with each digital signature contained in the displayed document is adjusted. |
| PreserveViewRotation | Indicates whether the view rotation applied to the pages of the document must be applied to the file produced by the SaveDocumentToTIFF and SaveDocumentToPDF methods. |
| RectBorderColor | Gets or sets the border color of the rectangle of area selection, that is related to the document currently displayed in the GdViewer control. This color is used when drawing the rectangle of selection within the control.
You can find out, if this rectangle is currently defined, using the IsRect method. |
| RectBorderSize | Gets or sets the border size (the border width), in pixels, of the rectangle of area selection, that is related to the document currently displayed in the GdViewer control. This value is used when drawing the rectangle of selection within the control.
You can find out, if this rectangle is currently defined and drawn, using the IsRect method. |
| RectIsEditable | Determines, if the rectangle of area selection can be moved or resized (edited) by a user. You are allowed to edit the rectangle using the mouse when the MouseMode property is set to GdPicture14.ViewerMouseMode.MouseModeAreaSelection.
You can find out, if this rectangle is currently defined and drawn within the GdViewer control, using the IsRect method. The rectangle of selection always relates to the document currently displayed in the GdViewer control. |
| RegionsAreEditable | Determines if highlighted regions can be edited, that means selected, moved or resized by a user.
Highlighted regions for currently displayed document are identified and created when searching text, for example using the SearchText(String,Int32,Boolean) method or the second similar overloaded method as well. You can also define highlighted regions directly using AddRegion(String,Int32,Int32,Int32,Int32,ForegroundMixMode,Int32) or AddRegionInches(String,Single,Single,Single,Single,ForegroundMixMode,Int32) methods. |
| RenderGdPictureAnnots | Specifies whether the GdPicture/XMP annotations, if present, are rendered or not on the document displayed in the GdViewer control. |
| RightToLeft | (Inherited from System.Windows.Forms.Control) |
| ScrollBars | Determines if the scrollbars are enabled, that means whether the scrollbars are to be displayed or not within the GdViewer control.
If this property is set to true, the scrollbars appear when the area to render is larger than the control. Turning this property to false forces both scrollbars to be always invisible, whatever the zoom configuration is. |
| ScrollLargeChange | Gets or sets a value to be added to or subtracted from the current scrollbar position when the scrollbar (both horizontal or vertical) is moved a large distance. |
| ScrollSmallChange | Gets or sets a value to be added to or subtracted from the current scrollbar position when the scrollbar (both horizontal or vertical) is moved a small distance. |
| SilentMode | Indicates, whether error reporting through MessageBox dialogue is disabled or not when loading password-protected or encrypted PDF documents. The MessageBox dialogue will display when a password is needed, when users provide an invalid password or when an encryption error occurs.
Turning this property to false enables error reporting through MessageBox dialogues. If this property is set to true, possible errors are not reported. |
| Site | (Inherited from System.Windows.Forms.Control) |
| Size | (Inherited from System.Windows.Forms.Control) |
| TabIndex | (Inherited from System.Windows.Forms.Control) |
| TabStop | (Inherited from System.Windows.Forms.Control) |
| Tag | (Inherited from System.Windows.Forms.Control) |
| UseWaitCursor | (Inherited from System.Windows.Forms.Control) |
| VerticalResolution | Gets the vertical resolution in DPI (dots per inch) of the current page of the document displayed in the GdViewer control. |
| ViewRotation | Gets or sets the current rotation and flipping of the page view in the GdViewer control.
This property specifies how the view is rotated and flipped in the GdViewer control when displaying the page. |
| Visible | (Inherited from System.Windows.Forms.Control) |
| VScrollVisible | Returns if the vertical scrollbar is visible, means displayed, or not in the GdViewer control. |
| Zoom | Gets or sets the current zoom (magnification) factor, that is applied during the following page rendering operations in the GdViewer control. Please use the value 1 to define the 100% zoom factor, 1.5 to define 150%, 2 to define the 200% zoom factor, etc.
If the newly specified Zoom value is the same as the current Zoom value, this method does nothing. |
| ZoomCenterAtMousePosition | Specifies if the document displayed in the GdViewer control is centered to the currently defined mouse position when performing any zoom action. |
| ZoomMax | Gets the highest zoom factor (maximal zoom) which can be used for the document displayed in the GdViewer control. The value of 1 represents the 100% zoom factor, 1.5 represents 150%, 2 represents the 200% zoom factor, etc. |
| ZoomMode | Gets or sets the current zoom mode used by the GdViewer control and refreshes the control as well.
If the newly specified ZoomMode value is the same as the current ZoomMode value, this method does nothing. |
| ZoomStep | Gets or sets the zoom step, that specifies the percentage of increasing or decreasing the current zoom factor when using the ZoomIN and the ZoomOUT methods. The value of 25 represents the 25% step, the value of 10 represents the 10% step, etc. |
In This Topic
GdViewer Class Properties
In This Topic
For a list of all members of this type, see GdViewer members.
Public Properties
See Also