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

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.

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.

   C#

   using Syncfusion.Windows.Forms.Tools;

   VB.NET

   Imports Syncfusion.Windows.Forms.Tools

4. Create an instance of the GradientPanelExt, and add it to the form.

   C#

   GradientPanelExt gradientPanelExt = new GradientPanelExt();
   this.Controls.Add(gradientPanelExt);

   VB.NET

   Private gradientPanelExt As GradientPanelExt = New GradientPanelExt()
   Me.Controls.Add(gradientPanelExt)

5. Set the following properties and add primitives to the gradient panel.

   C#

   // GradientPanelExt
   GradientPanelExt gradientPanelExt = new GradientPanelExt();
   this.Controls.Add(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
   gradientPanelExt.Controls.Add(label1);
   gradientPanelExt.Controls.Add(label2);
   gradientPanelExt.Controls.Add(textBoxExt1);
   gradientPanelExt.Controls.Add(textBoxExt2);

   VB.NET

   'GradientPanelExt
   Dim gradientPanelExt As New GradientPanelExt()
   Me.Controls.Add(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"
      
   'Title
   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
   gradientPanelExt.Controls.Add(label1)
   gradientPanelExt.Controls.Add(label2)
   gradientPanelExt.Controls.Add(textBoxExt1)
   gradientPanelExt.Controls.Add(textBoxExt2)