共用方式為


CheckBoxRenderer.DrawCheckBox 方法

定義

繪製核取方塊控制項。

多載

DrawCheckBox(Graphics, Point, CheckBoxState)

在指定的狀態和位置中繪製核取方塊控制項。

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

使用指定的文字以及選擇性的焦點矩形,在指定的狀態和位置中繪製核取方塊控制項。

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

使用指定的文字和文字格式,以及選擇性的焦點矩形,在指定的狀態和位置中繪製核取方塊控制項。

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

使用指定的文字和影像,以及選擇性的焦點矩形,在指定的狀態和位置中繪製核取方塊控制項。

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

使用指定的文字、文字格式和影像,以及選擇性的焦點矩形,在指定的狀態和位置中繪製核取方塊控制項。

DrawCheckBox(Graphics, Point, CheckBoxState)

在指定的狀態和位置中繪製核取方塊控制項。

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)

參數

g
Graphics

繪製核取方塊所用的 Graphics

glyphLocation
Point

要在上面繪製核取方塊圖像的 Point

state
CheckBoxState

CheckBoxState 的其中一個值,指定核取方塊的可見狀態。

備註

如果在作業系統中啟用視覺化樣式,而視覺化樣式會套用至目前的應用程式,這個方法將會使用目前的視覺化樣式繪製核取方塊。 否則,它會使用傳統Windows樣式繪製核取方塊。

適用於

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

使用指定的文字以及選擇性的焦點矩形,在指定的狀態和位置中繪製核取方塊控制項。

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)

參數

g
Graphics

繪製核取方塊所用的 Graphics

glyphLocation
Point

要在上面繪製核取方塊圖像的 Point

textBounds
Rectangle

要繪入 checkBoxTextRectangle

checkBoxText
String

隨核取方塊繪製的 String

font
Font

要套用至 checkBoxTextFont

focused
Boolean

true 表示繪製焦點矩形,否則為 false

state
CheckBoxState

CheckBoxState 的其中一個值,指定核取方塊的可見狀態。

備註

如果在作業系統中啟用視覺化樣式,而視覺化樣式會套用至目前的應用程式,這個方法將會使用目前的視覺化樣式繪製核取方塊。 否則,它會使用傳統Windows樣式繪製核取方塊。

適用於

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

使用指定的文字和文字格式,以及選擇性的焦點矩形,在指定的狀態和位置中繪製核取方塊控制項。

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)

參數

g
Graphics

繪製核取方塊所用的 Graphics

glyphLocation
Point

要在上面繪製核取方塊圖像的 Point

textBounds
Rectangle

要繪入 checkBoxTextRectangle

checkBoxText
String

隨核取方塊繪製的 String

font
Font

要套用至 checkBoxTextFont

flags
TextFormatFlags

TextFormatFlags 值的位元組合。

focused
Boolean

true 表示繪製焦點矩形,否則為 false

state
CheckBoxState

CheckBoxState 的其中一個值,指定核取方塊的可見狀態。

範例

下列程式碼範例會 DrawCheckBox(Graphics, Point, Rectangle, String, Font, TextFormatFlags, Boolean, CheckBoxState) 使用自訂控制項 OnPaint 方法中的 方法,在滑鼠指標的位置所決定的狀態中繪製核取方塊。 此程式碼範例是針對 類別提供的較大範例的 CheckBoxRenderer 一部分。

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

備註

如果在作業系統中啟用視覺化樣式,而視覺化樣式會套用至目前的應用程式,這個方法將會使用目前的視覺化樣式繪製核取方塊。 否則,它會使用傳統Windows樣式繪製核取方塊。

適用於

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

使用指定的文字和影像,以及選擇性的焦點矩形,在指定的狀態和位置中繪製核取方塊控制項。

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)

參數

g
Graphics

繪製核取方塊所用的 Graphics

glyphLocation
Point

要在上面繪製核取方塊圖像的 Point

textBounds
Rectangle

要繪入 checkBoxTextRectangle

checkBoxText
String

隨核取方塊繪製的 String

font
Font

要套用至 checkBoxTextFont

image
Image

隨核取方塊繪製的 Image

imageBounds
Rectangle

表示 image 維度的 Rectangle

focused
Boolean

true 表示繪製焦點矩形,否則為 false

state
CheckBoxState

CheckBoxState 的其中一個值,指定核取方塊的可見狀態。

備註

如果在作業系統中啟用視覺化樣式,而視覺化樣式會套用至目前的應用程式,這個方法將會使用目前的視覺化樣式繪製核取方塊。 否則,它會使用傳統Windows樣式繪製核取方塊。

適用於

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

使用指定的文字、文字格式和影像,以及選擇性的焦點矩形,在指定的狀態和位置中繪製核取方塊控制項。

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)

參數

g
Graphics

繪製核取方塊所用的 Graphics

glyphLocation
Point

要在上面繪製核取方塊圖像的 Point

textBounds
Rectangle

要繪入 checkBoxTextRectangle

checkBoxText
String

隨核取方塊繪製的 String

font
Font

要套用至 checkBoxTextFont

flags
TextFormatFlags

TextFormatFlags 值的位元組合。

image
Image

隨核取方塊繪製的 Image

imageBounds
Rectangle

表示 image 維度的 Rectangle

focused
Boolean

true 表示繪製焦點矩形,否則為 false

state
CheckBoxState

CheckBoxState 的其中一個值,指定核取方塊的可見狀態。

備註

如果在作業系統中啟用視覺化樣式,而視覺化樣式會套用至目前的應用程式,這個方法將會使用目前的視覺化樣式繪製核取方塊。 否則,它會使用傳統Windows樣式繪製核取方塊。

適用於