ToolStripButton.CheckOnClick Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ruft einen Wert ab, der angibt, ob der ToolStripButton automatisch als gedrückt oder nicht gedrückt angezeigt werden soll, wenn darauf geklickt wird, oder legt diesen Wert fest.

public:
 property bool CheckOnClick { bool get(); void set(bool value); };

public bool CheckOnClick { get; set; }

member this.CheckOnClick : bool with get, set

Public Property CheckOnClick As Boolean

Eigenschaftswert

Boolean

true, wenn der ToolStripButton automatisch als gedrückt oder nicht gedrückt angezeigt werden soll, wenn darauf geklickt wird; andernfalls false. Der Standardwert ist false.

Beispiele

Im folgenden Codebeispiel wird die CheckOnClick -Eigenschaft auf true festgelegt und die Checked -Eigenschaft in einem CheckedChanged -Ereignis verwendet, um die Schriftart des Schaltflächentexts fett zu ändern, wenn auf die Schaltfläche geklickt wird.

ToolStripButton^ boldButton;

void InitializeBoldButton()
{
    boldButton = gcnew ToolStripButton;
    boldButton->Text = "B";
    boldButton->CheckOnClick = true;
    boldButton->CheckedChanged  += gcnew EventHandler(this, 
        &Form1::boldButtonCheckedChanged);
    toolStrip1->Items->Add(boldButton);
}

void boldButtonCheckedChanged(Object^ sender, EventArgs^ e)
{
    if (boldButton->Checked)
    { 
        this->Font= gcnew System::Drawing::Font(this->Font, 
            FontStyle::Bold);
    }
    else
    { 
        this->Font = gcnew System::Drawing::Font(this->Font, 
            FontStyle::Regular);
    }
}


//   internal:

internal ToolStripButton boldButton;

private void InitializeBoldButton()
{
    boldButton = new ToolStripButton();
    boldButton.Text = "B";
    boldButton.CheckOnClick = true;
    toolStrip1.Items.Add(boldButton);
}

private void boldButton_CheckedChanged(object sender, EventArgs e)
{
    if (boldButton.Checked)
    {
        this.Font = new Font(this.Font, FontStyle.Bold);
    }
    else
    {
        this.Font = new Font(this.Font, FontStyle.Regular);
    }
}

Friend WithEvents boldButton As ToolStripButton

Private Sub InitializeBoldButton()
    boldButton = New ToolStripButton()
    boldButton.Text = "B"
    boldButton.CheckOnClick = True
    toolStrip1.Items.Add(boldButton)

End Sub

Private Sub boldButton_CheckedChanged(ByVal sender As [Object], _
    ByVal e As EventArgs) Handles boldButton.CheckedChanged
    If boldButton.Checked Then
        Me.Font = New Font(Me.Font, FontStyle.Bold)
    Else
        Me.Font = New Font(Me.Font, FontStyle.Regular)
    End If

End Sub