在excel中怎么做邮箱网站,h5制作免费素材,常州市工程建设招标网,如何写一个ios的app本文内容 WPF 中的拖放支持数据传输拖放事件实现拖放拖放示例 本主题概述 Windows Presentation Foundation (WPF) 应用程序中的拖放支持。 拖放通常指一种数据传输方法#xff1a;使用鼠标#xff08;或一些其他指针设备#xff09;选择一个或多个对象#xff0c;将其拖…本文内容 WPF 中的拖放支持数据传输拖放事件实现拖放拖放示例 本主题概述 Windows Presentation Foundation (WPF) 应用程序中的拖放支持。 拖放通常指一种数据传输方法使用鼠标或一些其他指针设备选择一个或多个对象将其拖至用户界面 (UI) 中的某些所需拖放目标之上并放置。 1、WPF 中的拖放支持 拖放操作通常涉及两个参与方拖动对象所源自的拖动源和接收放置对象的拖放目标。 拖动源和放置目标可能是相同应用程序或不同应用程序中的 UI 元素。 可借助拖放操纵的对象的类型和数量是完全任意的。 例如文件、文件夹和内容选择是利用拖放操作操纵的一些常见对象。 拖放操作期间执行的特定操作特定于应用程序并且通常由上下文而定。 例如将选择的文件从一个文件夹拖动至相同存储设备上的另一个文件夹将默认移动文件而将文件从通用命名约定 (UNC) 共享拖动至本地文件夹将默认复制文件。 WPF 提供的拖放设施拥有高度的灵活性并可自定义以便支持各种拖放方案。 拖放支持在单个应用程序内或不同应用程序之间操作对象。 也完全支持 WPF 应用程序和其它 Windows 应用程序之间的拖放。 在 WPF 中任何 UIElement 或 ContentElement 都可以参与拖放。 拖放操作所需的事件和方法是在 DragDrop 类中定义的。 UIElement 和 ContentElement 类包含 DragDrop 附加事件的别名从而在 UIElement 或 ContentElement 作为基元素继承时这些事件出现在类成员列表中。 附加到这些事件的事件处理程序会附加到基础 DragDrop 附加事件并接收相同的事件数据实例。  2、数据传输 拖放属于广义的数据传输。 数据传输包括拖放和复制粘贴操作。 拖放操作类似于用于借助系统剪贴板将数据从一个对象或应用程序传输到另一个对象或应用程序的复制粘贴或剪切和粘贴操作。 这两种类型的操作均要求 提供数据的源对象。 用于临时存储传输的数据的方法。 接收数据的目标对象。 在复制粘贴操作中系统剪贴板用于临时存储传输的数据在拖放操作中DataObject 用于存储数据。 从概念上讲数据对象由一对或多对包含实际数据的 Object 和对应的数据格式标识符组成。 拖动源通过调用静态 DragDrop.DoDragDrop 方法和向其传递传输的数据来启动拖放操作。 如有必要DoDragDrop 方法将使 DataObject 中的数据自动换行。 为了更好地控制数据格式可将 DataObject 中的数据换行然后再将其传递至 DoDragDrop 方法。 拖放目标负责从 DataObject 中提取数据。  拖放操作的源和目标均为 UI 元素然而实际正在传输的数据通常不具有可视表示形式。 可以编写代码来提供拖动的数据的可视表示形式比如当在 Windows 资源管理器中拖动文件时会出现这种情况。 默认情况下通过更改光标将反馈提供给用户以便表示拖放操作将对数据产生的影响例如将移动数据还是复制数据。 拖放效果 拖放操作对传输的数据可具有不同的效果。 例如可以复制数据或者可以移动数据。 WPF 定义可用于指定拖放操作效果的 DragDropEffects 枚举。 在拖动源中可以指定源在 DoDragDrop 方法中允许的效果。 在拖放目标中可以指定目标在 Effects 类的 DragEventArgs 属性的中预期的效果。 当拖放目标指定其在 DragOver 事件中的预期效果时该信息将被传递回 GiveFeedback 事件中的拖动源。 拖动源则使用此信息通知用户拖放目标想要对数据产生的效果。 放置数据时拖放目标指定其在 Drop 事件中的实际效果。 该信息会作为 DoDragDrop 方法的返回值传递回拖动源。 如果拖放目标返回并不在 allowedEffects 拖动源列表中的效果那么将取消拖放操作且不会进行任何数据传输。 请务必记住在 WPF 中DragDropEffects 值仅用于提供有关拖放操作效果的拖动源和拖放目标之间的通信。 拖放操作的实际效果取决于你在应用程序中编写的相应代码。 例如拖放目标可以指定在其中放置数据的效果是移动数据。 然而若要移动数据必须将数据添加到目标元素并从源元素中删除数据。 源元素可能指示允许移动数据但是如果没有提供从源元素中删除数据的代码那么最终结果将为复制但不删除数据。 3、拖放事件 拖放操作支持事件驱动模型。 拖动源和拖放目标都使用一组标准的事件来处理拖放操作。 下表总结了标准的拖放事件。 它们是 DragDrop 类中的附加事件。  拖动源事件 展开表 事件总结GiveFeedback此事件在拖放操作期间持续发生并且使放置源能够向用户提供反馈信息。 通常通过更改鼠标指针外观来指示拖放目标允许的效果这一方式来提供这种反馈。 这是冒泡事件。QueryContinueDrag此事件于拖放操作期间键盘或鼠标按钮状态发生变化时发生并使放置源能够根据键/按钮状态取消拖放操作。 这是冒泡事件。PreviewGiveFeedbackGiveFeedback 的隧道版本。PreviewQueryContinueDragQueryContinueDrag 的隧道版本。 拖放目标事件 展开表 事件总结DragEnter将对象拖到拖放目标的边界中时发生此事件。 这是冒泡事件。DragLeave将对象拖出拖放目标边界时发生此事件。 这是冒泡事件。DragOver在拖放目标的边界内拖动移动对象时会持续发生此事件。 这是冒泡事件。Drop将对象放置在拖放目标上时发生此事件。 这是冒泡事件。PreviewDragEnterDragEnter 的隧道版本。PreviewDragLeaveDragLeave 的隧道版本。PreviewDragOverDragOver 的隧道版本。PreviewDropDrop 的隧道版本。 若要处理对象实例的拖放事件请为上表中所列的事件添加处理程序。 若要处理类级别的拖放事件请重写相应的虚拟 On*Event 和 On*PreviewEvent 方法。  4、实现拖放 UI 元素可以是拖动源、拖放目标或两者均可。 若要实现基本拖放请编写用于启动拖放操作和处理放置的数据的代码。 可以通过处理可选拖放事件增强拖放体验。 若要实现基本拖放将完成以下任务 标识将作为拖动源的元素。 拖动源可以是 UIElement 或 ContentElement。 在将启动拖放操作的拖动源上创建事件处理程序。 此事件通常是 MouseMove 事件。 在拖动源事件处理程序中调用 DoDragDrop 方法启动拖放操作。 在 DoDragDrop 调用中指定拖动源、要传输的数据和允许的效果。 标识将作为拖放目标的元素。 拖放目标可以是 UIElement 或 ContentElement。 在拖放目标上将 AllowDrop 属性设置为 true。 在拖放目标中创建 Drop 事件处理程序以处理放置的数据。 在 Drop 事件处理程序中利用 DragEventArgs 和 GetDataPresent 方法提取 GetData 中的数据。 在 Drop 事件处理程序中使用数据来执行所需的拖放操作。 可以通过创建自定义 DataObject 和处理可选拖动源和拖放目标事件来增加拖放实现如以下任务中所示 若要传输自定义数据或多个数据项请创建一个 DataObject以传递至 DoDragDrop 方法。 若要在拖动过程中执行其他操作请处理拖放目标上的 DragEnterDragOver 和 DragLeave 事件。 若要更改鼠标指针外观请处理拖动源上的 GiveFeedback 事件。 若要更改取消拖放操作的方式请处理拖动源上的 QueryContinueDrag 事件。 5、拖放示例 本节介绍如何实现 Ellipse 元素的拖放。 Ellipse 既是拖动源也是拖放目标。 传输的数据是椭圆形的 Fill 属性的字符串表示形式。 下面的 XAML 展示 Ellipse 元素和它处理的拖放相关事件。  Ellipse Height50 Width50 FillGreenMouseMoveellipse_MouseMoveGiveFeedbackellipse_GiveFeedbackAllowDropTrueDragEnterellipse_DragEnter DragLeaveellipse_DragLeaveDragOverellipse_DragOver Dropellipse_Drop /5.1 使元素作为拖动源 拖动源对象用于 标识拖动发生的时候。 启动拖放操作。 标识要传输的数据。 指定允许拖放操作对传输的数据产生的效果。 拖动源还可能针对允许的操作移动、复制、无向用户提供反馈并且可以根据额外用户输入如拖动过程中按 ESC 键取消拖放操作。 你的应用程序负责确定发生拖动的时间然后通过调用 DoDragDrop 方法启动拖放操作。 通常情况下这是在按下鼠标按钮的同时要拖动的元素上发生 MouseMove 事件时。 下面的示例显示了如何从 Ellipse 元素的 MouseMove 事件处理程序中启动拖放操作以将其作为拖动源。 传输的数据是椭圆形的 Fill 属性的字符串表示形式。 private void ellipse_MouseMove(object sender, MouseEventArgs e) {Ellipse ellipse sender as Ellipse;if (ellipse ! null e.LeftButton MouseButtonState.Pressed){DragDrop.DoDragDrop( ellipse,ellipse.Fill.ToString(),DragDropEffects.Copy);} }在 MouseMove 事件处理程序中调用 DoDragDrop 方法启动拖放操作。 DoDragDrop 方法采用三个参数 dragSource – 引用作为传输的数据的源的依赖项对象通常是 MouseMove 事件的源。 data - 包含传输的数据包装在 DataObject 中的对象。 allowedEffects - 指定拖放操作允许的效果的 DragDropEffects 枚举值之一。 任何可序列化对象都可以在 data 参数中传递。 如果数据尚未包装在 DataObject 中则它将自动包装在一个新的 DataObject 中。 若要传递多个数据项必须自行创建 DataObject并将其传递到 DoDragDrop 方法。  allowedEffects 参数用于指定拖动源允许拖放目标对传输的数据进行什么操作。 拖动源公共值为 CopyMove 和All。 备注 拖放目标也能够指定其对放置的数据的预期效果。 例如如果拖放目标不能识别要放置的数据类型则可以通过将其允许的效果设置为 None 来拒绝数据。 通常在其 DragOver 事件处理程序中进行此操作。 拖动源还可以可选地处理 GiveFeedback 和 QueryContinueDrag 事件。 这些事件都具有使用的默认处理程序除非将事件标记为已处理。 通常将忽略这些事件除非有更改其默认行为的特定需要。 对拖动源进行拖动时持续引发 GiveFeedback 事件。 此事件的默认处理程序会检查拖动源是否在有效放置目标之上。 如果是它会检查拖放目标的允许的效果。 然后向最终用户提供有关允许的放置效果的反馈。 通常通过将鼠标光标更改为非放置、复制或移动光标实现此操作。 仅在需要使用自定义光标向用户提供反馈时处理此事件。 在处理此事件时请务必将其标记为“已处理”以便默认处理程序不会替代你的处理程序。 对拖动源进行拖动时持续引发 QueryContinueDrag 事件。 你可以根据 ESC、SHIFT、CTRL 和 ALT 键以及鼠标按钮的状态处理此事件以确定结束拖放操作的操作。 此事件的默认处理程序在按下 ESC 键后取消拖放操作并且在释放鼠标按钮后放置数据。 注意 在拖放操作过程中将持续引发这些事件。 因此应避免事件处理程序中的资源密集型任务。 例如每次引发 GiveFeedback 事件时请使用缓存的光标而不是创建新光标。 5.2 使元素作为拖放目标 作为拖放目标的对象用于 指定其是有效的拖放目标。 当它拖动到目标之上时向拖动源作出响应。 检查传输的数据是否是它可以接收的格式。 处理已放置的数据。 若要指定一个元素是拖放目标请将其 AllowDrop 属性设置为 true。 然后元素中将引发拖放目标事件以便处理这些事件。 在拖放操作期间拖放目标上将依次发生以下事件 DragEnter DragOver DragLeave 或 Drop 将数据拖到拖放目标的边界中时发生 DragEnter 事件。 通常如果适用于你的应用程序可处理此事件以便提供拖放操作效果预览。 请勿设置 DragEventArgs.Effects 事件中的 DragEnter 属性因为在 DragOver 事件中该属性将被覆盖。 下面的示例演示 DragEnter 元素的 Ellipse 事件处理程序。 此代码通过保存当前的 Fill 画笔预览拖放操作的效果。 然后它使用 GetDataPresent 方法来检查是否已将 DataObject 拖动到包含可以转换为 Brush 的字符串数据的椭圆上方。 如果是则使用 GetData 方法提取数据。 然后将其转换为 Brush 并应用于椭圆。 在 DragLeave 事件处理程序中还原更改。 如果数据无法转换为 Brush则不执行任何操作。 private Brush _previousFill null; private void ellipse_DragEnter(object sender, DragEventArgs e) {Ellipse ellipse sender as Ellipse;if (ellipse ! null){// Save the current Fill brush so that you can revert back to this value in DragLeave._previousFill ellipse.Fill;// If the DataObject contains string data, extract it.if (e.Data.GetDataPresent(DataFormats.StringFormat)){string dataString (string)e.Data.GetData(DataFormats.StringFormat);// If the string can be converted into a Brush, convert it.BrushConverter converter new BrushConverter();if (converter.IsValid(dataString)){Brush newFill (Brush)converter.ConvertFromString(dataString);ellipse.Fill newFill;}}} }将数据拖动到拖放目标上方时持续发生 DragOver 事件。 此事件和拖动源上的 GiveFeedback 事件成对出现。 在 DragOver 事件处理程序中通常使用 GetDataPresent 和 GetData 方法来检查传输的数据是否是拖放目标可以处理的格式。 还可以检查是否已按下修改键这通常指示用户想进行移动操作还是复制操作。 执行这些检查后设置 DragEventArgs.Effects 属性以通知拖动源放置数据将产生的效果。 拖动源收到 GiveFeedback 事件参数中的此信息并且可以设置相应的光标以向用户提供反馈。 下面的示例演示 DragOver 元素的 Ellipse 事件处理程序。 此代码检查是否已将 DataObject 拖动到包含可以转换为 Brush 的字符串数据的椭圆上方。 如果是它会将 DragEventArgs.Effects 属性设置为 Copy。 这将向拖动源指示可以将数据复制到椭圆。 如果数据无法转换为 Brush则将 DragEventArgs.Effects 属性设置为 None。 这将向拖动源指示椭圆不是数据的有效拖放目标。 private void ellipse_DragOver(object sender, DragEventArgs e) {e.Effects DragDropEffects.None;// If the DataObject contains string data, extract it.if (e.Data.GetDataPresent(DataFormats.StringFormat)){string dataString (string)e.Data.GetData(DataFormats.StringFormat);// If the string can be converted into a Brush, allow copying.BrushConverter converter new BrushConverter();if (converter.IsValid(dataString)){e.Effects DragDropEffects.Copy | DragDropEffects.Move;}} }将数据拖出目标边界而未放置时发生 DragLeave 事件。 可以处理此事件以便撤销在 DragEnter 事件处理程序中进行的一切操作。 下面的示例演示 DragLeave 元素的 Ellipse 事件处理程序。 此代码通过将保存的 Brush 应用到椭圆来撤销 DragEnter 事件处理程序中执行的预览。 private void ellipse_DragLeave(object sender, DragEventArgs e) {Ellipse ellipse sender as Ellipse;if (ellipse ! null){ellipse.Fill _previousFill;} }数据放置在拖放目标上方时发生 Drop 事件默认情况下释放鼠标按钮时发生此事件。 在 Drop 事件处理程序中使用 GetData 方法提取 DataObject 中的传输的数据并执行应用程序所需的任何数据处理。 Drop 事件结束拖放操作。 下面的示例演示 Drop 元素的 Ellipse 事件处理程序。 此代码应用拖放操作的效果并且它类似于 DragEnter 事件处理程序中的代码。 它会检查是否将 DataObject 拖动到包含可以转换为 Brush 的字符串数据的椭圆上方。 如果是将 Brush 应用于椭圆。 如果数据无法转换为 Brush则不执行任何操作。 private void ellipse_Drop(object sender, DragEventArgs e) {Ellipse ellipse sender as Ellipse;if (ellipse ! null){// If the DataObject contains string data, extract it.if (e.Data.GetDataPresent(DataFormats.StringFormat)){string dataString (string)e.Data.GetData(DataFormats.StringFormat);// If the string can be converted into a Brush,// convert it and apply it to the ellipse.BrushConverter converter new BrushConverter();if (converter.IsValid(dataString)){Brush newFill (Brush)converter.ConvertFromString(dataString);ellipse.Fill newFill;}}} }