MenuItem.Checked プロパティ

定義

メニュー項目のテキストの横にチェック マークを表示するかどうかを示す値を取得または設定します。Gets or sets a value indicating whether a check mark appears next to the text of the menu item.

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

プロパティ値

メニュー項目の隣にチェック マークがある場合は true。それ以外の場合は falsetrue if there is a check mark next to the menu item; otherwise, false. 既定値は、false です。The default is false.

例外

MenuItem はトップレベル メニューであるか、子があります。The MenuItem is a top-level menu or has children.

次のコード例ではChecked 、プロパティを使用して、アプリケーションの状態を指定しています。The following code example uses the Checked property to provide the state in an application. この例では、メニュー項目のグループを使用して、 TextBoxコントロール内のテキストの色を指定します。In this example, a group of menu items are used to specify the color for the text in a TextBox control. 指定されたイベントハンドラーは、 Click 3 つのメニュー項目のイベントによって使用されます。The event handler provided is used by the Click event of three menu items. 各メニュー項目は、テキストの色menuItemRed 、(赤) menuItemGreen 、(緑)、 menuItemBlueまたは (青) を指定します。Each menu item specifies a text color, menuItemRed (Red), menuItemGreen (Green), or menuItemBlue (Blue). イベントハンドラーは、どのメニュー項目がクリックされたかを判断し、選択されたメニュー項目にチェックマークを配置TextBoxし、フォームのコントロールのテキストの色を変更します。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. この例では、 System.Drawingこのコードが配置されているフォームに名前空間が追加されている必要があります。The example requires that the System.Drawing namespace has been added to the form that this code is placed in. また、この例ではTextBox 、という名前のであるというtextBox1形式のにが追加されている必要もあります。The example also requires that a TextBox has been added to the form that this example code is located in that is named textBox1.

private:
   // The following event handler would be connected to three menu items.
   void MyMenuClick( Object^ sender, EventArgs^ e )
   {
      // Determine if clicked menu item is the Blue menu item.
      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.
         menuItemGreen->Checked = true;
         // Uncheck the menuItemRed and menuItemBlue menu items.
         menuItemBlue->Checked = false;
         menuItemRed->Checked = false;
         // Set the color of the text in the TextBox control to Blue.
         textBox1->ForeColor = Color::Green;
      }
   }
// The following event handler would be connected to three menu items.
 private void MyMenuClick(Object sender, EventArgs e)
 {
    // Determine if clicked menu item is the Blue menu item.
    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.
       menuItemGreen.Checked = true;
       // Uncheck the menuItemRed and menuItemBlue menu items.
       menuItemBlue.Checked = false;
       menuItemRed.Checked = false;
       // Set the color of the text in the TextBox control to Blue.
       textBox1.ForeColor = Color.Green;
    }
 }

' The following event handler would be connected to three menu items.
Private Sub MyMenuClick(sender As Object, e As EventArgs)
    ' Determine if clicked menu item is the Blue menu item.
    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.
            menuItemGreen.Checked = True
            ' Uncheck the menuItemRed and menuItemBlue 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

注釈

Checkedプロパティをメニュー内の他のメニュー項目と組み合わせて使用すると、アプリケーションの状態を指定できます。You can use the Checked property in combination with other menu items in a menu to provide state for an application. たとえば、項目グループのメニュー項目にチェックマークを付けて、アプリケーションのテキストに表示されるフォントのサイズを特定できます。For example, you can place a check mark on a menu item in a group of items to identify the size of the font to be displayed for the text in an application. また、 Checkedプロパティを使用して、相互に排他的なメニュー項目のグループで選択したメニュー項目を識別することもできます。You can also use the Checked property to identify the selected menu item in a group of mutually exclusive menu items.

注意

トップレベルのメニュー項目のtrue場合、このプロパティをに設定することはできません。This property cannot be set to true for top-level menu items.

適用対象