Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Classe CheckBoxRenderer

 

Fornece os métodos usados para renderizar um controle de caixa de seleção com ou sem estilos visuais. Essa classe não pode ser herdada.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (em System.Windows.Forms.dll)

System.Object
  System.Windows.Forms.CheckBoxRenderer

public sealed class CheckBoxRenderer

NomeDescrição
System_CAPS_pubpropertySystem_CAPS_staticRenderMatchingApplicationState

Obtém ou define um valor que indica se o processador usa o estado do aplicativo para determinar o estilo de renderização.

NomeDescrição
System_CAPS_pubmethodSystem_CAPS_staticDrawCheckBox(Graphics, Point, CheckBoxState)

Desenha um controle de caixa de seleção no estado especificado e local.

System_CAPS_pubmethodSystem_CAPS_staticDrawCheckBox(Graphics, Point, Rectangle, String, Font, Boolean, CheckBoxState)

Desenha um controle de caixa de seleção no estado especificado e local, com o texto especificado e com um retângulo de foco opcional.

System_CAPS_pubmethodSystem_CAPS_staticDrawCheckBox(Graphics, Point, Rectangle, String, Font, Image, Rectangle, Boolean, CheckBoxState)

Desenha um controle de caixa de seleção no estado especificado e local, com o texto especificado e a imagem e um retângulo de foco opcional.

System_CAPS_pubmethodSystem_CAPS_staticDrawCheckBox(Graphics, Point, Rectangle, String, Font, TextFormatFlags, Boolean, CheckBoxState)

Desenha um controle de caixa de seleção no estado e local especificados, com o texto e formatação de texto especificados e com um retângulo de foco opcional.

System_CAPS_pubmethodSystem_CAPS_staticDrawCheckBox(Graphics, Point, Rectangle, String, Font, TextFormatFlags, Image, Rectangle, Boolean, CheckBoxState)

Desenha um controle de caixa de seleção no estado especificado e local. com o texto especificado, a formatação de texto e imagem. e com um retângulo de foco opcional.

System_CAPS_pubmethodSystem_CAPS_staticDrawParentBackground(Graphics, Rectangle, Control)

Desenha o plano de fundo do pai do controle na área especificada.

System_CAPS_pubmethodEquals(Object)

Verifica se o objeto especificado é igual ao objeto atual. (Herdado de Object.)

System_CAPS_pubmethodSystem_CAPS_staticGetGlyphSize(Graphics, CheckBoxState)

Retorna o tamanho do glifo caixa de seleção.

System_CAPS_pubmethodGetHashCode()

Serve como a função de hash padrão.(Herdado de Object.)

System_CAPS_pubmethodGetType()

Obtém o Type da instância atual.(Herdado de Object.)

System_CAPS_pubmethodSystem_CAPS_staticIsBackgroundPartiallyTransparent(CheckBoxState)

Indica se o plano de fundo da caixa de seleção tem partes semitransparentes ou combinação alfa.

System_CAPS_pubmethodToString()

Retorna uma string que representa o objeto atual.(Herdado de Object.)

The T:System.Windows.Forms.CheckBoxRenderer class provides a set of static methods that can be used to render a check box control. Rendering a control refers to drawing the user interface of a control. To draw a check box, use one of the Overload:System.Windows.Forms.CheckBoxRenderer.DrawCheckBox methods. These methods provide a variety of options, such as drawing text or an image with the check box.

If visual styles are enabled in the operating system and visual styles are applied to the current application, Overload:System.Windows.Forms.CheckBoxRenderer.DrawCheckBox will draw the check box with the current visual style. Otherwise, Overload:System.Windows.Forms.CheckBoxRenderer.DrawCheckBox will draw the check box with the classic Windows style. This is useful if you are drawing a custom control that should automatically match the current visual style setting of the operating system.

This class wraps the functionality of a T:System.Windows.Forms.VisualStyles.VisualStyleRenderer that is set to one of the elements exposed by the T:System.Windows.Forms.VisualStyles.VisualStyleElement.Button.CheckBox class. For more information, see Rendering Controls with Visual Styles.

