Excel VBA リストボックスのイベント

スポンサーリンク

リストボックスのイベント一覧

イベント名イベントの発生
AfterUpdateリストボックス内のデータを選択した直後
BeforeDragOver「ドラッグ&ドロップ」操作の実行中に発生
BeforeDropOrPasteデータをドロップするか貼り付けるときに発生
BeforeUpdate
リストボックス内のデータを選択した直前
ChangeリストボックスのValueプロパティに変更があったとき
Clickリストボックスのリストをクリックしたとき
DblClickリストボックスをダブルクリックして離したとき
Enterリストボックスが他のコントロールからフォーカスを受け取る直前
Errorエラー情報を呼び出し元プログラムに返すことができないとき
Exitリストボックスがフォーカスを失い他のコントロールに移動する直前
KeyDownリストボックスにフォーカスがあるときにキーを押したタイミング
KeyPressリストボックスにフォーカスがあるときにキーが押されたあと
KeyUpリストボックスにフォーカスがあるときに押されたキーが戻るとき
MouseDownリストボックス上でマウスボタンがクリックされたとき
MouseMoveリストボックス上にマウスポインターが移動したとき
MouseUpリストボックス上でマウスボタンをクリックしてボタンを離したとき

リストボックスのプロパティについては
リストボックスのプロパティ」をご覧ください。


AfterUpdate【アフターアップデイト】イベント

AfterUpdate【アフターアップデイト】 イベントはリストボックス内のデータを選択した直後に発生します。

AfterUpdate【アフターアップデイト】イベントの書式

Private Sub ListBox_AfterUpdate()


BeforeDragOver【ビフォアドラッグオーバー】イベント

「ドラッグ&ドロップ」操作の実行中に発生します。。

BeforeDragOver【ビフォアドラッグオーバー】イベントの書式と引数の説明

Private Sub ListBox_BeforeDragOver(ByVal Cancel As MSForms.ReturnBoolean,
ByVal Data As MSForms.DataObject,
ByVal X As Single,
ByVal Y As Single,
ByVal DragState As MSForms.fmDragState,
ByVal Effect As MSForms.ReturnEffect,
ByVal Shift As Integer)

  • Cancel【キャンセル】
    Trueを設定した場合は「アプリケーション」がイベントを処理することを表します。
  • Data【データ】
    ドラッグ アンド ドロップ操作でドラッグされているデータを返します。
  • X【エックス】
    リストボックスが押された水平位置をポイント単位で単精度浮動小数点型 (Single)の値で返します。
  • Y【ワイ】
    リストボックスが押された垂直位置をポイント単位で単精度浮動小数点型 (Single)の値で返します。
  • DragState【ドラッグステイツ】
    ドラッグされているデータの遷移状態を設定します。以下の定数を指定します。

    定数内容
    fmDragStateEnter0マウス ポインターはターゲットの範囲の中にあります。
    fmDragStateLeave1マウス ポインターはターゲットの範囲の外にあります。
    fmDragStateOver2マウス ポインターは新しい位置にありますが
    同じターゲットの範囲の中にあります。
  • Effect【エフェクト】
    ドロップ ソースでサポートされる操作を設定します。

    設定値内容
    fmDropEffectNone0ドロップ ソースをドロップ ターゲットに
    コピーも移動もしません。
    fmDropEffectCopy1ドロップ ソースをドロップ ターゲットに
    コピーします。
    fmDropEffectMove2ドロップ ソースをドロップ ターゲットに
    移動します。
    fmDropEffectCopyOrMove3ドロップ ソースをドロップ ターゲットに
    コピーまたは移動します。
  • Shift【シフト】
    キーが押されたときの「Shiht」キー、「Ctrl」キー、「Alt」キーが押されている状況を整数値で返します。すべて押されていないときは「0」を返します。複数選択されている場合は整数値を加算した値が返されます。

    戻り値押されているキー
    1「Shiht」キー
    2「Ctrl」キー
    4「Alt」キー

※このイベントは、マウス ポインターが有効なターゲットに入ったときターゲットから出たとき、またはターゲットの上にあるときにポインターを監視するために使用します。ドラッグ アンド ドロップ操作の実行中は、ユーザーがマウスを動かしたりマウス ボタンを押したり離したりすると、このイベントが発生します。このイベントを受け取るターゲット オブジェクトマウス ポインターの位置によって決まります。マウス ポインターの状態は、DragState 引数を調べることによって判定できます。


BeforeDropOrPaste【ビフォアドロップオーアールペースト】イベント

データをドロップするか貼り付けようとすると発生します。

BeforeDropOrPaste【ビフォアドロップオーアールペースト】イベントの書式と引数の説明

