UIElement.AllowDrop Propriedade

Definição

Namespace:

System.Windows

Assembly:

PresentationCore.dll

Obtém ou define um valor que indica se esse elemento pode ser usado como 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 esse elemento puder ser usado como destino de uma operação de 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 a configuração de algumas outras propriedades relacionadas que, na agregação, permitem que ela 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 AllowDroptruecomo . 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 a herança do valor da propriedade (Inherits está true em metadados). A herança do valor da propriedade nesse contexto significa que, se houver elementos filho sem nenhum outro valor para AllowDrop atribuído 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 Dependency

Item	Valor
Campo identificador	AllowDropProperty
Propriedades de metadados definidas como true	Nenhum