JamControls.TJamThumbnailImage

The TJamThumbnailImage component allows you to show a thumbnail preview of a file or folder.

Syntax

Pascal

TJamThumbnailImage = class(TCustomJamImageFromImageList, IJamShellControl, IThumbnailViewer);

Remarks

Use this component to display a thumbnail image of a file or folder. The same thumbnail image that the Windows Explorer uses will be shown. The Windows Shell does not supply a thumbnail image for all objects.

You may either set the Path property to set a path to a file or folder for which the thumbnail image should be displayed. Or you may synchronize it to a TJamShellList or TJamShellTree component using the ShellLink property.

See Also

TJamShellList.Thumbnails

TJamFileList.Thumbnails

Namespace

JamControls

Public Methods

	Name	Description
	constructor Create(aOwner: TComponent); override;	Creates and intializes an instance of this component.

JamControls.TJamThumbnailImage

	Name	Description
	constructor Create(AOwner: TComponent); override;	Creates an instance of a TJamThumbnailImage component
	destructor Destroy; override;	Destroys an instance of a TJamThumbnailImage component

IJamShellControl Methods

ShellLink.IJamShellControl

	Name	Description
	procedure FileChanged(FolderPIDL: IItemIdList; FilePIDL: IItemIdList);	This method is called by the ShellLink instance if the currently selected item has changed.
	function getShellLink: TJamShellLink;	Getter method for the ShellLink property.
	function GoUp: Boolean;	This method indicates that the callee should go up one level and display the contents of the current folder's parent folder.
	procedure PathChanged(FolderPIDL: IItemIdList);	This method is called by the ShellLink instance if the currently displayed folder has changed.
	procedure Refresh(pRefreshLevel: TRefreshLevel; pItemIdList: IItemIdList = nil);	This method indicates that the control should perform a refresh of its contents.
	procedure SelectAll;	This method indicates that the callee should select all item it currently displays.
	procedure setShellLink(aValue: TJamShellLink);	Setter method for the ShellLink property.

JamControls.TJamThumbnailImage

	Name	Description
	procedure Clear;
	function IsEmpty: boolean;	This method indicates that the control doesn't contain a picture, e.g. when cref="IconInstead" is set to false and no proper thumbnail is contained in the image
	procedure Refresh(pRefreshLevel: TRefreshLevel; pItemIdList: IItemIdList = nil);	This method indicates that the control should perform a refresh of its contents.

TCustomJamImageFromImageList Properties

	Name	Description
	property Align;	See TCustomPanel.Align
	property Anchors;	See TCustomPanel.Anchors
	property BevelInner default bvNone;	See TCustomPanel.BevelInner
	property BevelOuter default bvNone;	See TCustomPanel.BevelOuter
	property BorderStyle: TBorderStyle read FBorderStyle write SetBorderStyle default bsNone;	See TCustomPanel.BorderStyle
	property BorderWidth: TBorderWidth read FBorderWidth write SetBorderWidth default 0;	See TCustomPanel.BorderWidth
	property Color;	See TCustomPanel.Color
	property OnClick;	See TControl.OnClick
	property OnDblClick;	See TControl.OnDblClick
	property OnEnter;	Occurs when a control receives the input focus.
	property OnExit;	Occurs when the input focus shifts away from one control to another.
	property OnKeyDown;	Occurs when a user presses any key while the control has focus.
	property ParentBackground default False;	See TCustomPanel.ParentBackground
	property ParentColor default True;	See TCustomPanel.ParentColor
	property Version: String read GetVersion stored false;	The version number of the ShellBrower controls.
	property Visible;	Determines whether the component appears on screen.

ShellLink.IJamShellControl

	Name	Description
	property ShellLink: TJamShellLink read getShellLink write setShellLink;	The TJamShellLink instance to which the current control connected.

