GroupBox クラスとは何？わかりやすく解説 Weblio辞書

すべての辞書から再検索する

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

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

GroupBox クラス

キャプション付きコントロールまたはキャプションなしコントロールのグループの周りにフレームを表示する Windows コントロールを表します。

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

Visual Basic (宣言)

<ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)> _
<ComVisibleAttribute(True)> _
Public Class GroupBox
    Inherits Control

Visual Basic (使用法)

Dim instance As GroupBox

[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)] 
[ComVisibleAttribute(true)] 
public class GroupBox : Control

C++

[ClassInterfaceAttribute(ClassInterfaceType::AutoDispatch)] 
[ComVisibleAttribute(true)] 
public ref class GroupBox : public
 Control

/** @attribute ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) */ 
/** @attribute ComVisibleAttribute(true) */ 
public class GroupBox extends Control

JScript

ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) 
ComVisibleAttribute(true) 
public class GroupBox extends
 Control

解説

GroupBox はキャプション付きコントロールまたはキャプションなしコントロールのグループの周りにフレームを表示します。GroupBox を使用して、フォーム上のコントロールのコレクションを論理的にグループ化します。グループボックスは、コントロールのグループを定義するために使用できるコンテナコントロールです。

グループボックスは、一般的に RadioButton コントロールの論理グループを格納するために使用されます。2 つのグループボックスのそれぞれに複数のオプションボタンがある場合、各ボタングループで一度に選択できるボタンは 1 つだけで、設定されるオプション値もそれぞれ 1 つです。

Controls プロパティの Add メソッドを使用して、コントロールを GroupBox に追加できます。

メモ
GroupBox コントロール内に格納されているコントロールだけが、選択またはフォーカスを受け取ることができます。GroupBox そのものを選択したり、フォーカスを与えたりすることはできません。Focus メソッドおよび Select メソッド対してこのコントロールが応答する方法の詳細については、CanFocus、CanSelect、Focused、ContainsFocus、Focus、Select の各 Control メンバのトピックを参照してください。

メモ

GroupBox コントロール内に格納されているコントロールだけが、選択またはフォーカスを受け取ることができます。GroupBox そのものを選択したり、フォーカスを与えたりすることはできません。Focus メソッドおよび Select メソッド対してこのコントロールが応答する方法の詳細については、CanFocus、CanSelect、Focused、ContainsFocus、Focus、Select の各 Control メンバのトピックを参照してください。

GroupBox には、スクロールバーを表示できません。スクロールバーを表示できる GroupBox のようなコントロールが必要な場合には、Panel コントロールのトピックを参照してください。

使用例

GroupBox と 2 つの RadioButton コントロールをインスタンス化および作成するコード例を次に示します。オプションボタンはグループボックスに追加され、グループボックスは Form に追加されます。

Visual Basic

Private Sub InitializeMyGroupBox()
   ' Create and initialize a GroupBox and two RadioButton controls.
   Dim groupBox1 As New
 GroupBox()
   Dim radioButton1 As New
 RadioButton()
   Dim radioButton2 As New
 RadioButton()

   ' Set the FlatStyle of the GroupBox.
   groupBox1.FlatStyle = FlatStyle.System    
        
   ' Add the RadioButtons to the GroupBox.
   groupBox1.Controls.Add(radioButton1)
   groupBox1.Controls.Add(radioButton2)
        
   ' Add the GroupBox to the Form.
    Controls.Add(groupBox1)
End Sub 'InitializeMyGroupBox

private void InitializeMyGroupBox()
{
   // Create and initialize a GroupBox and two RadioButton controls.
   GroupBox groupBox1 = new GroupBox();
   RadioButton radioButton1 = new RadioButton();
   RadioButton radioButton2 = new RadioButton();

   // Set the FlatStyle of the GroupBox.
   groupBox1.FlatStyle = FlatStyle.System;
 
   // Add the RadioButtons to the GroupBox.
   groupBox1.Controls.Add(radioButton1);
   groupBox1.Controls.Add(radioButton2);
 
   // Add the GroupBox to the Form.
   Controls.Add(groupBox1);
}

C++

private:
   void InitializeMyGroupBox()
   {
      // Create and initialize a GroupBox and two RadioButton controls.
      GroupBox^ groupBox1 = gcnew GroupBox;
      RadioButton^ radioButton1 = gcnew RadioButton;
      RadioButton^ radioButton2 = gcnew RadioButton;
      
      // Add the RadioButtons to the GroupBox.
      groupBox1->Controls->Add( radioButton1 );
      groupBox1->Controls->Add( radioButton2 );
      
      // Add the GroupBox to the Form.
      Controls->Add( groupBox1 );
   }

private void InitializeMyGroupBox()
{
    // Create and initialize a GroupBox and two RadioButton controls.
    GroupBox groupBox1 = new GroupBox();
    RadioButton radioButton1 = new RadioButton();
    RadioButton radioButton2 = new RadioButton();

    // Set the FlatStyle of the GroupBox.
    groupBox1.set_FlatStyle(FlatStyle.System);

    // Add the RadioButtons to the GroupBox.
    groupBox1.get_Controls().Add(radioButton1);
    groupBox1.get_Controls().Add(radioButton2);

    // Add the GroupBox to the Form.
    get_Controls().Add(groupBox1);
} //InitializeMyGroupBox

JScript

function InitializeMyGroupBox(){
   // Create and initialize a GroupBox and two RadioButton controls.
   var groupBox1 : GroupBox = new GroupBox()
   var radioButton1 : RadioButton = new RadioButton()
   var radioButton2 : RadioButton = new RadioButton()

   // Set the FlatStyle of the GroupBox.
   groupBox1.FlatStyle = FlatStyle.System    
        
   // Add the RadioButtons to the GroupBox.
   groupBox1.Controls.Add(radioButton1)
   groupBox1.Controls.Add(radioButton2)
        
   // Add the GroupBox to the Form.
    Controls.Add(groupBox1)
}

継承階層

System.Object
   System.MarshalByRefObject
     System.ComponentModel.Component
       System.Windows.Forms.Control
        System.Windows.Forms.GroupBox

スレッドセーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッドセーフです。インスタンスメンバの場合は、スレッドセーフであるとは限りません。

プラットフォーム

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