Private Sub ListBox_BeforeDropOrPaste(ByVal Cancel As MSForms.ReturnBoolean,
ByVal Action As MSForms.fmAction,
ByVal Data As MSForms.DataObject,
ByVal X As Single,
ByVal Y As Single,
ByVal Effect As MSForms.ReturnEffect,
ByVal Shift As Integer)

  • Action【アクショオン】
    現在のキーボード設定に基づく保留中のドラッグ アンド ドロップ操作の結果を示します。

    定数内容
    fmActionPaste2選択されているオブジェクトを
    ドロップ ターゲットに貼り付けます。
    fmActionDragDrop3ユーザーがオブジェクトをソースから
    ドロップ ターゲットにドラッグして
    ドロップ ターゲットにドロップしたことを示します。

    他の設定値については
    BeforeDragOver【ビフォアドラッグオーバー】イベントをご覧ください。


BeforeUpdate【ビフォアアップデイト】イベント

BeforeUpdate【ビフォアアップデイト】イベントはリストボックス内のデータを選択した直後に発生します。

BeforeUpdate【ビフォアアップデイト】イベントの書式と引数の説明

Private Sub ListBox_BeforeUpdate(ByVal Cancel As MSForms.ReturnBoolean)

  • Cancel【キャンセル】
    Trueを設定した場合は「アプリケーション」がイベントを処理することを表します。

Change【チェンジ】イベント

Change【チェンジ】 イベントはリストボックスのValueプロパティ(内容)が変更されたときに発生します。既定のイベントになります。

Change【チェンジ】イベントの書式

Private Sub ListBox_Change()


Click【クリック】イベント

Click【クリック】イベントは、リストボックスのリストをクリックしてボタンを離したときに発生します。

Click【クリック】イベントの書式

Private Sub ListBox_Click()


DblClick【ダブルクリック】イベント

DblClick【ダブルクリック】 イベントは、マウス ポインターをリストボックスの上に置き
システムで設定されているダブルクリックの間隔内にマウスの左ボタンを押してから離す動作を2 回続けて行ったときに発生します。

DblClick【ダブルクリック】イベントの書式と引数の説明

Private Sub ListBox_DblClick(ByVal Cancel As MSForms.ReturnBoolean)

  • Cancel【キャンセル】
    Trueを設定した場合はアプリケーションがイベントを処理することを示します。

Enter【エンター】イベント

Enter【エンター】 イベントはリストボックスが他のコントロールからフォーカスを受け取る直前に発生します。

Enter【エンター】イベントの書式

Private Sub ListBox_Enter()


Error【エラー】イベント

Error【エラー】 イベントは、リストボックスがエラーを検出しエラー情報を呼び出し元プログラムに返すことができないときに発生します。

Error【エラー】イベントの書式と引数の説明

Private Sub ListBox_Error(ByVal Number As Integer,
ByVal Description As MSForms.ReturnString,
ByVal SCode As Long,
ByVal Source As String,
ByVal HelpFile As String,
ByVal HelpContext As Long,
ByVal CancelDisplay As MSForms.ReturnBoolean)

  • Number【ナンバー】
    コントロールがエラーの識別に使用する一意の値を指定します。
  • Description【ディスクリプション】
    エラーの説明です。
  • SCode【エスコード】
    エラーの OLE ステータス コードを指定します。
  • Source【ソース】
    イベントを生成したコントロールを示す文字列です。
  • HelpFile【ヘルプファイル】
    エラーを説明しているヘルプ ファイルの完全修飾パス名を指定します。
  • HelpContext【ヘルプコンテキスト】
    エラーの説明が含まれるヘルプ ファイル トピックのコンテキスト ID を指定します。
  • CancelDisplay【キャンセルディスプレイ】
    メッセージ ボックスにエラー文字列を表示するかどうかを指定します。既定値はFalseで表示しません。表示する場合はTrueを指定します。

Exit【エグジット】イベント

Exit【エグジット】イベントはリストボックスがフォーカスを失い他のコントロールに移動する直前に発生します。

Exit【エクジット】イベントの書式と引数の説明

Private Sub ListBox_Exit(ByVal Cancel As MSForms.ReturnBoolean)

  • Cancel【キャンセル】
    Trueを指定するとアプリケーションがイベントを処理しフォーカスは現在のコントロールに保持されることを示します。

KeyDown【キーダウン】イベント

KeyDown【キーダウン】 イベントは、リストボックスにフォーカスがある状態で、キーを押したタイミングで発生します。

KeyDown【キーダウン】イベントの書式と引数の説明

