CheckBoxRenderer.DrawCheckBox Método

Referência

Definição

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Desenha um controle de caixa de seleção.

Sobrecargas

DrawCheckBox(Graphics, Point, CheckBoxState)	Desenha um controle de caixa de seleção no estado e nos locais especificados.
DrawCheckBox(Graphics, Point, Rectangle, String, Font, Boolean, CheckBoxState)	Desenha um controle de caixa de seleção no estado e local especificados, com o texto especificado e com um retângulo de foco opcional.
DrawCheckBox(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.
DrawCheckBox(Graphics, Point, Rectangle, String, Font, Image, Rectangle, Boolean, CheckBoxState)	Desenha um controle de caixa de seleção no estado e local especificados, com o texto e a imagem especificados e com um retângulo de foco opcional.
DrawCheckBox(Graphics, Point, Rectangle, String, Font, TextFormatFlags, Image, Rectangle, Boolean, CheckBoxState)	Desenha um controle de caixa de seleção no estado e local especificados, com o texto, a formatação de texto e a imagem especificados e com um retângulo de foco opcional.

DrawCheckBox(Graphics, Point, CheckBoxState)

Desenha um controle de caixa de seleção no estado e nos locais especificados.

public:
 static void DrawCheckBox(System::Drawing::Graphics ^ g, System::Drawing::Point glyphLocation, System::Windows::Forms::VisualStyles::CheckBoxState state);

public static void DrawCheckBox (System.Drawing.Graphics g, System.Drawing.Point glyphLocation, System.Windows.Forms.VisualStyles.CheckBoxState state);

static member DrawCheckBox : System.Drawing.Graphics * System.Drawing.Point * System.Windows.Forms.VisualStyles.CheckBoxState -> unit

Public Shared Sub DrawCheckBox (g As Graphics, glyphLocation As Point, state As CheckBoxState)

Parâmetros

g: Graphics

O Graphics usado para desenhar a caixa de seleção.

glyphLocation: Point

O Point em que o glifo da caixa de seleção será desenhado.

state: CheckBoxState

Um dos valores de CheckBoxState que especifica o estado visual da caixa de seleção.

Comentários

Se os estilos visuais estiverem habilitados no sistema operacional e os estilos visuais forem aplicados ao aplicativo atual, esse método desenhará a caixa de seleção com o estilo visual atual. Caso contrário, ele desenhará a caixa de seleção com o estilo clássico de Windows.

Aplica-se a

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

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

public:
 static void DrawCheckBox(System::Drawing::Graphics ^ g, System::Drawing::Point glyphLocation, System::Drawing::Rectangle textBounds, System::String ^ checkBoxText, System::Drawing::Font ^ font, bool focused, System::Windows::Forms::VisualStyles::CheckBoxState state);

public static void DrawCheckBox (System.Drawing.Graphics g, System.Drawing.Point glyphLocation, System.Drawing.Rectangle textBounds, string checkBoxText, System.Drawing.Font font, bool focused, System.Windows.Forms.VisualStyles.CheckBoxState state);

public static void DrawCheckBox (System.Drawing.Graphics g, System.Drawing.Point glyphLocation, System.Drawing.Rectangle textBounds, string? checkBoxText, System.Drawing.Font? font, bool focused, System.Windows.Forms.VisualStyles.CheckBoxState state);

static member DrawCheckBox : System.Drawing.Graphics * System.Drawing.Point * System.Drawing.Rectangle * string * System.Drawing.Font * bool * System.Windows.Forms.VisualStyles.CheckBoxState -> unit

Public Shared Sub DrawCheckBox (g As Graphics, glyphLocation As Point, textBounds As Rectangle, checkBoxText As String, font As Font, focused As Boolean, state As CheckBoxState)

Parâmetros

g: Graphics

O Graphics usado para desenhar a caixa de seleção.

glyphLocation: Point

O Point em que o glifo da caixa de seleção será desenhado.

textBounds: Rectangle

O Rectangle em que checkBoxText será desenhado.

checkBoxText: String

O String para desenhar com a caixa de seleção.

font: Font

O Font a ser aplicado a checkBoxText.

focused: Boolean

true para desenhar um retângulo de foco; caso contrário, false.

state: CheckBoxState

Um dos valores de CheckBoxState que especifica o estado visual da caixa de seleção.

Comentários

Aplica-se a

DrawCheckBox(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.

public:
 static void DrawCheckBox(System::Drawing::Graphics ^ g, System::Drawing::Point glyphLocation, System::Drawing::Rectangle textBounds, System::String ^ checkBoxText, System::Drawing::Font ^ font, System::Windows::Forms::TextFormatFlags flags, bool focused, System::Windows::Forms::VisualStyles::CheckBoxState state);

public static void DrawCheckBox (System.Drawing.Graphics g, System.Drawing.Point glyphLocation, System.Drawing.Rectangle textBounds, string checkBoxText, System.Drawing.Font font, System.Windows.Forms.TextFormatFlags flags, bool focused, System.Windows.Forms.VisualStyles.CheckBoxState state);

public static void DrawCheckBox (System.Drawing.Graphics g, System.Drawing.Point glyphLocation, System.Drawing.Rectangle textBounds, string? checkBoxText, System.Drawing.Font? font, System.Windows.Forms.TextFormatFlags flags, bool focused, System.Windows.Forms.VisualStyles.CheckBoxState state);

static member DrawCheckBox : System.Drawing.Graphics * System.Drawing.Point * System.Drawing.Rectangle * string * System.Drawing.Font * System.Windows.Forms.TextFormatFlags * bool * System.Windows.Forms.VisualStyles.CheckBoxState -> unit

Public Shared Sub DrawCheckBox (g As Graphics, glyphLocation As Point, textBounds As Rectangle, checkBoxText As String, font As Font, flags As TextFormatFlags, focused As Boolean, state As CheckBoxState)

Parâmetros

g: Graphics

O Graphics usado para desenhar a caixa de seleção.

glyphLocation: Point

O Point em que o glifo da caixa de seleção será desenhado.

textBounds: Rectangle

O Rectangle em que checkBoxText será desenhado.

checkBoxText: String

O String para desenhar com a caixa de seleção.

font: Font

O Font a ser aplicado a checkBoxText.

flags: TextFormatFlags

Uma combinação bit a bit dos valores TextFormatFlags.

focused: Boolean

true para desenhar um retângulo de foco; caso contrário, false.

state: CheckBoxState

Um dos valores de CheckBoxState que especifica o estado visual da caixa de seleção.

Exemplos

O exemplo de código a seguir usa o DrawCheckBox(Graphics, Point, Rectangle, String, Font, TextFormatFlags, Boolean, CheckBoxState) método em um método de OnPaint controle personalizado para desenhar uma caixa de seleção no estado determinado pelo local do ponteiro do mouse. Este exemplo de código faz parte de um exemplo maior fornecido para a CheckBoxRenderer classe.

// Draw the check box in the current state.
virtual void OnPaint(PaintEventArgs ^e) override
{
    Control::OnPaint(e);

    CheckBoxRenderer::DrawCheckBox(e->Graphics,
        ClientRectangle.Location, this->getTextRectangle(), this->Text,
        this->Font, TextFormatFlags::HorizontalCenter,
        clicked, state);
}


// Draw the check box in the checked or unchecked state, alternately.
virtual void OnMouseDown(MouseEventArgs ^e) override
{
    Control::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 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 current state.
Protected Overrides Sub OnPaint(ByVal e As PaintEventArgs)
    MyBase.OnPaint(e)
    CheckBoxRenderer.DrawCheckBox(e.Graphics, _
        Me.ClientRectangle.Location, TextRectangle, Me.Text, _
        Me.Font, TextFormatFlags.HorizontalCenter, _
        clicked, state)
End Sub

' Draw the check box in the checked or unchecked state, alternately.
Protected Overrides Sub OnMouseDown(ByVal e As MouseEventArgs)
    MyBase.OnMouseDown(e)
    If Not clicked Then
        With Me
            .clicked = True
            .Text = "Clicked!"
            .state = CheckBoxState.CheckedPressed
        End With
        Invalidate()
    Else
        With Me
            .clicked = False
            .Text = "Click here"
            .state = CheckBoxState.UncheckedNormal
        End With
        Invalidate()
    End If
End Sub

Comentários

Aplica-se a

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

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

public:
 static void DrawCheckBox(System::Drawing::Graphics ^ g, System::Drawing::Point glyphLocation, System::Drawing::Rectangle textBounds, System::String ^ checkBoxText, System::Drawing::Font ^ font, System::Drawing::Image ^ image, System::Drawing::Rectangle imageBounds, bool focused, System::Windows::Forms::VisualStyles::CheckBoxState state);

public static void DrawCheckBox (System.Drawing.Graphics g, System.Drawing.Point glyphLocation, System.Drawing.Rectangle textBounds, string checkBoxText, System.Drawing.Font font, System.Drawing.Image image, System.Drawing.Rectangle imageBounds, bool focused, System.Windows.Forms.VisualStyles.CheckBoxState state);

public static void DrawCheckBox (System.Drawing.Graphics g, System.Drawing.Point glyphLocation, System.Drawing.Rectangle textBounds, string? checkBoxText, System.Drawing.Font? font, System.Drawing.Image image, System.Drawing.Rectangle imageBounds, bool focused, System.Windows.Forms.VisualStyles.CheckBoxState state);

static member DrawCheckBox : System.Drawing.Graphics * System.Drawing.Point * System.Drawing.Rectangle * string * System.Drawing.Font * System.Drawing.Image * System.Drawing.Rectangle * bool * System.Windows.Forms.VisualStyles.CheckBoxState -> unit

Public Shared Sub DrawCheckBox (g As Graphics, glyphLocation As Point, textBounds As Rectangle, checkBoxText As String, font As Font, image As Image, imageBounds As Rectangle, focused As Boolean, state As CheckBoxState)

Parâmetros

g: Graphics

O Graphics usado para desenhar a caixa de seleção.

glyphLocation: Point

O Point em que o glifo da caixa de seleção será desenhado.

textBounds: Rectangle

O Rectangle em que checkBoxText será desenhado.

checkBoxText: String

O String para desenhar com a caixa de seleção.

font: Font

O Font a ser aplicado a checkBoxText.

image: Image

O Image para desenhar com a caixa de seleção.

imageBounds: Rectangle

O Rectangle que representa as dimensões da image.

focused: Boolean

true para desenhar um retângulo de foco; caso contrário, false.

state: CheckBoxState

Um dos valores de CheckBoxState que especifica o estado visual da caixa de seleção.

Comentários

Aplica-se a

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

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

public:
 static void DrawCheckBox(System::Drawing::Graphics ^ g, System::Drawing::Point glyphLocation, System::Drawing::Rectangle textBounds, System::String ^ checkBoxText, System::Drawing::Font ^ font, System::Windows::Forms::TextFormatFlags flags, System::Drawing::Image ^ image, System::Drawing::Rectangle imageBounds, bool focused, System::Windows::Forms::VisualStyles::CheckBoxState state);

public static void DrawCheckBox (System.Drawing.Graphics g, System.Drawing.Point glyphLocation, System.Drawing.Rectangle textBounds, string checkBoxText, System.Drawing.Font font, System.Windows.Forms.TextFormatFlags flags, System.Drawing.Image image, System.Drawing.Rectangle imageBounds, bool focused, System.Windows.Forms.VisualStyles.CheckBoxState state);

public static void DrawCheckBox (System.Drawing.Graphics g, System.Drawing.Point glyphLocation, System.Drawing.Rectangle textBounds, string? checkBoxText, System.Drawing.Font? font, System.Windows.Forms.TextFormatFlags flags, System.Drawing.Image image, System.Drawing.Rectangle imageBounds, bool focused, System.Windows.Forms.VisualStyles.CheckBoxState state);

static member DrawCheckBox : System.Drawing.Graphics * System.Drawing.Point * System.Drawing.Rectangle * string * System.Drawing.Font * System.Windows.Forms.TextFormatFlags * System.Drawing.Image * System.Drawing.Rectangle * bool * System.Windows.Forms.VisualStyles.CheckBoxState -> unit

Public Shared Sub DrawCheckBox (g As Graphics, glyphLocation As Point, textBounds As Rectangle, checkBoxText As String, font As Font, flags As TextFormatFlags, image As Image, imageBounds As Rectangle, focused As Boolean, state As CheckBoxState)

Parâmetros

g: Graphics

O Graphics usado para desenhar a caixa de seleção.

glyphLocation: Point

O Point em que o glifo da caixa de seleção será desenhado.

textBounds: Rectangle

O Rectangle em que checkBoxText será desenhado.

checkBoxText: String

O String para desenhar com a caixa de seleção.

font: Font

O Font a ser aplicado a checkBoxText.

flags: TextFormatFlags

Uma combinação bit a bit dos valores TextFormatFlags.

image: Image

O Image para desenhar com a caixa de seleção.

imageBounds: Rectangle

O Rectangle que representa as dimensões da image.

focused: Boolean

true para desenhar um retângulo de foco; caso contrário, false.

state: CheckBoxState

Um dos valores de CheckBoxState que especifica o estado visual da caixa de seleção.

Comentários

Aplica-se a

Compartilhar via

CheckBoxRenderer.DrawCheckBox Método

Definição

Sobrecargas

DrawCheckBox(Graphics, Point, CheckBoxState)

Parâmetros

Comentários

Aplica-se a

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

Parâmetros

Comentários

Aplica-se a

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

Parâmetros

Exemplos

Comentários

Aplica-se a

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

Parâmetros

Comentários

Aplica-se a

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

Parâmetros

Comentários

Aplica-se a

Recursos adicionais