Control.DoubleClick イベント

.NET Framework 4

その他のバージョン

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

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (System.Windows.Forms.dll 内)

構文

C++

コピー

public event EventHandler DoubleClick

解説

ユーザーのオペレーティングシステムのマウス設定に応じて、ダブルクリックが決定されます。ユーザーは、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 は該当するイベントを発生させます。

メモ

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) の一覧を次に示します。

Control	左マウスクリック	左マウスダブルクリック	右マウスクリック	右マウスダブルクリック	中央マウスクリック	中央マウスダブルクリック	XButton1 マウスクリック	XButton1 マウスダブルクリック	XButton2 マウスクリック	XButton2 マウスダブルクリック
MonthCalendar, DateTimePicker, RichTextBox, HScrollBar, VScrollBar	[none]	[none]	[none]	[none]	[none]	[none]	[none]	[none]	[none]	[none]
Button, CheckBox, RadioButton	クリックする場所	Click, Click	[none]	[none]	[none]	[none]	[none]	[none]	[none]	[none]
ListBox, CheckedListBox, ComboBox	クリックする場所	Click, DoubleClick	[none]	[none]	[none]	[none]	[none]	[none]	[none]	[none]
TextBox, DomainUpDown, NumericUpDown	クリックする場所	Click, DoubleClick	[none]	[none]	[none]	[none]	[none]	[none]	[none]	[none]
* TreeView, * ListView	クリックする場所	Click, DoubleClick	クリックする場所	Click, DoubleClick	[none]	[none]	[none]	[none]	[none]	[none]
ProgressBar, TrackBar	クリックする場所	Click, Click	クリックする場所	Click, Click	クリックする場所	Click, Click	クリックする場所	Click, Click	クリックする場所	Click, Click
Form, DataGrid, Label, LinkLabel, Panel, GroupBox, PictureBox, Splitter, StatusBar, ToolBar, TabPage, ** TabControl	クリックする場所	Click, DoubleClick	クリックする場所	Click, DoubleClick	クリックする場所	Click, DoubleClick	クリックする場所	Click, DoubleClick	クリックする場所	Click, DoubleClick

* マウスポインターが子オブジェクト (TreeNode または ListViewItem) の上になければなりません。

** TabControl には、TabPages コレクション内に少なくとも 1 つの TabPage が必要です。

例

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

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.");
    }
}

バージョン情報

.NET Framework

サポート対象: 4、3.5、3.0、2.0、1.1、1.0

.NET Framework Client Profile

サポート対象: 4、3.5 SP1

プラットフォーム

Windows 7, Windows Vista SP1 以降, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core はサポート対象外), Windows Server 2008 R2 (SP1 以降で Server Core をサポート), Windows Server 2003 SP2

.NET Framework では、各プラットフォームのすべてのバージョンはサポートしていません。サポートされているバージョンについては、「.NET Framework システム要件」を参照してください。

参照

Control クラス

System.Windows.Forms 名前空間

OnDoubleClick

StandardClick

StandardDoubleClick

Click

MouseClick

MouseDoubleClick

この情報は役に立ちましたか。はいいいえ

不正確

内容が浅い

もっとコード例が必要

翻訳品質の向上が必要

(残り 1500 文字)

コミュニティコンテンツ追加

FAQ