MenuItem.Checked プロパティ

メニュー項目のテキストの横にチェック マークを表示するかどうかを示す値を取得または設定します。

Public Property Checked As Boolean
[C#]
public bool Checked {get; set;}
[C++]
public: __property bool get_Checked();public: __property void set_Checked(bool);
[JScript]
public function get Checked() : Boolean;public function set Checked(Boolean);

プロパティ値

メニュー項目の横にチェック マークを表示する場合は true 。それ以外の場合は false 。既定値は false です。

解説

メニュー内のその他のメニュー項目と組み合わせて Checked プロパティを使用すると、アプリケーションの状態を示すことができます。たとえば、メニュー項目のグループ内にある 1 つの項目にチェック マークを付け、アプリケーションのテキスト表示に使用するフォントのサイズを示すことができます。 Checked プロパティを使用すると、一度に 1 つしか選択できない複数のメニュー項目の中で、選択されているメニュー項目を識別できます。

メモ   トップレベルのメニュー項目の場合、このプロパティは true に設定できません。

使用例

[Visual Basic, C#, C++] Checked プロパティを使用して、アプリケーションの状態を示す例を次に示します。この例では、グループにまとめた複数のメニュー項目を使用して、 TextBox コントロール内のテキストの色を指定します。指定されているイベント ハンドラは、3 つのメニュー項目の Click イベントによって使用されます。各メニュー項目は、テキストの色として menuItemRed (赤)、 menuItemGreen (緑)、 menuItemBlue (青) のいずれかを指定します。イベント ハンドラは、クリックされたメニュー項目を判断し、選択されたそのメニュー項目にチェック マークを付け、フォームの TextBox コントロール内にあるテキストの色を変更します。この例では、このコードが記述されているフォームに System.Drawing 名前空間が追加されていることを前提にしています。さらに、そのフォームに textBox1 という名前の TextBox が追加されていることも前提にしています。

 
' 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


[C#] 
// 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;
    }
 }


[C++] 
// 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;
    }
 }

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

参照

MenuItem クラス | MenuItem メンバ | System.Windows.Forms 名前空間