Partilhar via


CheckBoxRenderer.DrawCheckBox Método

Definição

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

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, 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

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, 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

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, 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

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