CheckBox.CheckState 속성

아티클
08/21/2007

CheckBox의 상태를 가져오거나 설정합니다.

네임스페이스: System.Windows.Forms
어셈블리: System.Windows.Forms(system.windows.forms.dll)

구문

‘선언
<BindableAttribute(True)> _
Public Property CheckState As CheckState
‘사용 방법
Dim instance As CheckBox
Dim value As CheckState

value = instance.CheckState

instance.CheckState = value

[BindableAttribute(true)] 
public CheckState CheckState { get; set; }

[BindableAttribute(true)] 
public:
property CheckState CheckState {
    CheckState get ();
    void set (CheckState value);
}

/** @property */
public CheckState get_CheckState ()

/** @property */
public void set_CheckState (CheckState value)

public function get CheckState () : CheckState

public function set CheckState (value : CheckState)

속성 값

CheckState 열거형 값 중 하나입니다. 기본값은 Unchecked입니다.

예외

예외 형식	조건
InvalidEnumArgumentException	할당된 값이 CheckState 열거형 값이 아닌 경우

설명

ThreeState 속성을 false로 설정한 경우 코드에서 CheckState 속성 값을 CheckState.Indeterminate로만 설정할 수 있으며 사용자 상호 작용의 영향을 받지 않습니다.

다음 표에서는 컨트롤의 CheckBox.Appearance 속성을 Normal 및 Button으로 각각 설정했을 경우의 CheckBox 컨트롤 System.Windows.Forms.Appearance를 보여 줍니다.

CheckState	Appearance.Normal	Appearance.Button
Checked	CheckBox에 확인 표시가 표시됩니다.	컨트롤이 오목하게 표시됩니다.
Unchecked	CheckBox이 비어 있는 경우	컨트롤이 볼록하게 표시됩니다.
Indeterminate	CheckBox에 확인 표시가 표시되며 회색으로 표시됩니다.	컨트롤이 평면으로 표시됩니다.

예제

다음 코드 예제에서는 세 개의 속성 값을 한 레이블에 표시합니다. 컨트롤을 클릭할 때마다 ThreeState 속성은 true 또는 false로 변경되며 CheckAlign은 System.Drawing.ContentAlignment의 MiddleRight 또는 MiddleLeft 값으로 변경됩니다. 다음 예제에서는 ThreeState 속성이 변경되고 컨트롤을 선택하면 속성 값이 어떻게 변경되는지 보여 줍니다. 이 예제에서는 CheckBox, Label 및 Button이 폼에서 모두 인스턴스화되었고, 레이블에 세 줄의 텍스트와 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

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;
    }
 }

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()
{
    // Concatenate the property values together on three lines.
    label1.set_Text("ThreeState: " + checkBox1.get_ThreeState() + "\n"
        + "Checked: " + checkBox1.get_Checked() + "\n" 
        + "CheckState: " + checkBox1.get_CheckState());

    //Change the ThreeState and CheckAlign properties on every other click.
    if (!(checkBox1.get_ThreeState())) {
        checkBox1.set_ThreeState(true);
        checkBox1.set_CheckAlign(ContentAlignment.MiddleRight);
    }
    else {
        checkBox1.set_ThreeState(false);
        checkBox1.set_CheckAlign(ContentAlignment.MiddleLeft);
    }
} //AdjustMyCheckBoxProperties

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 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework에서 모든 플래폼의 모든 버전을 지원하지는 않습니다. 지원되는 버전의 목록은 시스템 요구 사항을 참조하십시오.

버전 정보

.NET Framework

2.0, 1.1, 1.0에서 지원

.NET Compact Framework

2.0, 1.0에서 지원

참고 항목

참조

CheckBox 클래스
CheckBox 멤버
System.Windows.Forms 네임스페이스
CheckBox.Checked 속성
ThreeState

다음을 통해 공유