Getting Started with Windows Forms GradientPanelExt

11 Oct 202210 minutes to read

This section briefly describes how to create a new Windows Forms project in Visual Studio and add the GradientPanelExt control with its basic functionalities.

Assembly deployment

Refer to the control dependencies section to get the list of assemblies or the details of NuGet package that need to be added as reference to use the control in any application.

Refer to this documentation to find more details about installing NuGet packages in a Windows Forms application.

Adding the GradientPanelExt control via designer

The following steps describe how to create the GradientPanelExt control via designer.

  1. Create a new Windows Forms application in Visual Studio.

  2. Add the GradientPanelExt control to an application by dragging it from the toolbox to design view. The following dependent assemblies will be added automatically:

    • Syncfusion.Shared.Base

Drag and drop GradientPanelExt from toolbox

  1. Set the Gradient colors to the panel by defining gradient styles and colors.

  2. Add the primitives to the control using GradientPanelExt PrimitiveCollection Editor, which is displayed using the Primitives property. Refer to the following screenshot.

Windows Forms GradientPanelExt showing primitive collection editor

  1. Set the primitive alignment and position.

Adding the GradientPanelExt control via code

The following steps describe how to create the GradientPanelExt control programmatically:

  1. Create a C# or VB application via Visual Studio.

  2. Add the following reference to the project:

    • Syncfusion.Shared.Base
  3. Include the required namespace.

    using Syncfusion.Windows.Forms.Tools;
    Imports Syncfusion.Windows.Forms.Tools
  4. Create an instance of the GradientPanelExt, and add it to the form.

    GradientPanelExt gradientPanelExt = new GradientPanelExt();
    Private gradientPanelExt As GradientPanelExt = New GradientPanelExt()
  5. Set the following properties and add primitives to the gradient panel.

    // GradientPanelExt
    GradientPanelExt gradientPanelExt = new GradientPanelExt();
    gradientPanelExt.BackColor = System.Drawing.Color.Transparent;
    gradientPanelExt.BackgroundColor = new Syncfusion.Drawing.BrushInfo(Syncfusion.Drawing.GradientStyle.Horizontal, System.Drawing.SystemColors.ControlText, System.Drawing.Color.MediumSlateBlue);
    gradientPanelExt.Size = new System.Drawing.Size(343, 128);
    gradientPanelExt.CornerRadius = 10;
    // Username Label
    Label label1 = new Label();
    label1.Location = new System.Drawing.Point(52, 29);
    label1.BackColor = System.Drawing.Color.Transparent;
    label1.ForeColor = System.Drawing.Color.White;
    label1.Size = new System.Drawing.Size(58, 13);
    label1.Text = "Username:";
    // Password Label
    Label label2 = new Label();
    label2.Location = new System.Drawing.Point(52, 60);
    label2.BackColor = System.Drawing.Color.Transparent;
    label2.ForeColor = System.Drawing.Color.White;
    label2.Size = new System.Drawing.Size(58, 13);
    label2.Text = "Password:";
    // Username TextBoxExt
    TextBoxExt textBoxExt1 = new TextBoxExt();
    textBoxExt1.Location = new System.Drawing.Point(113, 26);
    textBoxExt1.Size = new System.Drawing.Size(100, 20);
    textBoxExt1.Text = "David carter";
    // Password TextBoxExt
    TextBoxExt textBoxExt2 = new TextBoxExt();
    textBoxExt2.Location = new System.Drawing.Point(113, 57);
    textBoxExt2.PasswordChar = '*';
    textBoxExt2.Size = new System.Drawing.Size(100, 20);
    textBoxExt2.Text = "Welcome";
    // Login title
    TextPrimitive textPrimitive1 = new TextPrimitive();
    textPrimitive1.Alignment = Syncfusion.Windows.Forms.Tools.Alignment.Top;
    textPrimitive1.BorderColor = System.Drawing.Color.Transparent;
    textPrimitive1.Size = new System.Drawing.Size(50, 20);
    textPrimitive1.Text = "Login";
    textPrimitive1.TextColor = System.Drawing.Color.White;
    // Ok button
    TextPrimitive textPrimitive2 = new TextPrimitive();
    textPrimitive2.Alignment = Syncfusion.Windows.Forms.Tools.Alignment.Bottom;
    textPrimitive2.BackColor = System.Drawing.Color.White;
    textPrimitive2.Position = 104;
    textPrimitive2.Size = new System.Drawing.Size(40, 20);
    textPrimitive2.Text = "Ok";
    textPrimitive2.TextColor = System.Drawing.Color.Black;
    // Cancel button
    TextPrimitive textPrimitive3 = new TextPrimitive();
    textPrimitive3.Alignment = Syncfusion.Windows.Forms.Tools.Alignment.Bottom;
    textPrimitive3.BackColor = System.Drawing.Color.White;
    textPrimitive3.Position = 160;
    textPrimitive3.Size = new System.Drawing.Size(40, 20);
    textPrimitive3.Text = "Cancel";
    textPrimitive3.TextColor = System.Drawing.Color.Black;
    // Adding primitives
    gradientPanelExt.Primitives.AddRange(new Primitive[] { textPrimitive1, textPrimitive2, textPrimitive3 });
    // Add the controls
    Dim gradientPanelExt As New GradientPanelExt()
    gradientPanelExt.BackColor = System.Drawing.Color.Transparent
    gradientPanelExt.BackgroundColor = New Syncfusion.Drawing.BrushInfo(Syncfusion.Drawing.GradientStyle.Horizontal, System.Drawing.SystemColors.ControlText, System.Drawing.Color.MediumSlateBlue)
    gradientPanelExt.Size = New System.Drawing.Size(343, 128)
    gradientPanelExt.CornerRadius = 10
    'Username Label
    Dim label1 As New Label()
    label1.Location = New System.Drawing.Point(52, 29)
    label1.BackColor = System.Drawing.Color.Transparent
    label1.ForeColor = System.Drawing.Color.White
    label1.Size = New System.Drawing.Size(58, 13)
    label1.Text = "Username:"
    'Password Label
    Dim label2 As New Label()
    label2.Location = New System.Drawing.Point(52, 60)
    label2.BackColor = System.Drawing.Color.Transparent
    label2.ForeColor = System.Drawing.Color.White
    label2.Size = New System.Drawing.Size(58, 13)
    label2.Text = "Password:"
    'Username TextBoxExt
    Dim textBoxExt1 As New TextBoxExt()
    textBoxExt1.Location = New System.Drawing.Point(113, 26)
    textBoxExt1.Size = New System.Drawing.Size(100, 20)
    textBoxExt1.Text = "David carter"
    'Password TextBoxExt
    Dim textBoxExt2 As New TextBoxExt()
    textBoxExt2.Location = New System.Drawing.Point(113, 57)
    textBoxExt2.PasswordChar = "*"c
    textBoxExt2.Size = New System.Drawing.Size(100, 20)
    textBoxExt2.Text = "Welcome"
    Dim textPrimitive1 As New TextPrimitive()
    textPrimitive1.Alignment = Syncfusion.Windows.Forms.Tools.Alignment.Top
    textPrimitive1.BorderColor = System.Drawing.Color.Transparent
    textPrimitive1.Size = New System.Drawing.Size(50, 20)
    textPrimitive1.Text = "Login"
    textPrimitive1.TextColor = System.Drawing.Color.White
    'Ok button
    Dim textPrimitive2 As New TextPrimitive()
    textPrimitive2.Alignment = Syncfusion.Windows.Forms.Tools.Alignment.Bottom
    textPrimitive2.BackColor = System.Drawing.Color.White
    textPrimitive2.Position = 104
    textPrimitive2.Size = New System.Drawing.Size(40, 20)
    textPrimitive2.Text = "Ok"
    textPrimitive2.TextColor = System.Drawing.Color.Black
    'Cancel button
    Dim textPrimitive3 As New TextPrimitive()
    textPrimitive3.Alignment = Syncfusion.Windows.Forms.Tools.Alignment.Bottom
    textPrimitive3.BackColor = System.Drawing.Color.White
    textPrimitive3.Position = 160
    textPrimitive3.Size = New System.Drawing.Size(40, 20)
    textPrimitive3.Text = "Cancel"
    textPrimitive3.TextColor = System.Drawing.Color.Black
    'Adding primitives
    gradientPanelExt.Primitives.AddRange(New Primitive() { textPrimitive1, textPrimitive2, textPrimitive3 })
    'Add the controls

Windows Forms GradientPanelExt shows added primitives and other controls