TImage class

In unit ExtCtrls

Implements a graphic image placed on a form, and usually loaded from a picture file.

Declaration

pascal

TImage = class(TCustomImage)

Inheritance

Description

TImage is a TCustomImage descendent which implements a lightweight and fast class used to display a graphic image using one of the image formats supported in the LCL. This includes:

Bitmap
Pixmap
PNG
JPEG
GIF
TIFF
Icon

Use the Picture property to assign, load or save an image using one of the supported formats.

Use the Canvas property to render the graphic image in Picture, or to perform custom drawing operations.

Use properties in the class instance to control how the image is rendered, including: AntialiasingMode, Center, Stretch, Transparent, and Proportional.

TImage inherits most of its properties from its ancestors, TCustomImage, TGraphicControl and TControl

Use TImageList when a list of images with scaling capabilities is needed.

Properties

`AntialiasingMode`	published	Indicates if anti-aliasing is used when rendering the image.
`Align`	published	Specifies the placement of the control on its Parent control.
`Anchors`	published	The set of anchor definitions for this control.
`AutoSize`	published	Allows automatic adjustment of the size for the control, according to its content.
`BorderSpacing`	published	Determines the inner and outer border spacing for this control.
`Center`	published	Indicates if the image should be centered.
`KeepOriginXWhenClipped`	published	Preserves the Left coordinate when a clipped image is centered.
`KeepOriginYWhenClipped`	published	Preserves the Top coordinate when a clipped image is centered.
`Constraints`	published	Contains the minimum and maximum Width and Height for the control.
`DragCursor`	published	The cursor shape shown during a drag operation.
`DragMode`	published	Determines how a drag operation is started for the control.
`Enabled`	published	Determines whether the control responds to mouse or keyboard input.
`ImageIndex`	published
`ImageWidth`	published
`Images`	published
`ParentShowHint`	published	If True, the value of ShowHint for the control will be the same as the one from the Parent. Default is True.
`Picture`	published	Contains the image displayed in the control.
`PopupMenu`	published	A context-sensitive menu that pops up when the right mouse button is clicked over this control.
`Proportional`	published	True if image is proportional.
`ShowHint`	published	Enables Hint display for the control.
`Stretch`	published	Indicates if the image is resized to the client area for the control.
`StretchOutEnabled`	published	Allows the image to be resized proportionally when the image drawing area is expanded.
`StretchInEnabled`	published	Allows the image to be resized proportionally when the image drawing area is shrunk.
`Transparent`	published	Indicates if the image has a clear, non-opaque background.
`Visible`	published	Allows the control, and all of its children, to be displayed or hidden.

Events

`OnChangeBounds`	published	Event handler signalled when the Bounds for the control have been changed.
`OnClick`	published	Notification handler for mouse clicks.
`OnContextPopup`	published	Invoked when a context-sensitive pop-up menu is requested.
`OnDblClick`	published	Event handler signalled when a mouse double click occurs in the control.
`OnDragDrop`	published	Event handler signalled when an object is dropped onto the control.
`OnDragOver`	published	Event handler signalled when a control is dragged over the control instance.
`OnEndDrag`	published	Event handler signalled for the end of a drag-drop operation.
`OnMouseDown`	published	Event handler signalled when a mouse down event is handled for the control.
`OnMouseEnter`	published	Event handler signalled when the mouse pointer has entered the control.
`OnMouseLeave`	published	Event handler signalled when the mouse pointer has left the control.
`OnMouseMove`	published	Event handler signalled when the mouse pointer is moved in the control.
`OnMouseUp`	published	Event handler signalled when a mouse up event is handled for the control.
`OnMouseWheel`	published	Event handler for mouse wheel turned.
`OnMouseWheelDown`	published	Event handler signalled for a downward movement of the mouse wheel.
`OnMouseWheelUp`	published	Event handler signalled for an upward movement of the mouse wheel.
`OnMouseWheelHorz`	published	Event handler signalled for a horizontal movement of the mouse wheel.
`OnMouseWheelLeft`	published	Event handler signalled for a leftward movement of the mouse wheel.
`OnMouseWheelRight`	published	Event handler signalled for a rightward movement of the mouse wheel.
`OnPaint`	published	Event handler signalled to paint the control.
`OnPictureChanged`	published	Event handler signalled when Picture is changed.
`OnPaintBackground`	published	Event handler signalled to draw the background for the image.
`OnResize`	published	Notification handler for a resize of the control.
`OnStartDrag`	published	Event handler signalled for the start of a dragging operation.