BeepCircularButton
Fully circular button with image support, configurable text positioning, and color-set mode
Overview
BeepCircularButton renders a fully circular button with optional image and text. Supports text positioning relative to the circle (Top, Bottom, Left, Right, None), a color-set mode for palette pickers, and full theme integration.
Namespace: TheTechIdea.Beep.Winform.Controls
Inheritance: BaseControl → BeepCircularButton
Properties
| Property | Type | Default | Description |
|---|---|---|---|
ImagePath | string | "" | Path to the image displayed inside the circle. |
TextFont | Font | theme | Font for the button text. |
TextLocation | TextLocation | Bottom | Where text appears: Top, Bottom, Left, Right, or None. |
TextAlign | ContentAlignment | Center | Alignment of text relative to its position. |
HideText | bool | false | Hides the text, showing only the circle+image. |
ShowBorder | bool | true | Whether to draw a border around the circle. |
ApplyThemeOnImage | bool | true | Applies theme colors to the image. |
IsForColorSet | bool | false | Color picker mode; fills circle with BackColor. |
Examples
Photo Avatar Button
var avatar = new BeepCircularButton {
ImagePath = "profile.jpg", TextLocation = TextLocation.Bottom,
Text = "John Doe", ShowBorder = false };
avatar.Click += (s, e) => OpenProfile();Color Picker
var colorBtn = new BeepCircularButton {
IsForColorSet = true, BackColor = Color.Red, ShowBorder = true };
colorBtn.Click += (s, e) => PickColor(colorBtn.BackColor);