BeforeDragOver イベント
ドラッグ アンド ドロップ操作の実行中に発生します。
構文
Frame の場合
Private Subオブジェクト _BeforeDragOver( ByValCancelas MSForms.ReturnBoolean,
Ctrl コントロールとして、
ByValDataAs DataObject,
ByValXAs Single,
ByValYAs Single,
ByValDragStatefmDragState として、
MSForms.ReturnEffect としてのByVal効果、
ByValShiftAs fmShiftState)
MultiPage の場合
Private Subobject _BeforeDragOver(indexAs Long,
BYValCancelAS MSForms.ReturnBoolean,
Ctrl コントロールとして、
ByValDataAs DataObject,
ByValXAs Single,
ByValYAs Single,
ByValDragStatefmDragState として、
MSForms.ReturnEffect としてのByVal効果、
ByValShiftAs fmShiftState)
TabStrip の場合
Private Subobject _BeforeDragOver(indexAs Long,
BYValCancelAS MSForms.ReturnBoolean,
ByValDataAs DataObject,
ByValXAs Single,
ByValYAs Single,
ByValDragStatefmDragState として、
MSForms.ReturnEffect としてのByVal効果、
ByValShiftAs fmShiftState)
その他のコントロールの場合
Private Subオブジェクト _BeforeDragOver( ByValCancelas MSForms.ReturnBoolean,
ByValDataAs DataObject,
ByValXAs Single,
ByValYAs Single,
ByValDragStatefmDragState として、
MSForms.ReturnEffect としてのByVal効果、
ByValShiftAs fmShiftState)
BeforeDragOver イベントの構文には、次の指定項目があります。
| パーツ | 説明 |
|---|---|
| object | 必須。 有効なオブジェクト名です。 |
| index | 必須です。 ドラッグ アンド ドロップ操作が影響を与える MultiPage の Page のインデックス。 |
| Cancel | 必須。 イベントのステータスを指定します。 False は、コントロールがイベントを処理することを示します (既定)。 True は、アプリケーションがイベントを処理することを示します。 |
| ctrl | 必須。 ドラッグされているコントロール。 |
| Data | 必須。 ドラッグ アンド ドロップ操作でドラッグされたデータです。 データは DataObject にパッケージ化されます。 |
| X、Y | 必須。 コントロールの位置の水平座標と垂直座標。 どちらの座標もポイント数で表されます。 X 座標はコントロールの左端から距離で、Y 座標はコントロールの上端からの距離です。 |
| DragState | 必須。 ドラッグされているデータの遷移状態。 |
| Effect | 必須です。 ドロップ ソースでサポートされる操作。 |
| Shift | 必須。 Shift キー、Ctrl キー、および Alt キーの状態を指定します。 |
Settings
DragState の設定値は次のとおりです。
| 定数 | 値 | 説明 |
|---|---|---|
| fmDragStateEnter | 0 | マウス ポインターはターゲットの範囲の中にあります。 |
| fmDragStateLeave | 1 | マウス ポインターはターゲットの範囲の外にあります。 |
| fmDragStateOver | 2 | マウス ポインターは新しい位置にありますが、同じターゲットの範囲の中にあります。 |
Effect の設定値は次のとおりです。
| 定数 | 値 | 説明 |
|---|---|---|
| fmDropEffectNone | 0 | ドロップ ソースをドロップ ターゲットにコピーも移動もしません。 |
| fmDropEffectCopy | 1 | ドロップ ソースをドロップ ターゲットにコピーします。 |
| fmDropEffectMove | 2 | ドロップ ソースをドロップ ターゲットに移動します。 |
| fmDropEffectCopyOrMove | 3 | ドロップ ソースをドロップ ターゲットにコピーまたは移動します。 |
Shift の設定値は次のとおりです。
| 定数 | 値 | 説明 |
|---|---|---|
| fmShiftMask | 1 | Shift キーが押されました。 |
| fmCtrlMask | 2 | Ctrl キーが押されました。 |
| fmAltMask | 4 | Alt キーが押されました。 |
注釈
このイベントは、マウス ポインターが有効なターゲットに入ったとき、ターゲットから出たとき、またはターゲットの上にあるときに、ポインターを監視するために使用します。 ドラッグ アンド ドロップ操作の実行中は、ユーザーがマウスを動かしたり、マウス ボタンを押したり離したりすると、このイベントが発生します。 このイベントを受け取るターゲット オブジェクトは、マウス ポインターの位置によって決まります。 マウス ポインターの状態は、DragState 引数を調べることによって判定できます。
コントロールがこのイベントを処理する場合は、Effect 引数を使用して、実行するドラッグ アンド ドロップ アクションを特定できます。
Effect の設定値が fmDropEffectCopyOrMove の場合は、ドロップ ソースがコピー (fmDropEffectCopy)、移動 (fmDropEffectMove)、またはキャンセル (fmDropEffectNone) をサポートします。
Effect の設定値が fmDropEffectCopy の場合は、ドロップ ソースがコピーまたはキャンセル (fmDropEffectNone) をサポートします。
Effect の設定値が fmDropEffectMove の場合は、ドロップ ソースが移動またはキャンセル (fmDropEffectNone) をサポートします。
Effect が fmDropEffectNone に設定されている場合、ドロップ ソースは取り消し操作をサポートします。
ほとんどのコントロールはドラッグ アンド ドロップをサポートしていませんが 、Cancel は False (既定の設定) です。 つまり、コントロールはコントロール上の何かをドラッグ またはドロップしようとしても拒否され、BeforeDropOrPaste イベントは開始されません。 TextBox コントロールと ComboBox コントロールは、これに対する例外です。これらのコントロールは、Cancel が False の場合でもドラッグ アンド ドロップ操作をサポートします。
関連項目
サポートとフィードバック
Office VBA またはこの説明書に関するご質問やフィードバックがありますか？ サポートの受け方およびフィードバックをお寄せいただく方法のガイダンスについては、Office VBA のサポートおよびフィードバックを参照してください。