UIElement.AllowDrop Właściwość

Definicja

Pobiera lub ustawia wartość wskazującą, czy ten element może być używany jako element docelowy operacji przeciągania i upuszczania. Jest to właściwość zależności.

C#
public bool AllowDrop { get; set; }

Wartość właściwości

Boolean

true jeśli ten element może być używany jako element docelowy operacji przeciągania i upuszczania; w przeciwnym razie , false. Wartość domyślna to false.

Przykłady

Poniższy przykład znaczników ustawia AllowDrop właściwość true przy użyciu atrybutu w TextBoxobiekcie , a także ustawienie innych powiązanych właściwości, które w agregacji umożliwiają, aby TextBox być obiektem docelowym wielowierszowego obiektu danych tekstowych po przeciągnięciu. Aby zapoznać się z kompletnym przykładem, zobacz Ładowanie porzuconego pliku przykładowego.

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

Uwagi

Operacje przeciągania i upuszczania nie są domyślnie włączone i muszą być celowo włączone przez ustawienie na AllowDrop truewartość . Poza tym podstawowym ustawieniem zachowanie przeciągania i upuszczania jest całkowicie specyficzne dla implementacji i nie jest definiowane przez UIElement ani żadną inną klasę elementu podstawowego. Niektóre kontrolki, na przykład , RichTextBoxmają zachowanie domyślne. Aby uzyskać więcej informacji na temat przeciągania i upuszczania, zobacz Omówienie przeciągania i upuszczania.

FrameworkElement zastępuje metadane tej właściwości zależności w jej implementacji. W szczególności wyznacza tę właściwość, FrameworkElement aby zezwolić na dziedziczenie wartości właściwości (Inherits jest true w metadanych). Dziedziczenie wartości właściwości w tym kontekście oznacza, że jeśli istnieją elementy podrzędne bez innej wartości AllowDrop przypisanej za pomocą wartości lokalnych lub stylów, wartość najbliższego elementu nadrzędnego z tą wartością przypisaną (ponownie w stylach, domyślnie wartości lub wartość lokalna), wartość z elementu nadrzędnego zostanie przypisana do wszystkich wcześniej nieprzypisanych elementów podrzędnych przez system właściwości. W praktyce oznacza to, że można określić, czy zezwalać na operacje upuszczania w elemecie głównym, a wartość ta będzie propagowana do wszystkich elementów podrzędnych, które nie zostały przypisane do niej jako false.

Informacje dotyczące właściwości zależności

Pole identyfikatora AllowDropProperty
Właściwości metadanych ustawione na true Brak

Dotyczy

Produkt Wersje
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
Windows Desktop 3.0, 3.1, 5, 6, 7