UltraPictureBox Class

Control for rendering a single image.
Public Class UltraPictureBox 
   Inherits Infragistics.Win.UltraControlBase
   Implements Infragistics.Win.AppStyling.ISupportAppStyling, Infragistics.Win.IProvidesEmbeddableEditor, Infragistics.Win.IUltraControl, Infragistics.Win.IUltraControlElement, Infragistics.Win.Touch.ISupportTouchMetrics, Infragistics.Win.UIAutomation.IProvideUIAutomation 
public class UltraPictureBox : Infragistics.Win.UltraControlBase, Infragistics.Win.AppStyling.ISupportAppStyling, Infragistics.Win.IProvidesEmbeddableEditor, Infragistics.Win.IUltraControl, Infragistics.Win.IUltraControlElement, Infragistics.Win.Touch.ISupportTouchMetrics, Infragistics.Win.UIAutomation.IProvideUIAutomation  

The UltraPictureBox is designed to display a single image. The Image property is used to assign the image to be displayed - this property may be bound. When the Image property is set, the ImageChanged event is invoked.

By default, the Image is only scaled when the image size exceeds the size of the control. This can be changed using the ScaleImage property. By default, the image will be centered within the control but this may be changed by changing the Infragistics.Win.AppearanceBase.ImageHAlign and Infragistics.Win.AppearanceBase.ImageVAlign of the Appearance property.

The control includes the ability to draw a drop shadow below the image. To enable the shadow, set the DrawBorderShadow to true. The color of the shadow can be controlled using the BorderShadowColor while the size may be control using the BorderShadowDepth.

By default, the control is rendered without a border. A border may be assigned using the BorderStyle property. The colors used by the border are based on the Infragistics.Win.Appearance.BorderColor (for single pixel borders) and Infragistics.Win.Appearance.BorderColor3DBase for 3d borders. These properties can be changed using the Appearance property.

Note While the Appearance object has an Image property, setting this property will have no effect. To change the image that is displayed, use the Image property of the control.


Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

See Also