MenuItem.RadioCheck プロパティ

定義

MenuItem がチェックされている場合、チェック マークの代わりにオプション ボタンを表示するかどうかを示す値を取得または設定します。Gets or sets a value indicating whether the MenuItem, if checked, displays a radio-button instead of a check mark.

public:
 property bool RadioCheck { bool get(); void set(bool value); };
public bool RadioCheck { get; set; }
member this.RadioCheck : bool with get, set
Public Property RadioCheck As Boolean

プロパティ値

メニュー項目がチェックされた場合に、チェック マークの代わりにオプション ボタンが使用される場合は true。標準のチェック マークが表示される場合は falsetrue if a radio-button is to be used instead of a check mark; false if the standard check mark is to be displayed when the menu item is checked. 既定値は、false です。The default is false.

次のコード例ではChecked 、プロパティを使用して、アプリケーションの状態を変更します。The following code example uses the Checked property to change the state of an application. この例では、 TextBoxコントロールのテキストの色を指定するために使用されるメニュー項目のグループが用意されています。In the example, a group of menu items are provided that are used to specify the color for the text in an TextBox control. この例では、3つのメニュー項目のClickイベントによって、指定されたイベントハンドラーが使用されます。In the example, the event handler provided is used by the Click event of the three menu items. 各メニュー項目は、色menuItemRed menuItemGreen、、、またmenuItemBlueはを指定します。Each menu item specifies a color, menuItemRed, menuItemGreen, or menuItemBlue. イベントハンドラーは、どのメニュー項目がクリックされたかを判断し、選択したメニュー項目にチェックマークを付け、 TextBoxという名前textBox1のフォームコントロールのテキストの色を変更します。The event handler determines which menu item was clicked, places a checkmark to the selected menu item, and changes the text color of the form's TextBox control, named textBox1. また、この例でRadioCheckは、プロパティを使用して、相互に排他的なメニュー項目を表示するためにラジオボタンチェックを使用する方法を示しています。The example also uses the RadioCheck property to demonstrate how a radio-button check is used to show menu items that are mutually exclusive. この例では、 System.Drawingこのコードを含むフォームに名前空間が追加されている必要があります。This example requires that the System.Drawing namespace has been added to the form that contains this code.

public:
   // This method is called from the constructor of the form to set up the menu items.
   void ConfigureMyMenus()
   {
      /* Set all of these menu items to Radio-Button check marks so the user can see 
         that only one color can be selected at a time. */
      menuItemRed->RadioCheck = true;
      menuItemBlue->RadioCheck = true;
      menuItemGreen->RadioCheck = true;
   }

private:
   // The following event handler would be connected to three menu items.
   void MyMenuClick( Object^ sender, EventArgs^ e )
   {
      if ( sender == menuItemBlue )
      {
         // Set the checkmark for the menuItemBlue menu item.
         menuItemBlue->Checked = true;
         // Uncheck the menuItemRed and menuItemGreen menu items.
         menuItemRed->Checked = false;
         menuItemGreen->Checked = false;
         // Set the color of the text in the TextBox control to Blue.
         textBox1->ForeColor = Color::Blue;
      }
      else if ( sender == menuItemRed )
      {
         // Set the checkmark for the menuItemRed menu item.
         menuItemRed->Checked = true;
         // Uncheck the menuItemBlue and menuItemGreen menu items.
         menuItemBlue->Checked = false;
         menuItemGreen->Checked = false;
         // Set the color of the text in the TextBox control to Red.
         textBox1->ForeColor = Color::Red;
      }
      else
      {
         // Set the checkmark for the menuItemGreen menu item.
         menuItemGreen->Checked = true;
         // Uncheck the menuItemRed and menuItemGreen menu items.
         menuItemBlue->Checked = false;
         menuItemRed->Checked = false;
         // Set the color of the text in the TextBox control to Blue.
         textBox1->ForeColor = Color::Green;
      }
   }
// This method is called from the constructor of the form to set up the menu items.
public void ConfigureMyMenus()
{
   /* Set all of these menu items to Radio-Button check marks so the user can see 
      that only one color can be selected at a time. */
   menuItemRed.RadioCheck = true;
   menuItemBlue.RadioCheck = true;
   menuItemGreen.RadioCheck = true;
}

// The following event handler would be connected to three menu items.
private void MyMenuClick(Object sender, EventArgs e)
{
   if(sender == menuItemBlue)
   {
      // Set the checkmark for the menuItemBlue menu item.
      menuItemBlue.Checked = true;
      // Uncheck the menuItemRed and menuItemGreen menu items.
      menuItemRed.Checked = false;
      menuItemGreen.Checked = false;
      // Set the color of the text in the TextBox control to Blue.
      textBox1.ForeColor = Color.Blue;
   }
   else if(sender == menuItemRed)
   {
      // Set the checkmark for the menuItemRed menu item.
      menuItemRed.Checked = true;
      // Uncheck the menuItemBlue and menuItemGreen menu items.
      menuItemBlue.Checked = false;
      menuItemGreen.Checked = false;
      // Set the color of the text in the TextBox control to Red.
      textBox1.ForeColor = Color.Red;
   }
   else
   {
     // Set the checkmark for the menuItemGreen menu item.
      menuItemGreen.Checked = true;
      // Uncheck the menuItemRed and menuItemGreen menu items.
      menuItemBlue.Checked = false;
      menuItemRed.Checked = false;
      // Set the color of the text in the TextBox control to Blue.
      textBox1.ForeColor = Color.Green;
   }
}

' This method is called from the constructor of the form to set up the menu
' items.
Public Sub ConfigureMyMenus()
    ' Set all of these menu items to Radio-Button check marks so the user
    ' can see that only one color can be selected at a time. 
    menuItemRed.RadioCheck = True
    menuItemBlue.RadioCheck = True
    menuItemGreen.RadioCheck = True
End Sub    

' The following event handler would be connected to three menu items.
Private Sub MyMenuClick(sender As Object, e As EventArgs)
    If sender Is menuItemBlue Then
        ' Set the checkmark for the menuItemBlue menu item.
        menuItemBlue.Checked = True
        ' Uncheck the menuItemRed and menuItemGreen menu items.
        menuItemRed.Checked = False
        menuItemGreen.Checked = False
        ' Set the color of the text in the TextBox control to Blue.
        textBox1.ForeColor = Color.Blue
    Else
        If sender Is menuItemRed Then
            ' Set the checkmark for the menuItemRed menu item.
            menuItemRed.Checked = True
            ' Uncheck the menuItemBlue and menuItemGreen menu items.
            menuItemBlue.Checked = False
            menuItemGreen.Checked = False
            ' Set the color of the text in the TextBox control to Red.
            textBox1.ForeColor = Color.Red
        Else
            ' Set the checkmark for the menuItemGreen menu item.
            menuItemGreen.Checked = True
            ' Uncheck the menuItemRed and menuItemGreen menu items.
            menuItemBlue.Checked = False
            menuItemRed.Checked = False
            ' Set the color of the text in the TextBox control to Blue.
            textBox1.ForeColor = Color.Green
        End If
    End If
End Sub

注釈

チェックマークは、メニュー項目のグループに対して相互排他的な状態を示すとは限りません。Check marks do not necessarily imply a mutually exclusive state for a group of menu items. このプロパティを使用すると、メニュー項目のチェックマークが相互に排他的であることをユーザーに示すことができます。You can use this property to indicate to the user that the check mark of a menu item is mutually exclusive.

適用対象

こちらもご覧ください