| Name | Description | |
|---|---|---|
 | ThumbnailEx Constructor |
ThumbnailEx Class Members
In This Topic
The following tables list the members exposed by ThumbnailEx.
Public Constructors
Public Properties
| Name | Description | |
|---|---|---|
 | AccessibleDescription | (Inherited from System.Windows.Forms.Control) |
| AccessibleName | (Inherited from System.Windows.Forms.Control) |
| AccessibleRole | (Inherited from System.Windows.Forms.Control) |
| AllItemsLoaded | Returns true if all items have been loaded, else false. |
| AllowDrop | (Inherited from System.Windows.Forms.Control) |
| AllowDropFiles | Specifies if the user is able to drop files from the explorer to the control. User will be allowed to drop files only if the items of the control has been loaded using LoadFromDirectory or if the control is empty. Default value is false. |
| AllowMoveItems | Specifies if the user is able to mode items by dragging operation. The event ItemMoved is raised for each item moving. Default value is false. |
| Anchor | (Inherited from System.Windows.Forms.Control) |
| AutoScroll | (Inherited from System.Windows.Forms.ScrollableControl) |
| AutoScrollMargin | (Inherited from System.Windows.Forms.ScrollableControl) |
| AutoScrollMinSize | (Inherited from System.Windows.Forms.ScrollableControl) |
| AutoSize | (Inherited from System.Windows.Forms.UserControl) |
| AutoSizeMode | (Inherited from System.Windows.Forms.UserControl) |
| AutoValidate | (Inherited from System.Windows.Forms.UserControl) |
| BackColor | Overridden. Gets or sets the background color for the control. |
| BackgroundImage | (Inherited from System.Windows.Forms.Control) |
| BackgroundImageLayout | (Inherited from System.Windows.Forms.Control) |
| BorderStyle | (Inherited from System.Windows.Forms.UserControl) |
| CausesValidation | (Inherited from System.Windows.Forms.Control) |
| CheckBoxes | Specifies if a check box appears next each item in the ThumbnailEx control. Default value is false. |
| CheckBoxesMarginLeft | Defines custom checkboxes left margin. Negative margin is allowed. Default value is 0. |
| CheckBoxesMarginTop | Defines custom checkboxes top margin. Negative margin is allowed. Default value is 0. |
| ContextMenuStrip | (Inherited from System.Windows.Forms.Control) |
| Cursor | (Inherited from System.Windows.Forms.Control) |
| DataBindings | (Inherited from System.Windows.Forms.Control) |
| DefaultItemCheckState | Specifies the default check state for subsequently generated items. Default value is false (not checked). |
| DefaultItemTextPrefix | Specifies the prefix used by default to generate the item text. Default value is empty string. |
| DisplayAnnotations | Specifies if annotations are displayed in each thumbnail. True by default. Annotations can be GdPicture/XMP annotations, PDF annotations and PDF FormFields. Default value is true. |
| DisplayRectangle | (Inherited from System.Windows.Forms.ScrollableControl) |
| Dock | (Inherited from System.Windows.Forms.Control) |
| Enabled | (Inherited from System.Windows.Forms.Control) |
| EnableDropShadow | Determines whether thumbnails are rendered with a very light and gentle drop shadow effect on the screen. This feature is not compatible with thumbnail borders. To activate it, switch the ThumbnailBorder property to False. Default value is true. |
| Font | (Inherited from System.Windows.Forms.Control) |
| ForeColor | (Inherited from System.Windows.Forms.Control) |
| HorizontalTextAlignment | Defines the horizontal alignment of the text of each thumbnail. Default value is StringAlignment.Center. |
| HotTracking | Specifies if an item has appearance of a hyperlink when the mouse pointer passes over it. Default value is false. |
| ImeMode | (Inherited from System.Windows.Forms.Control) |
| ItemCount | The number of items in the control. Read only. |
| Location | (Inherited from System.Windows.Forms.Control) |
| LockGdViewerEvents | Specifies if the ThumbnailEx control is reactive to the GdViewer events. This property is available only when thumbnails source is a GdViewer object passed to the LoadFromGdViewer method. Default value is false. |
| Margin | (Inherited from System.Windows.Forms.Control) |
| MaximumSize | (Inherited from System.Windows.Forms.Control) |
| MinimumSize | (Inherited from System.Windows.Forms.Control) |
| MultiSelect | Specifies if multiple items can be selected. Default value is false. |
| OwnDrop | Turn this property to True to implement your own drag and drop support. Default value is false. |
| Padding | (Inherited from System.Windows.Forms.Control) |
| PauseThumbsLoading | Turn this property to True to pause the background process generating thumbnails. Default value is false. |
| PdfIncreaseTextContrast | Specifies if the rendering engine should increase text contrast on low zoom in order to enhance readability. This feature can decrease rendering speed performances on old machines. Default value is false. |
| PreloadAllItems | Specifies if all items must be generated in background. If False, only visible items will be generated. False is recommended if the number of items exceed 1000. Default value is true. |
| RightToLeft | (Inherited from System.Windows.Forms.Control) |
| RotateExif | Specifies if each item must be rotated according to Exif Orientation tag, if any. Default value is true. |
| SelectedThumbnailBackColor | Defines the highlighting color of selected thumbnails. |
| SelectedThumbnailBackColorAlpha | Defines the alpha value of the highlighting color of selected thumbnails. Default value is 100. Valid values are in the range [0: fully transparent ; 255: fully opaque]. |
| ShowText | Specifies if a text is displayed near each thumbnail. Default value is true. |
| 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) |
| TextMarginLeft | Defines custom text left margin. Negative margin is allowed. Default value is 0. |
| TextMarginTop | Defines custom text top margin. Negative margin is allowed. Default value is 0. |
| ThumbnailAlignment | Defines alignment of thumbnails in the control. Default value is ThumbnailAlignment.ThumbnailAlignmentVertical. |
| ThumbnailBackColor | Specifies the default background color of thumbnails. Default color is Transparent. |
| ThumbnailBorder | Specifies if thumbnails have border appearance. This feature is not compatible with drop shadow. To activate it, switch the EnableDropShadow property to False. Default value is false. |
| ThumbnailForeColor | Specifies the default foreground color of thumbnails. Default color is Black. |
| ThumbnailSize | The size, in pixel, of each thumbnail. Default value is (128, 128). |
| ThumbnailSpacing | Sets the spacing between each thumbnail in the control. Set a size of (0, 0) to apply automatic spacing, otherwise a size larger than ThumbnailSize is suggested. Default value is (0, 0). |
| UseWaitCursor | (Inherited from System.Windows.Forms.Control) |
| VerticalTextAlignment | Defines the vertical alignment of the text of each thumbnail. Default value is StringAlignment.Center. |
| Visible | (Inherited from System.Windows.Forms.Control) |
Public Methods
| Name | Description | |
|---|---|---|
 | AddItemFromFile | Adds a new thumbnail to the list from a file. |
