MenuItem.Popup イベント

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

MenuItem.Popup イベント

メニュー項目のリストが表示される前に発生します。

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

Visual Basic (宣言)

Public Event Popup As EventHandler

Visual Basic (使用法)

Dim instance As MenuItem
Dim handler As EventHandler

AddHandler instance.Popup, handler

C#

public event EventHandler Popup

C++

public:
event EventHandler^ Popup {
    void add (EventHandler^ value);
    void remove (EventHandler^ value);
}

J#

/** @event */
public void add_Popup (EventHandler value)

/** @event */
public void remove_Popup (EventHandler value)

JScript

JScript では、イベントは使用できますが、新規に宣言することはできません。

解説

このイベントは、メニュー項目に表示するサブメニュー項目があるときだけ発生します。このイベント ハンドラを使用すると、メニュー項目が表示される前に、アプリケーションの状態に基づいて、そのメニュー項目を追加、削除、有効化、無効化したり、そのメニュー項目のチェック ボックスをオンまたはオフにしたりできます。イベント処理の詳細については、「イベントの利用」を参照してください。

使用例

Popup イベントを使用して、切り取り、コピー、削除の操作をサポートする MenuItem オブジェクトが、メニューが表示される前に有効になるかどうかを判断する方法を次のコード例に示します。この例では、MenuItem オブジェクトが使用できるようになる前に、フォーム上の TextBox コントロールの textBox1 が使用可能で、入力フォーカスがあり、テキストが選択されているかどうかを判断します。ここでは、menuCut、menuCopy、および menuDelete という名前の 3 つの MenuItem オブジェクトが作成されている必要があります。

Visual Basic

Private Sub PopupMyMenu(ByVal
 sender As Object, ByVal
 e As System.EventArgs) Handles menuEdit.Popup
   If textBox1.Enabled = False OrElse
 textBox1.Focused = False OrElse textBox1.SelectedText.Length
 = 0 Then
      menuCut.Enabled = False
      menuCopy.Enabled = False
      menuDelete.Enabled = False
   Else
      menuCut.Enabled = True
      menuCopy.Enabled = True
      menuDelete.Enabled = True
   End If
End Sub

C#

private void PopupMyMenu(object sender, System.EventArgs
 e)
{
   if (textBox1.Enabled == false || textBox1.Focused
 == false ||
      textBox1.SelectedText.Length == 0)
   {
      menuCut.Enabled = false;
      menuCopy.Enabled = false;
      menuDelete.Enabled = false;
   }
   else
   {
      menuCut.Enabled = true;
      menuCopy.Enabled = true;
      menuDelete.Enabled = true;
   }
}

C++

private:
   void PopupMyMenu( Object^ /*sender*/, System::EventArgs^ /*e*/
 )
   {
      if ( textBox1->Enabled == false ||
 textBox1->Focused == false || textBox1->SelectedText->Length
 == 0 )
      {
         menuCut->Enabled = false;
         menuCopy->Enabled = false;
         menuDelete->Enabled = false;
      }
      else
      {
         menuCut->Enabled = true;
         menuCopy->Enabled = true;
         menuDelete->Enabled = true;
      }
   }

J#

private void PopupMyMenu(Object sender, System.EventArgs
 e)
{
    if (textBox1.get_Enabled() == false ||
 textBox1.get_Focused() == false 
        || textBox1.get_SelectedText().get_Length() == 0) {
        menuCut.set_Enabled(false);
        menuCopy.set_Enabled(false);
        menuDelete.set_Enabled(false);
    }
    else {
        menuCut.set_Enabled(true);
        menuCopy.set_Enabled(true);
        menuDelete.set_Enabled(true);
    }
} //PopupMyMenu

プラットフォーム

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

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
MenuItem クラス
MenuItem メンバ
System.Windows.Forms 名前空間