asp.NetDoDragDropメソッドの使用
14003 ワード
クラスライブラリの定義は次のとおりです.
ここで、dataパラメータはドラッグアンドドロップするデータであり、ドラッグ操作が別のプロセスのアプリケーションで相互操作する必要がある場合、dataが表すデータは、String、BitMap、またはMetaFile、またはISerializableまたはIDataObjectを実装するオブジェクトであるべきである.allowedEffectsパラメータはドラッグアンドドロップの効果を表し、列挙値(DragDropEffects)である.戻り値もDragDropEffects列挙値です.
DoDragDropメソッドを呼び出してデータオブジェクトをドラッグし始めると、DoDragDropsはドラッグアンドドロップ中に現在のカーソル位置のコントロールがターゲットを有効に配置しているかどうかを検出します.現在のカーソルの下にあるコントロールが有効な配置ターゲットの場合、GiveFeedBackイベントは指定したドラッグ&ドロップ効果で開始します.DoDragDropsメソッドは、現在の位置カーソルが有効なドラッグアンドドロップターゲットであるかどうかを検出するときに、カーソル位置、キーボードステータス、マウスステータスの変更を同時に追跡します.
(1)ウィンドウを移動した場合にDragLeaveイベントが発生する.
(2)別のコントロールに移動すると、そのコントロールのDragEnterイベントが発生する.
(3)マウスが移動しても1つのコントロールにとどまるとDragOverイベントが発生する.
キーボードまたはマウスの状態が変更されたことが検出された場合、ドラッグ・アンド・ドロップ・ソースのQueryContinueDragイベントが開始され、イベントのQueryContinueDragEventArgsのアクション属性値に基づいてドラッグの継続、データの配置、または操作のキャンセルが決定されます.
(1)アクション属性がContinueとして指定されている場合、DragOverイベントが発生する.
(2)アクション属性がDropとして指定されている場合、アプリケーションがデータを適切に操作できるように配置効果をソースに戻す.たとえば、移動操作の場合、データが切り取られます.
(3)DragActionの値がCancelであればDragLeaveイベントを起こす
csdnからサンプルコードを抜粋します.
次のコード例では、2つのListBoxコントロール間のドラッグアンドドロップ操作を示します.ドラッグ動作が開始されると、この例ではDoDragDropメソッドが呼び出されます.MouseDownイベントの間、マウスの位置から移動する距離がSystemInformationより大きい場合...DragSizeは、ドラッグ動作を開始します.IndexFromPointメソッドは、MouseDownイベント中にドラッグするアイテムのインデックスを決定するために使用します.
この例では、ドラッグアンドドロップ操作にカスタムカーソルを使用する方法も示します.この例では、アプリケーションディレクトリに2つのカーソルファイル:3 dwarroが存在することを要求する.Curと3 dwno.Curは、ドラッグカーソルをカスタマイズしたり、カーソルをオフにしたりするために使用されます.UseCustomCursorsCheckCheckBoxが選択されている場合は、カスタムカーソルを使用します.カスタムカーソルはGiveFeedbackイベントハンドラで設定します.
キーボードステータスは、右ListBoxのDragOverイベントハンドラで計算され、Shift、Ctrl、AltまたはCtrl+Altキーに基づく状態でどのドラッグ操作が行われるかを決定します.配置動作がListBoxで発生する位置もDragOverイベント中に決定される.配置するデータがStringでない場合、DragDropEffectsはDragEventArgsをsEffectはNoneに設定されています.最後に、ストップ状態がDropLocationLabelLabelに表示されます.
配置する右ListBox用のデータはDragDropイベントハンドラで決定され、ListBoxの適切な位置にString値が追加される.ドラッグ操作がフォームの枠線の外側に移動すると、QueryContinueDragイベントハンドラでドラッグ操作がキャンセルされます.
このようなドラッグアンドドロップ操作とマイクロソフトのサービス、コンテナモードの関係については、後で勉強します.
[UIPermissionAttribute(SecurityAction.Demand, Clipboard = UIPermissionClipboard.OwnClipboard)]
public DragDropEffects DoDragDrop(
Object data,
DragDropEffects allowedEffects
)
ここで、dataパラメータはドラッグアンドドロップするデータであり、ドラッグ操作が別のプロセスのアプリケーションで相互操作する必要がある場合、dataが表すデータは、String、BitMap、またはMetaFile、またはISerializableまたはIDataObjectを実装するオブジェクトであるべきである.allowedEffectsパラメータはドラッグアンドドロップの効果を表し、列挙値(DragDropEffects)である.戻り値もDragDropEffects列挙値です.
DoDragDropメソッドを呼び出してデータオブジェクトをドラッグし始めると、DoDragDropsはドラッグアンドドロップ中に現在のカーソル位置のコントロールがターゲットを有効に配置しているかどうかを検出します.現在のカーソルの下にあるコントロールが有効な配置ターゲットの場合、GiveFeedBackイベントは指定したドラッグ&ドロップ効果で開始します.DoDragDropsメソッドは、現在の位置カーソルが有効なドラッグアンドドロップターゲットであるかどうかを検出するときに、カーソル位置、キーボードステータス、マウスステータスの変更を同時に追跡します.
(1)ウィンドウを移動した場合にDragLeaveイベントが発生する.
(2)別のコントロールに移動すると、そのコントロールのDragEnterイベントが発生する.
(3)マウスが移動しても1つのコントロールにとどまるとDragOverイベントが発生する.
キーボードまたはマウスの状態が変更されたことが検出された場合、ドラッグ・アンド・ドロップ・ソースのQueryContinueDragイベントが開始され、イベントのQueryContinueDragEventArgsのアクション属性値に基づいてドラッグの継続、データの配置、または操作のキャンセルが決定されます.
(1)アクション属性がContinueとして指定されている場合、DragOverイベントが発生する.
(2)アクション属性がDropとして指定されている場合、アプリケーションがデータを適切に操作できるように配置効果をソースに戻す.たとえば、移動操作の場合、データが切り取られます.
(3)DragActionの値がCancelであればDragLeaveイベントを起こす
csdnからサンプルコードを抜粋します.
次のコード例では、2つのListBoxコントロール間のドラッグアンドドロップ操作を示します.ドラッグ動作が開始されると、この例ではDoDragDropメソッドが呼び出されます.MouseDownイベントの間、マウスの位置から移動する距離がSystemInformationより大きい場合...DragSizeは、ドラッグ動作を開始します.IndexFromPointメソッドは、MouseDownイベント中にドラッグするアイテムのインデックスを決定するために使用します.
この例では、ドラッグアンドドロップ操作にカスタムカーソルを使用する方法も示します.この例では、アプリケーションディレクトリに2つのカーソルファイル:3 dwarroが存在することを要求する.Curと3 dwno.Curは、ドラッグカーソルをカスタマイズしたり、カーソルをオフにしたりするために使用されます.UseCustomCursorsCheckCheckBoxが選択されている場合は、カスタムカーソルを使用します.カスタムカーソルはGiveFeedbackイベントハンドラで設定します.
キーボードステータスは、右ListBoxのDragOverイベントハンドラで計算され、Shift、Ctrl、AltまたはCtrl+Altキーに基づく状態でどのドラッグ操作が行われるかを決定します.配置動作がListBoxで発生する位置もDragOverイベント中に決定される.配置するデータがStringでない場合、DragDropEffectsはDragEventArgsをsEffectはNoneに設定されています.最後に、ストップ状態がDropLocationLabelLabelに表示されます.
配置する右ListBox用のデータはDragDropイベントハンドラで決定され、ListBoxの適切な位置にString値が追加される.ドラッグ操作がフォームの枠線の外側に移動すると、QueryContinueDragイベントハンドラでドラッグ操作がキャンセルされます.
using System;
using System.Drawing;
using System.Windows.Forms;
namespace Snip_DragNDrop
{
public class Form1 : System.Windows.Forms.Form
{
private System.Windows.Forms.ListBox ListDragSource;
private System.Windows.Forms.ListBox ListDragTarget;
private System.Windows.Forms.CheckBox UseCustomCursorsCheck;
private System.Windows.Forms.Label DropLocationLabel;
private int indexOfItemUnderMouseToDrag;
private int indexOfItemUnderMouseToDrop;
private Rectangle dragBoxFromMouseDown;
private Point screenOffset;
private Cursor MyNoDropCursor;
private Cursor MyNormalCursor;
/// The main entry point for the application.
[STAThread]
static void Main()
{
Application.Run(new Form1());
}
public Form1()
{
this.ListDragSource = new System.Windows.Forms.ListBox();
this.ListDragTarget = new System.Windows.Forms.ListBox();
this.UseCustomCursorsCheck = new System.Windows.Forms.CheckBox();
this.DropLocationLabel = new System.Windows.Forms.Label();
this.SuspendLayout();
// ListDragSource
this.ListDragSource.Items.AddRange(new object[] {"one", "two", "three", "four",
"five", "six", "seven", "eight",
"nine", "ten"});
this.ListDragSource.Location = new System.Drawing.Point(10, 17);
this.ListDragSource.Size = new System.Drawing.Size(120, 225);
this.ListDragSource.MouseDown += new System.Windows.Forms.MouseEventHandler(this.ListDragSource_MouseDown);
this.ListDragSource.QueryContinueDrag += new System.Windows.Forms.QueryContinueDragEventHandler(this.ListDragSource_QueryContinueDrag);
this.ListDragSource.MouseUp += new System.Windows.Forms.MouseEventHandler(this.ListDragSource_MouseUp);
this.ListDragSource.MouseMove += new System.Windows.Forms.MouseEventHandler(this.ListDragSource_MouseMove);
this.ListDragSource.GiveFeedback += new System.Windows.Forms.GiveFeedbackEventHandler(this.ListDragSource_GiveFeedback);
// ListDragTarget
this.ListDragTarget.AllowDrop = true;
this.ListDragTarget.Location = new System.Drawing.Point(154, 17);
this.ListDragTarget.Size = new System.Drawing.Size(120, 225);
this.ListDragTarget.DragOver += new System.Windows.Forms.DragEventHandler(this.ListDragTarget_DragOver);
this.ListDragTarget.DragDrop += new System.Windows.Forms.DragEventHandler(this.ListDragTarget_DragDrop);
this.ListDragTarget.DragEnter += new System.Windows.Forms.DragEventHandler(this.ListDragTarget_DragEnter);
this.ListDragTarget.DragLeave += new System.EventHandler(this.ListDragTarget_DragLeave);
// UseCustomCursorsCheck
this.UseCustomCursorsCheck.Location = new System.Drawing.Point(10, 243);
this.UseCustomCursorsCheck.Size = new System.Drawing.Size(137, 24);
this.UseCustomCursorsCheck.Text = "Use Custom Cursors";
// DropLocationLabel
this.DropLocationLabel.Location = new System.Drawing.Point(154, 245);
this.DropLocationLabel.Size = new System.Drawing.Size(137, 24);
this.DropLocationLabel.Text = "None";
// Form1
this.ClientSize = new System.Drawing.Size(292, 270);
this.Controls.AddRange(new System.Windows.Forms.Control[] {this.ListDragSource,
this.ListDragTarget, this.UseCustomCursorsCheck,
this.DropLocationLabel});
this.Text = "drag-and-drop Example";
this.ResumeLayout(false);
}
private void ListDragSource_MouseDown(object sender, System.Windows.Forms.MouseEventArgs e)
{
// Get the index of the item the mouse is below.
indexOfItemUnderMouseToDrag = ListDragSource.IndexFromPoint(e.X, e.Y);
if (indexOfItemUnderMouseToDrag != ListBox.NoMatches) {
// Remember the point where the mouse down occurred. The DragSize indicates
// the size that the mouse can move before a drag event should be started.
Size dragSize = SystemInformation.DragSize;
// Create a rectangle using the DragSize, with the mouse position being
// at the center of the rectangle.
dragBoxFromMouseDown = new Rectangle(new Point(e.X - (dragSize.Width /2),
e.Y - (dragSize.Height /2)), dragSize);
} else
// Reset the rectangle if the mouse is not over an item in the ListBox.
dragBoxFromMouseDown = Rectangle.Empty;
}
private void ListDragSource_MouseUp(object sender, System.Windows.Forms.MouseEventArgs e) {
// Reset the drag rectangle when the mouse button is raised.
dragBoxFromMouseDown = Rectangle.Empty;
}
private void ListDragSource_MouseMove(object sender, System.Windows.Forms.MouseEventArgs e)
{
if ((e.Button & MouseButtons.Left) == MouseButtons.Left) {
// If the mouse moves outside the rectangle, start the drag.
if (dragBoxFromMouseDown != Rectangle.Empty &&
!dragBoxFromMouseDown.Contains(e.X, e.Y)) {
// Create custom cursors for the drag-and-drop operation.
try {
MyNormalCursor = new Cursor("3dwarro.cur");
MyNoDropCursor = new Cursor("3dwno.cur");
} catch {
// An error occurred while attempting to load the cursors, so use
// standard cursors.
UseCustomCursorsCheck.Checked = false;
}finally {
// The screenOffset is used to account for any desktop bands
// that may be at the top or left side of the screen when
// determining when to cancel the drag drop operation.
screenOffset = SystemInformation.WorkingArea.Location;
// Proceed with the drag-and-drop, passing in the list item.
DragDropEffects dropEffect = ListDragSource.DoDragDrop(ListDragSource.Items[indexOfItemUnderMouseToDrag], DragDropEffects.All | DragDropEffects.Link);
// If the drag operation was a move then remove the item.
if (dropEffect == DragDropEffects.Move) {
ListDragSource.Items.RemoveAt(indexOfItemUnderMouseToDrag);
// Selects the previous item in the list as long as the list has an item.
if (indexOfItemUnderMouseToDrag > 0)
ListDragSource.SelectedIndex = indexOfItemUnderMouseToDrag -1;
else if (ListDragSource.Items.Count > 0)
// Selects the first item.
ListDragSource.SelectedIndex =0;
}
// Dispose of the cursors since they are no longer needed.
if (MyNormalCursor != null)
MyNormalCursor.Dispose();
if (MyNoDropCursor != null)
MyNoDropCursor.Dispose();
}
}
}
}
private void ListDragSource_GiveFeedback(object sender, System.Windows.Forms.GiveFeedbackEventArgs e)
{
// Use custom cursors if the check box is checked.
if (UseCustomCursorsCheck.Checked) {
// Sets the custom cursor based upon the effect.
e.UseDefaultCursors = false;
if ((e.Effect & DragDropEffects.Move) == DragDropEffects.Move)
Cursor.Current = MyNormalCursor;
else
Cursor.Current = MyNoDropCursor;
}
}
private void ListDragTarget_DragOver(object sender, System.Windows.Forms.DragEventArgs e)
{
// Determine whether string data exists in the drop data. If not, then
// the drop effect reflects that the drop cannot occur.
if (!e.Data.GetDataPresent(typeof(System.String))) {
e.Effect = DragDropEffects.None;
DropLocationLabel.Text = "None - no string data.";
return;
}
// Set the effect based upon the KeyState.
if ((e.KeyState & (8+32)) == (8+32) &&
(e.AllowedEffect & DragDropEffects.Link) == DragDropEffects.Link) {
// KeyState 8 + 32 = CTL + ALT
// Link drag-and-drop effect.
e.Effect = DragDropEffects.Link;
} else if ((e.KeyState & 32) == 32 &&
(e.AllowedEffect & DragDropEffects.Link) == DragDropEffects.Link) {
// ALT KeyState for link.
e.Effect = DragDropEffects.Link;
} else if ((e.KeyState & 4) == 4 &&
(e.AllowedEffect & DragDropEffects.Move) == DragDropEffects.Move) {
// SHIFT KeyState for move.
e.Effect = DragDropEffects.Move;
} else if ((e.KeyState & 8) == 8 &&
(e.AllowedEffect & DragDropEffects.Copy) == DragDropEffects.Copy) {
// CTL KeyState for copy.
e.Effect = DragDropEffects.Copy;
} else if ((e.AllowedEffect & DragDropEffects.Move) == DragDropEffects.Move) {
// By default, the drop action should be move, if allowed.
e.Effect = DragDropEffects.Move;
} else
e.Effect = DragDropEffects.None;
// Get the index of the item the mouse is below.
// The mouse locations are relative to the screen, so they must be
// converted to client coordinates.
indexOfItemUnderMouseToDrop =
ListDragTarget.IndexFromPoint(ListDragTarget.PointToClient(new Point(e.X, e.Y)));
// Updates the label text.
if (indexOfItemUnderMouseToDrop != ListBox.NoMatches){
DropLocationLabel.Text = "Drops before item #" + (indexOfItemUnderMouseToDrop + 1);
} else
DropLocationLabel.Text = "Drops at the end.";
}
private void ListDragTarget_DragDrop(object sender, System.Windows.Forms.DragEventArgs e)
{
// Ensure that the list item index is contained in the data.
if (e.Data.GetDataPresent(typeof(System.String))) {
Object item = (object)e.Data.GetData(typeof(System.String));
// Perform drag-and-drop, depending upon the effect.
if (e.Effect == DragDropEffects.Copy ||
e.Effect == DragDropEffects.Move) {
// Insert the item.
if (indexOfItemUnderMouseToDrop != ListBox.NoMatches)
ListDragTarget.Items.Insert(indexOfItemUnderMouseToDrop, item);
else
ListDragTarget.Items.Add(item);
}
}
// Reset the label text.
DropLocationLabel.Text = "None";
}
private void ListDragSource_QueryContinueDrag(object sender, System.Windows.Forms.QueryContinueDragEventArgs e) {
// Cancel the drag if the mouse moves off the form.
ListBox lb = sender as ListBox;
if (lb != null) {
Form f = lb.FindForm();
// Cancel the drag if the mouse moves off the form. The screenOffset
// takes into account any desktop bands that may be at the top or left
// side of the screen.
if (((Control.MousePosition.X - screenOffset.X) < f.DesktopBounds.Left) ||
((Control.MousePosition.X - screenOffset.X) > f.DesktopBounds.Right) ||
((Control.MousePosition.Y - screenOffset.Y) < f.DesktopBounds.Top) ||
((Control.MousePosition.Y - screenOffset.Y) > f.DesktopBounds.Bottom)) {
e.Action = DragAction.Cancel;
}
}
}
private void ListDragTarget_DragEnter(object sender, System.Windows.Forms.DragEventArgs e) {
// Reset the label text.
DropLocationLabel.Text = "None";
}
private void ListDragTarget_DragLeave(object sender, System.EventArgs e) {
// Reset the label text.
DropLocationLabel.Text = "None";
}
}
}
このようなドラッグアンドドロップ操作とマイクロソフトのサービス、コンテナモードの関係については、後で勉強します.