CheckBoxRenderer.DrawCheckBox 方法

參考

定義

命名空間:: System.Windows.Forms

組件:: System.Windows.Forms.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

繪製核取方塊控制項。

多載

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

要繪入 checkBoxText 的 Rectangle。

checkBoxText: String

隨核取方塊繪製的 String。

font: Font

要套用至 checkBoxText 的 Font。

focused: Boolean

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

state: CheckBoxState

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

備註

適用於

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

要繪入 checkBoxText 的 Rectangle。

checkBoxText: String

隨核取方塊繪製的 String。

font: Font

要套用至 checkBoxText 的 Font。

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

備註

適用於

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

要繪入 checkBoxText 的 Rectangle。

checkBoxText: String

隨核取方塊繪製的 String。

font: Font

要套用至 checkBoxText 的 Font。

image: Image

隨核取方塊繪製的 Image。

imageBounds: Rectangle

表示 image 維度的 Rectangle。

focused: Boolean

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

state: CheckBoxState

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

備註

適用於

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

要繪入 checkBoxText 的 Rectangle。

checkBoxText: String

隨核取方塊繪製的 String。

font: Font

要套用至 checkBoxText 的 Font。

flags: TextFormatFlags

TextFormatFlags 值的位元組合。

image: Image

隨核取方塊繪製的 Image。

imageBounds: Rectangle

表示 image 維度的 Rectangle。

focused: Boolean

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

state: CheckBoxState

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

備註

適用於

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)

參數

備註

適用於

其他資源