| AddItemFromGdPictureImage | Overloaded. Adds a new thumbnail to the list from a GdPicture Image. |
| AddItemFromStream | Overloaded. Adds a new thumbnail to the list from a file. |
| AttachGdViewer | |
| BeginInvoke | Overloaded. (Inherited from System.Windows.Forms.Control) |
| BringToFront | (Inherited from System.Windows.Forms.Control) |
| ClearAllItems | Reset the control and clear all generated thumbnails. |
| Contains | (Inherited from System.Windows.Forms.Control) |
| CreateControl | (Inherited from System.Windows.Forms.Control) |
| CreateGraphics | (Inherited from System.Windows.Forms.Control) |
| CreateObjRef | (Inherited from System.MarshalByRefObject) |
| Dispose | |
| DoDragDrop | (Inherited from System.Windows.Forms.Control) |
| DrawToBitmap | (Inherited from System.Windows.Forms.Control) |
| EndInvoke | (Inherited from System.Windows.Forms.Control) |
| EnsureVisibleItem | Ensures that the specified item is visible within the control, scrolling the contents of the control if necessary. |
| FindForm | (Inherited from System.Windows.Forms.Control) |
| FindNearestItem | Returns the index of the nearest item at the given location, searching in the specified direction. |
| Focus | (Inherited from System.Windows.Forms.Control) |
| GetChildAtPoint | Overloaded. (Inherited from System.Windows.Forms.Control) |
| GetContainerControl | (Inherited from System.Windows.Forms.Control) |
| GetItemAt | Returns the index of the item at the specified location. |
| GetItemBitmap | Gets the bitmap of a specific item in the thumbnail list. |
| GetItemCheckState | Returns the check state (if checked or not) of a specific item in the thumbnail list. |
| GetItemFileSource | Returns the file path of the item source in case the control has been loaded from a folder source by the LoadFromDirectory() method. |
| GetItemFocusState | Returns the focus state (if focused or not) of a specific item in the thumbnail list. |
| GetItemSelectState | Returns the select state (if selected or not) of a specific item in the thumbnail list. |
| GetItemTag | Gets the tag object associated with a specific item in the thumbnail list. |
| GetItemText | Gets the text of a specific item in the thumbnail list. |
| GetLifetimeService | (Inherited from System.MarshalByRefObject) |
| GetNextControl | (Inherited from System.Windows.Forms.Control) |
| GetPreferredSize | (Inherited from System.Windows.Forms.Control) |
| Hide | (Inherited from System.Windows.Forms.Control) |
| InitializeLifetimeService | (Inherited from System.MarshalByRefObject) |
| InsertItemFromFile | Adds a new thumbnail to the list from a file. |
| InsertItemFromGdPictureImage | Inserts a new thumbnail to the list from a GdPicture Image. |
| InsertItemFromStream | Inserts a new thumbnail to the list from a Stream. |
| Invalidate | Overloaded. (Inherited from System.Windows.Forms.Control) |
| Invoke | Overloaded. (Inherited from System.Windows.Forms.Control) |
| LoadAllItems | Forces the control to render all items (visible and not visibles) synchronously. |
| LoadFromDirectory | Overloaded. Load thumbnails from directory. The ThumbnailEx control will generate a thumbnail for each image or PDF document found in the directory. Thumbnails will be generated asynchronously. |
| LoadFromFiles | Load thumbnails from an array of files. Thumbnails will be generated asynchronously. |
| LoadFromGdPictureImage | Load thumbnails from a GdPicture Image. If the GdPicture image is a multipage image, the ThumbnailEx control will generate a thumbnail for each page. Thumbnails will be created asynchronously. |
| LoadFromGdPicturePDF | Load thumbnails from PDF document loaded by a GdPictureImaging object. The ThumbnailEx control will generate a thumbnail for each page in the document. Thumbnails will be created asynchronously. |
| LoadFromGdViewer | Load thumbnails from a GdViewer object. If the GdViewer object handles a multipage document, the ThumbnailEx control will generate a thumbnail for each page. Thumbnails will be created asynchronously. |
| LoadNewThumbnails | Overloaded. Adds to the control items which have been appended to the source after the latest loading operation. Works only when source is a GdViewer object, GdPicture image or GdPicturePDF object. New thumbnails will be generated asynchronously. |
| LogicalToDeviceUnits | Overloaded. (Inherited from System.Windows.Forms.Control) |
| MoveItem | Moves an item in the thumbnail list. |
| PerformAutoScale | (Inherited from System.Windows.Forms.ContainerControl) |
| PerformLayout | Overloaded. (Inherited from System.Windows.Forms.Control) |
| PointToClient | (Inherited from System.Windows.Forms.Control) |
| PointToScreen | (Inherited from System.Windows.Forms.Control) |
| PreProcessControlMessage | (Inherited from System.Windows.Forms.Control) |
| PreProcessMessage | (Inherited from System.Windows.Forms.Control) |
| RectangleToClient | (Inherited from System.Windows.Forms.Control) |
| RectangleToScreen | (Inherited from System.Windows.Forms.Control) |
| RedrawItem | Redraws a specific item in the thumbnail list. |
| Refresh | (Inherited from System.Windows.Forms.Control) |
| ReleaseGdPictureImage | Deletes a GdPicture Image from the memory. |
| ReloadThumbnails | Clear the ThumbnailEx control then reload all thumbnails. |
| RemoveItem | Removes a specific item in the thumbnail list. |
| ResetText | (Inherited from System.Windows.Forms.Control) |
| ResumeLayout | Overloaded. (Inherited from System.Windows.Forms.Control) |
| Scale | (Inherited from System.Windows.Forms.Control) |
| ScaleBitmapLogicalToDevice | (Inherited from System.Windows.Forms.Control) |
| ScrollControlIntoView | (Inherited from System.Windows.Forms.ScrollableControl) |
| Select | (Inherited from System.Windows.Forms.Control) |
| SelectItem | Selects and set the focus to a specific item in the thumbnail list. |
| SelectNextControl | (Inherited from System.Windows.Forms.Control) |
| SendToBack | (Inherited from System.Windows.Forms.Control) |
| SetAutoScrollMargin | (Inherited from System.Windows.Forms.ScrollableControl) |
| SetBounds | Overloaded. (Inherited from System.Windows.Forms.Control) |
| SetItemBackgroundColor | Changes the background color of a specific item in the thumbnail list. |
| SetItemBitmap | Overloaded. Changes the bitmap of a specific item in the thumbnail list, from a GdPicture Image. |
| SetItemCheckState | Changes the check state (if checked or not) of a specific item in the thumbnail list. |
| SetItemSelectState | Changes the select state (if selected or not) of a specific item in the thumbnail list. |
| SetItemsFont | Change the font used to render the text of all items. |
| SetItemsSize | Change the size, in pixel, of each item. |
| SetItemsSpacing | Change the spacing between each item. |
| SetItemTag | Changes the tag object associated with a specific item in the thumbnail list. |
| SetItemText | Changes the text of a specific item in the thumbnail list. |
| SetItemToolTipText | Changes the tooltip of a specific item in the thumbnail list. |
| Show | (Inherited from System.Windows.Forms.Control) |
| SuspendLayout | (Inherited from System.Windows.Forms.Control) |
| SwapItemsBitmap | Overloaded. Swap two items bitmap in the thumbnail list. |
| ToString | (Inherited from System.ComponentModel.Component) |
| UnselectAllItems | Unselects all selected items. |
| Update | (Inherited from System.Windows.Forms.Control) |
| Validate | Overloaded. (Inherited from System.Windows.Forms.ContainerControl) |
| ValidateChildren | Overloaded. (Inherited from System.Windows.Forms.UserControl) |
Public Events
| Name | Description | |
|---|---|---|
 | AutoSizeChanged | (Inherited from System.Windows.Forms.UserControl) |