JamControls.TJamThumbnailImage

	Name	Description
	property AbsoluteItemIdList: IItemIdList read GetAbsoluteItemIdList write SetAbsoluteItemIdList;	The absolute IItemIdList of the displayed file.
	property AutoSize;	Specifies whether the control sizes itself automatically to accommodate its contents.
	property BevelInner;	Specifies the cut of the inner bevel.
	property BevelOuter;	Specifies the cut of the outer bevel.
	property BevelWidth;	Determines the width, in pixels, of both the inner and outer bevels of a panel.
	property BorderStyle;	Determines whether the list view displays a single line border.
	property BorderWidth;	Specifies the distance, in pixels, between the outer and inner bevels.
	property CenterVertically;	If set to True (the default value), the thumbnail will be displayed vertically centered. If False, it will be aligned on top.
	property Color;	Specifies the background color of the control.
	property Constraints;	Specifies the size constraints for the control.
	property DoubleBuffered default True;	Determines whether the control's image is rendered directly to the window or painted to an in-memory bitmap first.
	property DragCursor;	Specifies the image used to represent the mouse pointer when the control is being dragged.
	property DragKind;	Specifies whether the control is being dragged normally or for docking.
	property DragMode;	Specifies how the control initiates drag-and-drop or drag-and-dock operations.
	property Enabled: Boolean read JamGetEnabled write JamSetEnabled default true;	Enables or disables the thumbnail image.
	property IconInstead: Boolean read fIconInstead write fIconInstead default True;	Decides if an icon should be shown if there is no thumbnail.
	property OnCanResize;	Occurs when an attempt is made to resize the control.
	property OnClick;	Occurs when the user clicks the control.
	property OnContextPopup;	Occurs when the user right-clicks the control or otherwise invokes the pop-up menu (such as using the keyboard).
	property OnDblClick;	Occurs when the user double-clicks the left mouse button when the mouse pointer is over the control.
	property OnDragDrop;	Occurs when the user drops an object being dragged.
	property OnDragOver;	Occurs when the user drags an object over a control.
	property OnEndDock;	Occurs when the dragging of an object ends, either by docking the object or by canceling the dragging.
	property OnEndDrag;	Occurs when the dragging of an object ends, either by dropping the object or by canceling the dragging.
	property OnMouseDown;	Occurs when the user presses a mouse button with the mouse pointer over a control.
	property OnMouseMove;	Occurs when the user moves the mouse pointer while the mouse pointer is over a control.
	property OnMouseUp;	Occurs when the user releases a mouse button that was pressed with the mouse pointer over a component.
	property OnProgress: TProgressEvent read fOnProgress write fOnProgress;	Occurs periodically during slow operations that affect the image.
	property OnStartDock;	Occurs when the user begins to drag a control with a DragKind of dkDock.
	property OnStartDrag;	Occurs when the user begins to drag the control or an object it contains by left-clicking the control and holding the mouse button down.
	property ParentColor;	Specifies where a control looks for its color information.
	property ParentDoubleBuffered default False;	ParentDoubleBuffered defers the DoubleBuffered property of this component to the value of the parent's DoubleBuffered property.
	property ParentShowHint;	Specifies where a control looks to find out if its Help Hint should be shown.
	property Path: UnicodeString read GetPath write SetPath;	Set the path of the object that should be displayed as thumbnail.
	property Picture: TPicture read GetPicture;	Use this property to access the thumbnail image.
	property PopupMenu;	Specifies the pop-up menu associated with the control.
	property ShellLink: TJamShellLink read getShellLink write setShellLink;	Connects this component to a TJamShellLink in order to synchronize it to other shell controls.
	property ShowErrorMessages: Boolean read getShowErrorMessages write setShowErrorMessages default false;	Allow Windows error messages.
	property ShowHint;	Specifies whether to show the Help Hint when the mouse pointer moves over the control.
	property StyleElements;	Specifies the style elements that are used by the control.
	property StyleName;	Specifies the style name for this control.
	property Version: String read GetVersion stored false;	The version number of the ShellBrower controls.
	property Visible;	Determines whether the component appears onscreen.

Links

JamControls, Legend, Members, Public Methods, IJamShellControl Methods, TCustomJamImageFromImageList Properties, See Also

Contents | Index | Home