Control.DoubleClick イベント

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

Control.DoubleClick イベント

コントロールがダブルクリックされたときに発生します。

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

Visual Basic (宣言)

Public Event DoubleClick As
 EventHandler

Visual Basic (使用法)

Dim instance As Control
Dim handler As EventHandler

AddHandler instance.DoubleClick, handler

C#

public event EventHandler DoubleClick

C++

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

J#

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

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

JScript

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

解説

ユーザーのオペレーティング システムのマウス設定に応じて、ダブルクリックが決定されます。ユーザーは、2 回のクリックではなくダブルクリックと見なされるマウス ボタンのクリック間隔を設定できます。Click イベントは、コントロールがダブルクリックされるたびに発生します。たとえば、Form の Click イベントおよび DoubleClick イベントに対してそれぞれイベント ハンドラがある場合は、フォームがダブルクリックされ両方のメソッドが呼び出されると Click イベントと DoubleClick イベントが発生します。ダブルクリックされたコントロールが DoubleClick イベントをサポートしていない場合は、Click イベントが 2 回発生することがあります。

このイベントを発生させるには、ControlStyles の StandardDoubleClick 値および StandardClick 値を true に設定する必要があります。既存の Windows フォーム コントロールから継承している場合、これらの値は既に true に設定されていることがあります。

メモ
Click、DoubleClick、MouseDown、MouseUp、MouseHover、MouseEnter、MouseLeave、MouseMove の各イベントは、TabControl.TabPages コレクションに 1 つ以上の TabPage が存在しない限り、TabControl クラスで生成されません。コレクションに 1 つ以上の TabPage があり、ユーザーがタブ コントロールのヘッダー (TabPage の名前が表示される場所) と対話すると、TabControl が適切なイベントを発生させます。ただし、ユーザーとの対話がタブ ページのクライアント領域内の場合、TabPage は該当するイベントを発生させます。

イベント処理の詳細については、「イベントの利用」を参照してください。

継承時の注意 標準の Windows フォーム コントロールから継承し、ControlStyles の StandardClick 値または StandardDoubleClick 値を true に変更すると、コントロールが Click イベントまたは DoubleClick イベントをサポートしていない場合は、予測できない動作が行われたり、何の効果も得られなかったりします。 Windows フォーム コントロールと、指定したマウス アクションに対して発生するイベント (Click または DoubleClick) の一覧を次に示します。

コントロール	左マウス クリック	左マウス ダブルクリック	右マウス クリック	右マウス ダブルクリック	中央マウス クリック	中央マウス ダブルクリック	XButton1 マウス クリック	XButton1 マウス ダブルクリック	XButton2 マウス クリック	XButton2 マウス ダブルクリック
MonthCalendar, DateTimePicker, RichTextBox, HScrollBar, VScrollBar	なし	なし	なし	なし	なし	なし	なし	なし	なし	なし
Button, CheckBox, RadioButton	Click	Click, Click	なし	なし	なし	なし	なし	なし	なし	なし
ListBox, CheckedListBox, ComboBox	Click	Click, DoubleClick	なし	なし	なし	なし	なし	なし	なし	なし
TextBox, DomainUpDown, NumericUpDown	Click	Click, DoubleClick	なし	なし	なし	なし	なし	なし	なし	なし
* TreeView, * ListView	Click	Click, DoubleClick	Click	Click, DoubleClick	なし	なし	なし	なし	なし	なし
ProgressBar, TrackBar	Click	Click, Click	Click	Click, Click	Click	Click, Click	Click	Click, Click	Click	Click, Click
Form, DataGrid, Label, LinkLabel, Panel, GroupBox, PictureBox, Splitter, StatusBar, ToolBar, TabPage, ** TabControl	Click	Click, DoubleClick	Click	Click, DoubleClick	Click	Click, DoubleClick	Click	Click, DoubleClick	Click	Click, DoubleClick

* マウス ポインタが子オブジェクト (TreeNode または ListViewItem) の上になければなりません。 ** TabControl には、TabPages コレクション内に少なくとも 1 つの TabPage が必要です。

使用例

ListBox の DoubleClick イベントを使用して、ListBox に示すテキスト ファイルを TextBox コントロールに読み込むコード例を次に示します。

Visual Basic

' This example uses the DoubleClick event of a ListBox to load text
 files  
' listed in the ListBox into a TextBox control. This example
' assumes that the ListBox, named listBox1, contains a list of valid
 file 