| AutoValidateChanged | (Inherited from System.Windows.Forms.UserControl) |
| BackColorChanged | (Inherited from System.Windows.Forms.Control) |
| BackgroundImageChanged | (Inherited from System.Windows.Forms.Control) |
| BackgroundImageLayoutChanged | (Inherited from System.Windows.Forms.Control) |
| BindingContextChanged | (Inherited from System.Windows.Forms.Control) |
| CausesValidationChanged | (Inherited from System.Windows.Forms.Control) |
| ChangeUICues | (Inherited from System.Windows.Forms.Control) |
| Click | |
| ClientSizeChanged | (Inherited from System.Windows.Forms.Control) |
| ContextMenuStripChanged | (Inherited from System.Windows.Forms.Control) |
| ControlAdded | (Inherited from System.Windows.Forms.Control) |
| ControlRemoved | (Inherited from System.Windows.Forms.Control) |
| CursorChanged | (Inherited from System.Windows.Forms.Control) |
| DockChanged | (Inherited from System.Windows.Forms.Control) |
| DoubleClick | |
| DpiChangedAfterParent | (Inherited from System.Windows.Forms.Control) |
| DpiChangedBeforeParent | (Inherited from System.Windows.Forms.Control) |
| DragDrop | (Inherited from System.Windows.Forms.Control) |
| DragEnter | (Inherited from System.Windows.Forms.Control) |
| DragLeave | (Inherited from System.Windows.Forms.Control) |
| DragOver | (Inherited from System.Windows.Forms.Control) |
| EnabledChanged | (Inherited from System.Windows.Forms.Control) |
| Enter | (Inherited from System.Windows.Forms.Control) |
| FileTypeNotSupported | |
| FontChanged | (Inherited from System.Windows.Forms.Control) |
| ForeColorChanged | (Inherited from System.Windows.Forms.Control) |
| GiveFeedback | (Inherited from System.Windows.Forms.Control) |
| HelpRequested | (Inherited from System.Windows.Forms.Control) |
| ImeModeChanged | (Inherited from System.Windows.Forms.Control) |
| ItemChecked | Occurs when the check state of a thumbnail changes. |
| ItemClicked | |
| ItemDoubleClicked | |
| ItemMoved | |
| ItemSelectionChanged | |
| KeyDown | |
| KeyPress | |
| KeyUp | |
| Layout | (Inherited from System.Windows.Forms.Control) |
| Leave | (Inherited from System.Windows.Forms.Control) |
| Load | (Inherited from System.Windows.Forms.UserControl) |
| LocationChanged | (Inherited from System.Windows.Forms.Control) |
| MarginChanged | (Inherited from System.Windows.Forms.Control) |
| MouseCaptureChanged | (Inherited from System.Windows.Forms.Control) |
| MouseClick | (Inherited from System.Windows.Forms.Control) |
| MouseDoubleClick | (Inherited from System.Windows.Forms.Control) |
| MouseDown | |
| MouseEnter | |
| MouseHover | |
| MouseLeave | |
| MouseMove | |
| MouseUp | |
| MouseWheel | |
| Move | (Inherited from System.Windows.Forms.Control) |
| OnAllItemsLoaded | |
| PaddingChanged | (Inherited from System.Windows.Forms.Control) |
| Paint | (Inherited from System.Windows.Forms.Control) |
| ParentChanged | (Inherited from System.Windows.Forms.Control) |
| PreviewKeyDown | (Inherited from System.Windows.Forms.Control) |
| QueryAccessibilityHelp | (Inherited from System.Windows.Forms.Control) |
| QueryContinueDrag | (Inherited from System.Windows.Forms.Control) |
| RegionChanged | (Inherited from System.Windows.Forms.Control) |
| Resize | (Inherited from System.Windows.Forms.Control) |
| RightToLeftChanged | (Inherited from System.Windows.Forms.Control) |
| Scroll | |
| SizeChanged | (Inherited from System.Windows.Forms.Control) |
| StyleChanged | (Inherited from System.Windows.Forms.Control) |
| SystemColorsChanged | (Inherited from System.Windows.Forms.Control) |
| TabIndexChanged | (Inherited from System.Windows.Forms.Control) |
| TabStopChanged | (Inherited from System.Windows.Forms.Control) |
| Validated | (Inherited from System.Windows.Forms.Control) |
| Validating | (Inherited from System.Windows.Forms.Control) |
| VisibleChanged | (Inherited from System.Windows.Forms.Control) |
See Also