WinXpFamily

Visual styles are supported only on these platforms.

The following code example demonstrates how to write a custom control that uses the Overload:System.Windows.Forms.CheckBoxRenderer.DrawCheckBox method to draw a check box that responds to mouse clicks.

using System;
using System.Drawing;
using System.Windows.Forms;
using System.Windows.Forms.VisualStyles;

namespace CheckBoxRendererSample
{
    class Form1 : Form
    {
        public Form1()
            : base()
        {
            CustomCheckBox CheckBox1 = new CustomCheckBox();
            Controls.Add(CheckBox1);

            if (Application.RenderWithVisualStyles)
                this.Text = "Visual Styles Enabled";
            else
                this.Text = "Visual Styles Disabled";
        }

        [STAThread]
        static void Main()
        {
            // If you do not call EnableVisualStyles below, then 
            // CheckBoxRenderer.DrawCheckBox automatically detects 
            // this and draws the check box without visual styles.
            Application.EnableVisualStyles();
            Application.Run(new Form1());
        }
    }

    public class CustomCheckBox : Control
    {
        private Rectangle textRectangleValue = new Rectangle();
        private Point clickedLocationValue = new Point();
        private bool clicked = false;
        private CheckBoxState state = CheckBoxState.UncheckedNormal;

        public CustomCheckBox()
            : base()
        {
            this.Location = new Point(50, 50);
            this.Size = new Size(100, 20);
            this.Text = "Click here";
            this.Font = SystemFonts.IconTitleFont;
        }

        // Calculate the text bounds, exluding the check box.
        public Rectangle TextRectangle
        {
            get
            {
                using (Graphics g = this.CreateGraphics())
                {
                    textRectangleValue.X = ClientRectangle.X +
                        CheckBoxRenderer.GetGlyphSize(g,
                        CheckBoxState.UncheckedNormal).Width;
                    textRectangleValue.Y = ClientRectangle.Y;
                    textRectangleValue.Width = ClientRectangle.Width -
                        CheckBoxRenderer.GetGlyphSize(g,
                        CheckBoxState.UncheckedNormal).Width;
                    textRectangleValue.Height = ClientRectangle.Height;
                }

                return textRectangleValue;
            }
        }

        // Draw the check box in the current state.
        protected override void OnPaint(PaintEventArgs e)
        {
            base.OnPaint(e);

            CheckBoxRenderer.DrawCheckBox(e.Graphics,
                ClientRectangle.Location, TextRectangle, this.Text,
                this.Font, TextFormatFlags.HorizontalCenter,
                clicked, state);
        }

        // Draw the check box in the checked or unchecked state, alternately.
        protected override void OnMouseDown(MouseEventArgs e)
        {
            base.OnMouseDown(e);

            if (!clicked)
            {
                clicked = true;
                this.Text = "Clicked!";
                state = CheckBoxState.CheckedPressed;
                Invalidate();
            }
            else
            {
                clicked = false;
                this.Text = "Click here";
                state = CheckBoxState.UncheckedNormal;
                Invalidate();
            }
        }

        // Draw the check box in the hot state. 
        protected override void OnMouseHover(EventArgs e)
        {
            base.OnMouseHover(e);
            state = clicked ? CheckBoxState.CheckedHot :
                CheckBoxState.UncheckedHot;
            Invalidate();
        }

        // Draw the check box in the hot state. 
        protected override void OnMouseUp(MouseEventArgs e)
        {
            base.OnMouseUp(e);
            this.OnMouseHover(e);
        }

        // Draw the check box in the unpressed state.
        protected override void OnMouseLeave(EventArgs e)
        {
            base.OnMouseLeave(e);
            state = clicked ? CheckBoxState.CheckedNormal :
                CheckBoxState.UncheckedNormal;
            Invalidate();
        }
    }
}

.NET Framework
Disponível desde 2.0

Quaisquer membros estáticos públicos ( Compartilhado no Visual Basic) desse tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Retornar ao início
Mostrar: