UIElement.AllowDrop Property

Definition

Obtém ou define um valor indicando se um elemento pode ser usado como o destino de uma operação de arrastar e soltar.Gets or sets a value indicating whether this element can be used as the target of a drag-and-drop operation. É uma propriedade de dependência.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

Property Value

Boolean

true se um elemento pode ser usado como o destino de uma operação do tipo "arrastar e soltar"; caso contrário, false.true if this element can be used as the target of a drag-and-drop operation; otherwise, false. O valor padrão é false.The default value is false.

Examples

O exemplo de marcação a seguir define a propriedade AllowDrop true usando um atributo em um TextBox, bem como definir outras propriedades relacionadas que, em agregação, permitem que TextBox seja o destino de um objeto de dados de texto multilinha quando ele é arrastado no.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 obter o exemplo completo, consulte carregar um exemplo de arquivo Descartado.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"
/>

Remarks

As operações de arrastar e soltar não são habilitadas por padrão e devem ser habilitadas deliberadamente com a definição de AllowDrop para true.Drag-and-drop operations are not enabled by default, and must be enabled deliberately by setting AllowDrop to true. Além dessa configuração básica, o comportamento de arrastar e soltar é totalmente específico da implementação e não é definido por UIElement ou por qualquer outra classe 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. Determinados controles, por exemplo, RichTextBox, têm um comportamento padrão.Certain controls, for example, RichTextBox, do have a default behavior. Para obter mais informações sobre arrastar e soltar, consulte visão geral de arrastar e soltar.For more information on drag and drop, see Drag and Drop Overview.

FrameworkElement substitui os metadados para essa propriedade de dependência em sua implementação.FrameworkElement overrides the metadata for this dependency property in its implementation. Especificamente, FrameworkElement designa essa propriedade para permitir a herança de valor de propriedade (Inherits é true nos metadados).Specifically, FrameworkElement designates this property to allow property value inheritance (Inherits is true in metadata). A herança de valor de propriedade nesse contexto significa que, se houver elementos filho sem outro valor para AllowDrop atribuídos por meio de valores ou estilos locais, o valor do elemento pai mais próximo com esse valor atribuído (novamente, em estilos, por valores padrão ou um valor local), o valor do elemento pai será atribuído a todos os elementos filho não atribuídos anteriormente pelo sistema de propriedades.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. Na prática, isso significa que você pode especificar se deseja permitir operações drop no elemento raiz, e esse valor será propagado para todos os elementos filho que não o atribuiram especificamente 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.

Informações de Propriedade de DependênciaDependency Property Information

Campo de identificadorIdentifier field AllowDropProperty
Propriedades de metadados definidas como trueMetadata properties set to true NenhumNone

Applies to