CheckBox.Checked プロパティ

チェック ボックスがオンになっているかどうかを示す値を取得または設定します。

Public Property Checked As Boolean
[C#]
public bool Checked {get; set;}
[C++]
public: __property bool get_Checked();public: __property void set_Checked(bool);
[JScript]
public function get Checked() : Boolean;public function set Checked(Boolean);

プロパティ値

チェック ボックスがオンである場合は true 。それ以外の場合は false 。既定値は false です。

メモ    ThreeState プロパティが true に設定されている場合、 Checked プロパティは Checked または Indeterminate CheckState について true を返します。

解説

値が true の場合は、コントロールのチェック ボックス部分にチェック マークが表示されます。 Appearance プロパティが Button に設定されていると、 Checked が true のときにはコントロールがくぼんで表示され、 false のときには標準のボタンのように浮き出て表示されます。

使用例

次のコード例では、ラベル内の 3 つのプロパティの値を示します。 ThreeState プロパティは、ボタンをクリックするごとに、 true と false の間で切り替わります。 CheckAlign は、 MiddleRight と MiddleLeft の間で切り替わります。この例では、 ThreeState プロパティが変更され、ボタンがチェックされた場合に、プロパティ値がどのように変化するかを示します。このコードは、 CheckBox 、 Label 、 Button がフォーム上ですべてインスタンス化されていること、および 3 行のテキストと System.Drawing 名前空間への参照をラベルに表示できることを前提にしています。このコードは、ボタンの Click イベント ハンドラで呼び出す必要があります。

 
Private Sub AdjustMyCheckBoxProperties()
    ' Concatenate the property values together on three lines.
    label1.Text = "ThreeState: " & checkBox1.ThreeState.ToString() & ControlChars.Cr & _
        "Checked: " & checkBox1.Checked.ToString() & ControlChars.Cr & _
        "CheckState: " & checkBox1.CheckState.ToString()
    
    ' Change the ThreeState and CheckAlign properties on every other click.
    If Not checkBox1.ThreeState Then
        checkBox1.ThreeState = True
        checkBox1.CheckAlign = ContentAlignment.MiddleRight
    Else
        checkBox1.ThreeState = False
        checkBox1.CheckAlign = ContentAlignment.MiddleLeft
    End If
End Sub 'AdjustMyCheckBoxProperties

[C#] 
private void AdjustMyCheckBoxProperties()
 {
    // Concatenate the property values together on three lines.
    label1.Text = "ThreeState: " + checkBox1.ThreeState.ToString() + "\n" +
                  "Checked: " + checkBox1.Checked.ToString() + "\n" +
                  "CheckState: " + checkBox1.CheckState.ToString(); 
    
    // Change the ThreeState and CheckAlign properties on every other click.
    if (!checkBox1.ThreeState)
    {
       checkBox1.ThreeState = true;
       checkBox1.CheckAlign = ContentAlignment.MiddleRight;
    }
    else
    {
       checkBox1.ThreeState = false;
       checkBox1.CheckAlign = ContentAlignment.MiddleLeft;
    }
 }
 

[C++] 
private:
void AdjustMyCheckBoxProperties()
 {
    // Concatenate the property values together on three lines.
    label1->Text = String::Format( S"ThreeState: {0}\nChecked: {1}\nCheckState: {2}",
        __box(checkBox1->ThreeState), __box(checkBox1->Checked), __box(checkBox1->CheckState)); 
    
    // Change the ThreeState and CheckAlign properties on every other click.
    if (!checkBox1->ThreeState)
    {
       checkBox1->ThreeState = true;
       checkBox1->CheckAlign = ContentAlignment::MiddleRight;
    }
    else
    {
       checkBox1->ThreeState = false;
       checkBox1->CheckAlign = ContentAlignment::MiddleLeft;
    }
 }
 

[JScript] 
private function AdjustMyCheckBoxProperties()
 {
    // Concatenate the property values together on three lines.
    label1.Text = "ThreeState: " + checkBox1.ThreeState.ToString() + "\n" +
                  "Checked: " + checkBox1.Checked.ToString() + "\n" +
                  "CheckState: " + checkBox1.CheckState.ToString(); 
    
    // Change the ThreeState and CheckAlign properties on every other click.
    if (!checkBox1.ThreeState)
    {
       checkBox1.ThreeState = true;
       checkBox1.CheckAlign = ContentAlignment.MiddleRight;
    }
    else
    {
       checkBox1.ThreeState = false;
       checkBox1.CheckAlign = ContentAlignment.MiddleLeft;
    }
 }
 

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

参照

CheckBox クラス | CheckBox メンバ | System.Windows.Forms 名前空間 | ThreeState | CheckState