UIElement.AllowDrop UIElement.AllowDrop UIElement.AllowDrop UIElement.AllowDrop Property

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

Ejemplo de marcado siguiente se establece la AllowDrop propiedad true utilizando un atributo en un TextBox, así como alguna otra configuración relacionada con las propiedades que, en total, permiten que TextBox a ser el destino de un objeto de datos de texto multilínea 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 un ejemplo completo, vea cargar una muestra del 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

Operaciones de arrastrar y colocar no están habilitadas de forma predeterminada y debe habilitarse deliberadamente estableciendo AllowDrop a true.Drag-and-drop operations are not enabled by default, and must be enabled deliberately by setting AllowDrop to true. Más allá de esta configuración básica, el comportamiento de arrastrar y colocar es completamente la implementación específica y no se define mediante UIElement o 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 acerca de arrastrar y colocar, vea arrastrar y colocar, información general sobre.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 es true en los metadatos).Specifically, FrameworkElement designates this property to allow property value inheritance (Inherits is true in metadata). Herencia de valores de propiedad en este contexto significa que si hay elementos secundarios con ningún otro valor para AllowDrop asignado a través de los valores locales o los estilos, el valor del elemento primario más cercano con asignado este valor (de nuevo, ya sea en estilos, de forma predeterminada los valores, o un valor local), a continuación, se asignará el valor del elemento primario para todos los elementos secundarios no asignados previamente por el sistema de propiedades.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 puede especificar si se permiten las operaciones de colocar en el elemento raíz, y que el valor se propagará a todos los elementos secundarios que tengan específicamente no lo ha asignado 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
Establecen las propiedades de metadatos en trueMetadata properties set to true NoneNone

Se aplica a