Private Sub ListBox_KeyDown(ByVal KeyCode As MSForms.ReturnInteger, ByVal Shift As Integer)

  • KeyCode【キーコード】
    押されたキーを整数値で返します。

    戻り値押されたキー
    1左マウスボタン
    2マウスの右ボタン
    3CANCELキー
    4マウスの中ボタン
    8バックスペースキー
    9Tabキー
    12クリアキー
    13キーを入力してください
    16シフトキー
    17CTRLキー
    18MENUキー
    19PAUSEキー
    20CAPS LOCKキー
    27ESCキー
    32スペースバーキー
    33ページアップキー
    34ページダウンキー
    35ENDキー
    36HOMEキー
    37左矢印キー
    38上向き矢印キー
    39右矢印キー
    40下矢印キー
    41SELECTキー
    42PRINT SCREENキー
    43EXECUTEキー
    44SNAPSHOTキー
    45INSキー
    46DELキー
    47HELPキー
    65Aキー
    66Bキー
    67Cキー
    68Dキー
    69Eキー
    70Fキー
    71Gキー
    72Hキー
    73Iキー
    74Jキー
    75Kキー
    76Lキー
    77Mキー
    78Nキー
    79Oキー
    80Pキー
    81Qキー
    82Rキー
    83Sキー
    84Tキー
    85Uキー
    86Vキー
    87Wキー
    88Xキー
    89Yキー
    90Zキー
    480キー
    491キー
    502キー
    513キー
    524キー
    535キー
    546キー
    557キー
    568キー
    579キー
    960キー
    971キー
    982キー
    993キー
    1004キー
    1015キー
    1026キー
    1037キー
    1048キー
    1059キー
    106(*)キー
    107(+)キー
    108ENTERキー
    109( – )キー
    110(。)キー
    111(/)キー
    112F1キー
    113F2キー
    114F3キー
    115F4キー
    116F5キー
    117F6キー
    118F7キー
    119F8キー
    120F9キー
    121F10キー
    122F11キー
    123F12キー
    124F13キー
    125F14キー
    126F15キー
    127F16キー
    144NUM LOCKキー
  • Shift【シフト】
    キーが押されたときの「Shiht」キー、「Ctrl」キー、「Alt」キーが押されている状況を整数値で返します。すべて押されていないときは「0」を返します。複数選択されている場合は整数値を加算した値が返されます。

    戻り値押されているキー
    1「Shiht」キー
    2「Ctrl」キー
    4「Alt」キー

KeyPress【キープレス】イベント

KeyPress【キープレイス】 イベントは、リストボックスにフォーカスがある状態でANSI コードに対応するキーまたはキーの組み合わせを押して離したときに発生します。

KeyPress【キープレス】イベントの書式と引数の説明

Private Sub ListBox_KeyPress(ByVal KeyAscii As MSForms.ReturnInteger)

  • KeyAscii【キーアスキー】
    ANSI キー コードを返します。引数 KeyAscii に 0 を設定するとキー操作がキャンセルされオブジェクトはキーが押されたことを認識しません。

KeyUp【キーアップ】イベント

KeyUp 【キーアップ】イベントは、リストボックスにフォーカスがある状態で、キーを押して離したときに発生します。

KeyUp【キーアップ】イベントの書式と引数の説明

Private Sub ListBox_KeyUp(ByVal KeyCode As MSForms.ReturnInteger, ByVal Shift As Integer)

KeyDown【キーダウン】イベントの設定値を参照してください

MouseDown【マウスダウン】イベント

MouseDown【マウスダウン】イベントは、マウスポインターがリストボックス上にあるときにマウスボタンを押したときに発生します。

MouseDown【マウスダウン】イベントの書式と引数の説明

Private Sub ListBox_MouseDown(ByVal Button As Integer,
ByVal Shift As Integer,
ByVal X As Single,
ByVal Y As Single)

  • Button【ボタン】
    押されたボタンを整数値で返します。

    戻り値押されたボタン
    1マウス左ボタン
    2マウス右ボタン
    4マウス中央ボタン
  • Shift【シフト】
    マウスボタンが押されたときの「Shiht」キー、「Ctrl」キー、「Alt」キーが押されている状況を整数値で返します。すべて押されていないときは「0」を返します。複数選択されている場合は整数値を加算した値が返されます。

    戻り値押されているキー
    1「Shiht」キー
    2「Ctrl」キー
    4「Alt」キー
  • X【エックス】
    リストボックスが押された水平位置をポイント単位で単精度浮動小数点型 (Single)の値で返します。
  • Y【ワイ】
    リストボックスが押された垂直位置をポイント単位で単精度浮動小数点型 (Single)の値で返します。

MouseMove【マウスムーブ】イベント

MouseMove【マウスムーブ】イベントは、マウスポインターがリストボックス上に移動したときに発生します。

MouseMove【マウスムーブ】イベントの書式と引数の説明

Private Sub ListBox_MouseMove(ByVal Button As Integer,
ByVal Shift As Integer,
ByVal X As Single,
ByVal Y As Single)

MouseDown【マウスダウン】イベントと同じなので参照してください。

MouseUp【マウスアップ】イベント

MouseUp【マウスアップ】イベントは、リストボックス上でマウスボタンをクリックしてボタンを離したときに発生します。

MouseUp【マウスアップ】イベントの書式と引数の説明

Private Sub ListBox_MouseUp(ByVal Button As Integer,
ByVal Shift As Integer,
ByVal X As Single,
ByVal Y As Single)

MouseDown【マウスダウン】イベントと同じなので参照してください。

以上で、リストボックスのイベントについての解説を終了します。ありがとうございました。

スポンサーリンク

関連記事・広告