Comment on page
Bunifu Label
Full plain and HTML-text support for form labels
Bunifu Label is a rich .NET control that allows us to provide rich appealing texts inside our Windows Forms applications. It extends the basic properties of the standard Windows Form Label by adding support for HTML-based text tags and inline CSS styles.
It's easy to add a Bunifu Label at the designer level. Locate Bunifu Label in your toolbox and drag it to your form as shown below.
To add a Bunifu Label on our form at run-time, use the Load event handler of your form to run the following code.
C#
VB.NET
public partial class Form1: Form
{
public Form1() {
InitializeComponent();
}
private void Form1_Load(object sender, EventArgs e)
{
var newLabel = new Bunifu.UI.WinForms.BunifuLabel();
newLabel.Text = 'My new label’;
this.Controls.Add(newLabel);
}
}
Public Class Form1
Private Sub Form1_Load(sender As Object, e As EventArgs) Handles MyBase.Load
Dim label As New Bunifu.Framework.UI.BunifuLabel
label.Text =’My new label'
Me.Controls.Add(label)
End Sub
End Class
Let's take a deep dive and get insights into the available properties on Bunifu Label.
This property allows you to get or set a text string for the label control.
Apart from providing a string text, it provides an advanced text styling mechanism that implements the use of HTML tags and inline CSS style capabilities. Here's a list of the supported tags.
Tag | Description |
<h1> to <h6> | Defines the text headings |
<p> | Defines a paragragh |
<br> | Defines a single line break |
<strong> | defines text with a bold style |
<sub> | Defines a subscript text |
<sup> | Defines a superscript text |
<li> | Defines a list item used with ordered lists(<ol>) or unordered lists (<ul>) |
Note that the tags are XHTML compliant
To add the CSS styling we use the style attribute of the HTML elements described above. The following is a style that sets the
fore-color of a super-script text in the label.This text contains a colored supercript
number: 10^<sup style="color:#f72585">45</sup>
This property allows you to get or set an array of font styles for the text rendered in the control. You can set, for example, the
font-family, the font-size and much more.This property allows you to get or set a color value for the text rendered in the control. It supports the use of RGB and HEX color values.
This property gets or sets the background color for the label control. By default, the background color value is set to transparent.
This property gets or sets the text alignment position of the text rendered in the label control.
For the property to function, ensure that the
AutoSize and AutoSizeHeightOnly properties are unchecked.The available enumerated position values are
top-left, top-center, top-right, middle-left, middle-center, middle-right, bottom-left, bottom-center and bottom-right positions.
This property gets or sets a boolean value, which when set to true, causes the label control to grow and shrink automatically based on the text's length. By default, the property is set to true.
Setting the property to false, allows you to define a custom size(i.e., the width and height) of the label control.
It is important to set the AutoEllipsis property to true, so that when the text exceeds the set width of the label control, will cause the ellipsis to appear at the right edge of the control.
This property gets or sets a boolean value, which when set to true, causes the label control height to automatically grow and shrink base on the text's line breaks.
Ensure that when using this property, the
UseGdiPlusTextRendering property is set to true. This will ensure that all the text content fits within the system's auto-sized height.This property allows you to get or set a boolean value, which when set to true, appends the ellipsis characters (...) at the right edge position of the label control, denoting that the text has exceeded the set width specified in the control.
This property only works when the
AutoSize property and AutoSizeHeightOnly property are set to false. This property allows you to get or set a boolean value, which when set to true, enables users to select the label's text during the application's run-time.
This property allows you to get or set a boolean value, that when set to true, enables the label control to inherit properties of the parent control.
We hope you have gained insights into using Bunifu Label. Should you have feedback or suggestions please send us via chat on the bottom right corner of the screen and we will gladly respond in no time.
Last modified 2yr ago