Saltar al contenido

Custom Text Box – Custom controls WinForm C#

Hola :), esta vez crearemos un cuadro de texto personalizado con C# y Windows Form. Y así tener un cuadro de texto con un aspecto muy elegante, plano y moderno, con tamaño y color de borde personalizables, poder establecer un estilo de borde subrayado o rectangular. Además de poder establecer y cambiar el color del borde en modo enfoque, establecer como campo de contraseña y multilínea.

Hacerlo es muy fácil y rápido no necesitas tener conocimientos avanzados sobre programación, así que comencemos con el tutorial:

1.- Agregar Control de Usuario

Primeramente debemos agregar un control de usuario para crear el cuadro de texto personalizado a través del diseñador y código. O puedes agregar una clase y heredar de la clase de control de usuario y crear el cuadro de texto personalizado solamente mediante código.

Como agregar un User Control Visual Studio

2.- Diseñar la apariencia básica – Diseñador

Luego de haber agregado el UserControl, inicializa las siguientes propiedades: En la propiedad AutoScaleMode establecer en ninguno, y un Padding de 7 píxeles en todos los lados, esto es muy importante ya que ayudará a que el cuadro de texto quede centrado en el control de usuario. Cambiar el tamaño del control de usuario a un ancho de 250 y un alto de 30. Opcionalmente establecer el color de fondo, color de texto y aumentaremos el tamaño de texto.

2.1.- Agregar TextBox

Luego de haber inicializado las propiedades anteriores, ya solamente queda agregar un cuadro de texto al control de usuario y establecer la propiedad Dock del cuadro de texto en FILL, para encajar en todo el control de usuario. Y finalmente quitar el borde del cuadro de texto. De esta manera el cuadro de texto queda centrado en el control de usuario, gracias al Padding establecido anteriormente.

-Transcripción del código – RJTextBox.Designer.cs

#region Component Designer generated code
private void InitializeComponent()
{
    this.textBox1 = new System.Windows.Forms.TextBox();
    this.SuspendLayout();
    // 
    // textBox1
    // 
    this.textBox1.BorderStyle = System.Windows.Forms.BorderStyle.None;
    this.textBox1.Dock = System.Windows.Forms.DockStyle.Fill;
    this.textBox1.Location = new System.Drawing.Point(7, 7);
    this.textBox1.Name = "textBox1";
    this.textBox1.Size = new System.Drawing.Size(236, 15);
    // 
    // RJTextBox
    // 
    this.AutoScaleMode = System.Windows.Forms.AutoScaleMode.None;
    this.BackColor = System.Drawing.SystemColors.Window;
    this.Controls.Add(this.textBox1);
    this.Font = new System.Drawing.Font("Microsoft Sans Serif", 9.5F, System.Drawing.FontStyle.Regular, System.Drawing.GraphicsUnit.Point, ((byte)(0)));
    this.ForeColor = System.Drawing.Color.DimGray;
    this.Margin = new System.Windows.Forms.Padding(4);
    this.Name = "RJTextBox";
    this.Padding = new System.Windows.Forms.Padding(7);
    this.Size = new System.Drawing.Size(250, 30);
    this.ResumeLayout(false);
    this.PerformLayout();
}
#endregion

private System.Windows.Forms.TextBox textBox1;

3.- Declarar campos – Código

Una vez hecho el diseño básico del cuadro de texto personalizado, ahora ya solo queda abrir el Código del control de usuario y hacer el resto, y como es de costumbre, declararemos algunos campos para la apariencia e inicializar sus valores predeterminados. En este caso, un campo para el color de borde, un campo para el tamaño de borde, y un campo para el estilo del cuadro de texto, es decir un estilo de borde subrayado o rectangular.

    //Fields
    private Color borderColor = Color.MediumSlateBlue;
    private int borderSize = 2;
    private bool underlinedStyle = false;
    private Color borderFocusColor = Color.HotPink;
    private bool isFocused = false;

4.- Crear método para establecer el alto adecuado del control

El método se encargará de establecer una altura adecuada al control de usuario(RJTextBox) y cuadro de texto (textBox1), y además de restringir el cambio de altura cuando el cuadro de texto no sea multilínea (textBox1.Multiline=false).

//Private methods
private void UpdateControlHeight()
{
    if (textBox1.Multiline == false)
    {
        int txtHeight = TextRenderer.MeasureText("Text", this.Font).Height + 1;
        textBox1.Multiline = true;
        textBox1.MinimumSize = new Size(0, txtHeight);
        textBox1.Multiline = false;

        this.Height = textBox1.Height + this.Padding.Top + this.Padding.Bottom;
    }
}

5.- Crear los descriptores de acceso – Propiedades

Generamos propiedades para exponer los campos definidos anteriormente, y además de agregar otras propiedades de apariencia (Color de fondo, texto…) y exponer las propiedades funcionales y necesarios para un cuadro de texto (PasswordChar, Multiline, Text…).

