CheckBox.Checked 속성

정의

CheckBox가 선택되어 있는지 여부를 나타내는 값을 가져오거나 설정합니다.Gets or set a value indicating whether the CheckBox is in the checked state.

public:
 property bool Checked { bool get(); void set(bool value); };
[System.ComponentModel.Bindable(true)]
[System.ComponentModel.SettingsBindable(true)]
public bool Checked { get; set; }
[System.ComponentModel.Bindable(true)]
public bool Checked { get; set; }
[<System.ComponentModel.Bindable(true)>]
[<System.ComponentModel.SettingsBindable(true)>]
member this.Checked : bool with get, set
[<System.ComponentModel.Bindable(true)>]
member this.Checked : bool with get, set
Public Property Checked As Boolean

속성 값

Boolean

CheckBox가 선택되어 있으면 true이고, 그렇지 않으면 false입니다.true if the CheckBox is in the checked state; otherwise, false. 기본값은 false입니다.The default value is false.


ThreeState 속성을 true로 설정하면 Checked 속성은 true 또는 CheckedCheckState에 대해 Indeterminate를 반환합니다.If the ThreeState property is set to true, the Checked property will return true for either a Checked or IndeterminateCheckState.

특성

예제

다음 코드 예제에서는 레이블에 있는 세 속성의 값을 표시 합니다.The following code example displays the values of three properties in a label. ThreeState속성은 true false 컨트롤의 교대로 반복 되는 및 CheckAlign 의 값 사이에서 교대로 반복 되는 및 ContentAlignment 사이를 대체 합니다 MiddleRight MiddleLeft .The ThreeState property alternates between true and false with alternating clicks of the control and the CheckAlign alternates between a ContentAlignment value of MiddleRight and MiddleLeft. 이 예제에서는 ThreeState 속성이 변경 되 고 컨트롤이 선택 될 때 속성 값이 어떻게 변경 되는지 보여 줍니다.This example shows how the property values change as the ThreeState property changes and the control is checked. 이 예제에서는 a가 필요 하 고 CheckBox , Label 모든가 Button 폼에서 인스턴스화되어, 레이블이 네임 스페이스에 대 한 참조 뿐만 아니라 세 줄의 텍스트를 표시할 수 있을 만큼 커야 합니다 System.Drawing .This example requires that a CheckBox, Label and Button have all been instantiated on a form and that the label is large enough to display three lines of text, as well as a reference to the System.Drawing namespace. 이 코드는 Click 컨트롤의 이벤트 처리기에서 호출 해야 합니다.This code should be called in the Click event handler of the control.

private:
   void AdjustMyCheckBoxProperties()
   {
      // Concatenate the property values together on three lines.
      label1->Text = String::Format( "ThreeState: {0}\nChecked: {1}\nCheckState: {2}",
         checkBox1->ThreeState, checkBox1->Checked, 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;
      }
   }
private void AdjustMyCheckBoxProperties()
 {
    // 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;
    }

    // Concatenate the property values together on three lines.
    label1.Text = "ThreeState: " + checkBox1.ThreeState.ToString() + "\n" +
                  "Checked: " + checkBox1.Checked.ToString() + "\n" +
                  "CheckState: " + checkBox1.CheckState.ToString(); 
 }
 
Private Sub AdjustMyCheckBoxProperties()

    ' 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

    ' 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()

End Sub

설명

값이 이면 true CheckBox 컨트롤의 부분이 확인 표시를 표시 합니다.When the value is true, the CheckBox portion of the control displays a check mark. Appearance속성이로 설정 된 경우 Button 가 인 경우 컨트롤이 오목한 모양으로 표시 Checked 됩니다 true false .If the Appearance property is set to Button, the control will appear sunken when Checked is true and raised like a standard button when false.

적용 대상

추가 정보