KimTools / Controls / PictureBox
Kt PictureBox
A modern, customizable PictureBox control supporting rounded corners, custom border styles, image filters, and dynamic gradient/brush masking.
🟢 DESIGNER SUPPORT
This control has full Visual Studio design-time support.
Drag it from the Toolbox onto your form, customize its properties directly in the Properties window, and KimTools will generate the corresponding code for you.
Gradient Brushes & Alpha Filtering (ImageBrush)
Assign a KtBrush alongside Image = Image.FromFile("logo.png") to act as an alpha filter or mask overlay. Expressions support implicit tuple conversions (start, stop, angle) and opacity modifiers (%).
🔴 🟡 🟢
var panel = new FlowLayoutPanel
{
Width = 340,
Height = 170,
Padding = new Padding(10),
BackColor = Color.Transparent,
AutoScroll = false
};
var sampleImage = Image.FromFile("../logo.png");
// Angled gradient mask overlay on image using 3-tuple (Start, Stop, Angle)
var gradientPic = new KtPictureBox
{
Width = 150,
Height = 150,
Margin = new Padding(5),
BorderRadius = 10f,
Image = sampleImage,
ImageBrush = (KtColor.PRIMARY % 50, KtColor.ACCENT % 50, 45)
};
// Subtle translucent tint filter on image using 2-tuple + opacity operator (%)
var glassPic = new KtPictureBox
{
Width = 150,
Height = 150,
Margin = new Padding(5),
BorderRadius = 10f,
Image = sampleImage,
ImageBrush = (KtColor.SUCCESS % 30, KtColor.INFO % 30)
};
panel.Controls.Add(gradientPic);
panel.Controls.Add(glassPic);
Auto
Light
Dark
Border Radius
Specify pixel values or fractional values (e.g., 0.5f for a capsule/pill shape) on BorderRadius to automatically mask both the image and the applied brush layer.
🔴 🟡 🟢
var panel = new FlowLayoutPanel
{
Width = 340,
Height = 170,
Padding = new Padding(10),
BackColor = Color.Transparent,
AutoScroll = false
};
var sampleImage = Image.FromFile("../logo.png");
var subtleRound = new KtPictureBox
{
Width = 150,
Height = 150,
Margin = new Padding(5),
BorderRadius = 12f,
Image = sampleImage,
ImageBrush = (KtColor.INFO % 40, KtColor.PRIMARY % 40)
};
var fullPill = new KtPictureBox
{
Width = 150,
Height = 150,
Margin = new Padding(5),
BorderRadius = 0.5f, // Fractional radius creates a circle shape for square control
Image = sampleImage,
ImageBrush = (KtColor.Purple % 40, KtColor.Pink % 40)
};
panel.Controls.Add(subtleRound);
panel.Controls.Add(fullPill);
Auto
Light
Dark
