UIElement.AllowDrop Propriedade

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 Propriedade

true se este elemento puder ser usado como alvo de uma operação de arrastar e largar; caso contrário, false. O valor predefinido é false.

Exemplos

O exemplo seguinte de marcação define a AllowDrop propriedade true usando um atributo num TextBox, bem como algumas outras propriedades relacionadas que, no conjunto, permitem que esse TextBox seja o alvo de um objeto de dados de texto multilinha quando é arrastado. Para a amostra completa, veja Carregar uma Amostra de Ficheiro Dropado.

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

Observações

As operações de arrastar e largar não estão ativadas por defeito, e devem ser ativadas deliberadamente definindo AllowDrop para true. Para além desta configuração básica, o comportamento de arrastar e largar é inteiramente específico da implementação e não é definido por UIElement nem por qualquer outra classe de elemento base. Certos controlos, por exemplo, RichTextBox, têm um comportamento padrão. Para mais informações sobre arrastar e largar, consulte Visão Geral de Arrastar e Largar.

FrameworkElement sobrepõe os metadados desta propriedade de dependência na sua implementação. Especificamente, FrameworkElement designa esta propriedade para permitir a herança do valor da propriedade (Inherits está true nos metadados). Herança de valor de propriedade neste contexto significa que, se existirem elementos filhos sem outro valor atribuído AllowDrop através de valores ou estilos locais, o valor do elemento pai mais próximo com esse valor atribuído (novamente, seja em estilos, valores por defeito, ou um valor local), então o valor do elemento pai será atribuído a todos os elementos filhos previamente não atribuídos pelo sistema de propriedades. Na prática, isto significa que pode especificar se permite operações de drop no elemento raiz, e esse valor propaga-se para todos os elementos filhos que não o tenham especificamente atribuído como false.

Informação de Propriedade de Dependência