CheckBox.ThreeState プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

CheckBox.ThreeState プロパティ

CheckBox で 2 つではなく 3 つのチェックの状態が表示できるかどうかを示す値を取得または設定します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Property ThreeState As
 Boolean

Visual Basic (使用法)

Dim instance As CheckBox
Dim value As Boolean

value = instance.ThreeState

instance.ThreeState = value

public bool ThreeState { get;
 set; }

C++

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

/** @property */
public boolean get_ThreeState ()

/** @property */
public void set_ThreeState (boolean value)

JScript

public function get ThreeState
 () : boolean

public function set ThreeState
 (value : boolean)

プロパティ値
CheckBox が 3 つのチェックの状態を表示できる場合は true。それ以外の場合は false。既定値は false です。

解説

ThreeState プロパティを false に設定した場合、CheckState プロパティの System.Windows.Forms.CheckState 値はコードで Indeterminate に設定され、ユーザーとのやりとりでは設定されません。

使用例

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

Visual Basic

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

C++

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

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