UIElement.AllowDrop Propiedad

Definición

Obtiene o establece un valor que indica si este elemento se puede usar como destino de una operación de arrastrar y colocar.Gets or sets a value indicating whether this element can be used as the target of a drag-and-drop operation. Es una propiedad de dependencia.This is a dependency property.

public:
 property bool AllowDrop { bool get(); void set(bool value); };
public bool AllowDrop { get; set; }
member this.AllowDrop : bool with get, set
Public Property AllowDrop As Boolean

Valor de propiedad

true si este elemento se puede usar como destino de una operación de arrastrar y colocar; de lo contrario, false.true if this element can be used as the target of a drag-and-drop operation; otherwise, false. El valor predeterminado es false.The default value is false.

Ejemplos

En el ejemplo de marcado siguiente se establece la propiedad AllowDrop true mediante un atributo en un TextBox, así como el establecimiento de otras propiedades relacionadas que en Aggregate permiten que TextBox sea el destino de un objeto de datos de texto de varias líneas cuando se arrastra.The following markup example sets the AllowDrop property true using an attribute on a TextBox, as well as setting some other related properties that in aggregate enable that TextBox to be the target of a multiline text data object when it is dragged in. Para obtener el ejemplo completo, vea cargar un ejemplo de archivo quitado.For the complete sample, see Load a Dropped File Sample.

<TextBox
  Name="tbDisplayFileContents" 
  Grid.Row="1" 
  AcceptsReturn="True" AcceptsTab="True" 
  AllowDrop="True" 
  BorderThickness="1" BorderBrush="Black" 
  HorizontalScrollBarVisibility="Auto" VerticalScrollBarVisibility="Auto"
  
  PreviewDragOver="ehDragOver" PreviewDrop="ehDrop"
/>

Comentarios

Las operaciones de arrastrar y colocar no están habilitadas de forma predeterminada y se deben habilitar deliberadamente estableciendo AllowDrop en true.Drag-and-drop operations are not enabled by default, and must be enabled deliberately by setting AllowDrop to true. Además de esta configuración básica, el comportamiento de arrastrar y colocar es completamente específico de la implementación y no está definido por UIElement ni cualquier otra clase de elemento base.Beyond this basic setting, drag-and-drop behavior is entirely implementation specific and is not defined by UIElement or any other base element class. Algunos controles, por ejemplo RichTextBox, tienen un comportamiento predeterminado.Certain controls, for example, RichTextBox, do have a default behavior. Para obtener más información sobre la función de arrastrar y colocar, vea información general sobre la función de arrastrar y colocar.For more information on drag and drop, see Drag and Drop Overview.

FrameworkElement invalida los metadatos de esta propiedad de dependencia en su implementación.FrameworkElement overrides the metadata for this dependency property in its implementation. En concreto, FrameworkElement designa esta propiedad para permitir la herencia de valores de propiedad (Inherits se true en los metadatos).Specifically, FrameworkElement designates this property to allow property value inheritance (Inherits is true in metadata). La herencia de valores de propiedad en este contexto significa que, si hay elementos secundarios sin ningún otro valor para AllowDrop asignadas a través de valores o estilos locales, el valor del elemento primario más cercano con este valor asignado (de nuevo, en los estilos, de forma predeterminada, o un valor local), el sistema de propiedades asignará el valor del elemento primario a todos los elementos secundarios sin asignar previamente.Property value inheritance in this context means that if there are child elements with no other value for AllowDrop assigned through local values or styles, the value of the nearest parent element with this value assigned (again, either in styles, by default values, or a local value), then the value from the parent element will be assigned to all previously unassigned child elements by the property system. En la práctica, esto significa que se puede especificar si se permiten las operaciones de colocación en el elemento raíz y ese valor se propagará a todos los elementos secundarios que no lo hayan asignado específicamente como false.In practice this means that you can specify whether to allow drop operations at the root element, and that value will propagate to all child elements that have not specifically assigned it as false.

Información sobre propiedades de dependenciaDependency Property Information

Campo de identificadorIdentifier field AllowDropProperty
Propiedades de metadatos establecidas en trueMetadata properties set to true NoneNone

Se aplica a