' names with path and that this event handler method
' is connected to the DoublClick event of a ListBox control named listBox1.
' This example requires code access permission to access files.
Private Sub listBox1_DoubleClick(ByVal
 sender As Object, ByVal
 e As System.EventArgs) Handles listBox1.DoubleClick
    ' Get the name of the file to open from the ListBox.
    Dim file As [String] = listBox1.SelectedItem.ToString()

    Try
        ' Determine if the file exists before loading.
        If System.IO.File.Exists(file) Then
            ' Open the file and use a TextReader to read the contents
 into the TextBox.
            Dim myFile As New
 System.IO.FileInfo(listBox1.SelectedItem.ToString())
            Dim myData As System.IO.TextReader
 = myFile.OpenText()

            textBox1.Text = myData.ReadToEnd()
            myData.Close()
        End If
        ' Exception is thrown by the OpenText method of the FileInfo
 class.
    Catch
        MessageBox.Show("The file you specified does not exist.")
        ' Exception is thrown by the ReadToEnd method of the TextReader
 class.
    Catch
     MessageBox.Show("There was a problem loading the file into
 the TextBox. Ensure that the file is a valid text file.")
    End Try
End Sub

C#

// This example uses the DoubleClick event of a ListBox to load text
 files
// listed in the ListBox into a TextBox control. This example
// assumes that the ListBox, named listBox1, contains a list of valid
 file
// names with path and that this event handler method
// is connected to the DoublClick event of a ListBox control named listBox1.
// This example requires code access permission to access files.
private void listBox1_DoubleClick(object sender,
 System.EventArgs e)
{
    // Get the name of the file to open from the ListBox.
    String file = listBox1.SelectedItem.ToString();

    try
    {
        // Determine if the file exists before loading.
        if (System.IO.File.Exists(file))
        {
            // Open the file and use a TextReader to read the contents
 into the TextBox.
            System.IO.FileInfo myFile = new System.IO.FileInfo(listBox1.SelectedItem.ToString());
            System.IO.TextReader myData = myFile.OpenText();;

            textBox1.Text = myData.ReadToEnd();
            myData.Close();
        }
    }
        // Exception is thrown by the OpenText method of the FileInfo
 class.
    catch(System.IO.FileNotFoundException)
    {
        MessageBox.Show("The file you specified does not exist.");
    }
        // Exception is thrown by the ReadToEnd method of the TextReader
 class.
    catch(System.IO.IOException)
    {
        MessageBox.Show("There was a problem loading the file into the TextBox.
 Ensure that the file is a valid text file.");
    }
}

C++

   // This example uses the DoubleClick event of a ListBox to load text
 files
   // listed in the ListBox into a TextBox control. This example
   // assumes that the ListBox, named listBox1, contains a list of valid
 file
   // names with path and that this event handler method
   // is connected to the DoublClick event of a ListBox control named
 listBox1.
   // This example requires code access permission to access files.
private:
   void listBox1_DoubleClick( Object^ /*sender*/, System::EventArgs^
 /*e*/ )
   {
      // Get the name of the file to open from the ListBox.
      String^ file = listBox1->SelectedItem->ToString();
      try
      {
         // Determine if the file exists before loading.
         if ( System::IO::File::Exists( file ) )
         {
            
            // Open the file and use a TextReader to read the contents
 into the TextBox.
            System::IO::FileInfo^ myFile = gcnew System::IO::FileInfo( listBox1->SelectedItem->ToString()
 );
            System::IO::TextReader^ myData = myFile->OpenText();
            ;
            textBox1->Text = myData->ReadToEnd();
            myData->Close();
         }
      }
      // Exception is thrown by the OpenText method of the FileInfo
 class.
      catch ( System::IO::FileNotFoundException^ ) 
      {
         MessageBox::Show( "The file you specified does not exist." );
      }
      // Exception is thrown by the ReadToEnd method of the TextReader
 class.
      catch ( System::IO::IOException^ ) 
      {
         MessageBox::Show( "There was a problem loading the file into the TextBox.
 Ensure that the file is a valid text file." );
      }
   }

J#

// This example uses the DoubleClick event of a ListBox to load text
 files
// listed in the ListBox into a TextBox control. This example
// assumes that the ListBox, named listBox1, contains a list of valid
 file
// names with path and that this event handler method
// is connected to the DoublClick event of a ListBox control named listBox1.
// This example requires code access permission to access files.
private void listBox1_DoubleClick(Object sender,
 System.EventArgs e)
{
    // Get the name of the file to open from the ListBox.
    String file = listBox1.get_SelectedItem().ToString();
    try {
        // Determine if the file exists before loading.
        if (System.IO.File.Exists(file)) {
            // Open the file and use a TextReader to read the contents
 
            // into the TextBox.
            System.IO.FileInfo myFile = new System.IO.FileInfo(listBox1.
                get_SelectedItem().ToString());
            System.IO.TextReader myData = myFile.OpenText();
            textBox1.set_Text(myData.ReadToEnd());
            myData.Close();
        }
    }
    // Exception is thrown by the OpenText method of the FileInfo class.
    catch (System.IO.FileNotFoundException exp) {
        MessageBox.Show("The file you specified does not exist.");
    }
    // Exception is thrown by the ReadToEnd method of the TextReader
 class.
    catch (System.IO.IOException exp) {
        MessageBox.Show("There was a problem loading the file into the "
            + "TextBox. Ensure that the file is a valid text file.");
    }
} //listBox1_DoubleClick

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, 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

参照

関連項目
Control クラス
Control メンバ
System.Windows.Forms 名前空間
OnDoubleClick
StandardClick
StandardDoubleClick
Control.Click イベント
MouseClick
MouseDoubleClick