UIElement.AllowDrop Propriedade

Definição

Namespace:

System.Windows

Assembly:

PresentationCore.dll

Obtém ou define um valor indicando se um elemento pode ser usado como o destino de uma operação de arrastar e soltar. É uma propriedade de dependência.

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 da propriedade

Boolean

true se um elemento pode ser usado como o destino de uma operação do tipo "arrastar e soltar"; caso contrário, false. O valor padrão é false.

Exemplos

O exemplo de marcação a seguir define a AllowDrop propriedade true usando um atributo em um TextBox, bem como definir algumas outras propriedades relacionadas que, na agregação, permitem que esse TextBox seja o destino de um objeto de dados de texto multilinha quando ele é arrastado para dentro. Para obter o exemplo completo, consulte Carregar um exemplo de arquivo descartado.

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

Comentários

As operações de arrastar e soltar não são habilitadas por padrão e devem ser habilitadas deliberadamente definindo AllowDrop truecomo . Além dessa configuração básica, o comportamento de arrastar e soltar é totalmente específico de implementação e não é definido por UIElement nenhuma outra classe de elemento base. Determinados controles, por exemplo, RichTextBoxtêm um comportamento padrão. Para obter mais informações sobre arrastar e soltar, consulte Visão geral de arrastar e soltar.

FrameworkElement substitui os metadados dessa propriedade de dependência em sua implementação. Especificamente, FrameworkElement designa essa propriedade para permitir herança de valor de propriedade (Inherits está true em metadados). 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. Na prática, isso significa que você pode especificar se deseja permitir operações de descarte no elemento raiz e esse valor será propagado para todos os elementos filho que não o atribuíram especificamente como false.

Informações da propriedade de dependência

Campo identificador	AllowDropProperty
Propriedades de metadados definidas como true	Nenhum