//Properties
    [Category("RJ Code Advance")]
    public Color BorderColor
    {
        get { return borderColor; }
        set
        {
            borderColor = value;
            this.Invalidate();
        }
    }
    [Category("RJ Code Advance")]
    public int BorderSize
    {
        get { return borderSize; }
        set
        {
            borderSize = value;
            this.Invalidate();
        }
    }

    [Category("RJ Code Advance")]
    public bool UnderlinedStyle
    {
        get { return underlinedStyle; }
        set
        {
            underlinedStyle = value;
            this.Invalidate();
        }
    }

    [Category("RJ Code Advance")]
    public bool PasswordChar
    {
        get { return textBox1.UseSystemPasswordChar; }
        set { textBox1.UseSystemPasswordChar = value; }
    }

    [Category("RJ Code Advance")]
    public bool Multiline
    {
        get { return textBox1.Multiline; }
        set { textBox1.Multiline = value; }
    }

    [Category("RJ Code Advance")]
    public override Color BackColor
    {
        get { return base.BackColor; }
        set
        {
            base.BackColor = value;
            textBox1.BackColor = value;
        }
    }

    [Category("RJ Code Advance")]
    public override Color ForeColor
    {
        get { return base.ForeColor; }
        set
        {
            base.ForeColor = value;
            textBox1.ForeColor = value;
        }
    }

    [Category("RJ Code Advance")]
    public override Font Font
    {
        get { return base.Font; }
        set
        {
            base.Font = value;
            textBox1.Font = value;
            if (this.DesignMode)
                UpdateControlHeight();
        }
    }

    [Category("RJ Code Advance")]
    public string Texts
    {
        get { return textBox1.Text; }
        set { textBox1.Text = value; }
    }

    [Category("RJ Code Advance")]
    public Color BorderFocusColor
    {
        get { return borderFocusColor; }
        set { borderFocusColor = value; }
    }

6.- Anular y extender métodos de evento – UserControl

Será necesario anular el método de evento OnPaint para dibujar el borde rectangular o subrayado del cuadro de texto personalizado, anular el método de evento OnResize para establecer el alto adecuado del control cada vez que este cambie de tamaño en tiempo de diseño. Finalmente anular el método de evento OnLoad para dar el toque final y establecer el alto adecuado en tiempo de ejecución.

//Overridden methods

protected override void OnPaint(PaintEventArgs e)
{
    base.OnPaint(e);
    Graphics graph = e.Graphics;

    //Draw border
    using (Pen penBorder = new Pen(borderColor, borderSize))
    {
        penBorder.Alignment = System.Drawing.Drawing2D.PenAlignment.Inset;
        if (isFocused) penBorder.Color = borderFocusColor;//Set Border color in focus. Otherwise, normal border color

        if (underlinedStyle) //Line Style
            graph.DrawLine(penBorder, 0, this.Height - 1, this.Width, this.Height - 1);
        else //Normal Style
            graph.DrawRectangle(penBorder, 0, 0, this.Width - 0.5F, this.Height - 0.5F);
    }
}

protected override void OnResize(EventArgs e)
{
    base.OnResize(e);
    if (this.DesignMode)
        UpdateControlHeight();
}

protected override void OnLoad(EventArgs e)
{
    base.OnLoad(e);
    UpdateControlHeight();
}

7.- Cambiar color de borde en modo enfoque

Para ese propósito es necesario cambiar el valor del campo isFocused cuando el cuadro de texto entra en estado enfocado o pierde el foco. Entonces necesitamos suscribir el evento Enter-Focus y Leave-Focus del cuadro de texto y volver a dibujar el control.

    //Change border color in focus mode
    private void textBox1_Enter(object sender, EventArgs e)
    {
        isFocused = true;
        this.Invalidate();
    }

    private void textBox1_Leave(object sender, EventArgs e)
    {
        isFocused = false;
        this.Invalidate();
    }

8.- Crear evento predeterminado del cuadro de texto personalizado

El evento predeterminado de un control de usuario es el evento Load, y el evento predeterminado de un cuadro de texto es el evento TextChanged. Por lo tanto debemos recrear este evento en el cuadro de texto personalizado (RJTextBox), ya que el evento por defecto actual es el evento Load.

Nota: Para saber cual es el evento predeterminado de un control, solamente debes hacer doble clic sobre el control y se creará el método de evento predeterminado.

    [DefaultEvent("_TextChanged")]
    public partial class RJTextBox : UserControl
    {

        //Default Event
        public event EventHandler _TextChanged;

        //TextBox-> TextChanged event
        private void textBox1_TextChanged(object sender, EventArgs e)
        {
            if (_TextChanged != null)
                _TextChanged.Invoke(sender, e);
        }

9.- Adjuntar otros eventos existentes comunes

Finalmente es necesario adjuntar los eventos existentes y comunes entre el control de usuario (RJTextBox) y el cuadro de texto (textBox1), por ejemplo el evento Click, KeyPress y entre otros (Solo es recomendable adjuntar los eventos necesarios).

//TextBox events
/// <summary>
/// textbox events attached to user control events
/// </summary>

private void textBox1_Click(object sender, EventArgs e)
{
    this.OnClick(e);
}

private void textBox1_MouseEnter(object sender, EventArgs e)
{
    this.OnMouseEnter(e);
}

private void textBox1_MouseLeave(object sender, EventArgs e)
{
    this.OnMouseLeave(e);
}

private void textBox1_KeyPress(object sender, KeyPressEventArgs e)
{
    this.OnKeyPress(e);
}

Bueno eso es todo :), espero que les haya gustado y ayudado a comprender el uso de los controles de usuario junto a otros controles para hacer controles personalizados.

Hasta la próxima. 🖐

Ver video tutorial

Los comentarios están cerrados.