UIElement.AllowDrop Właściwość

Odwołanie

Definicja

Przestrzeń nazw:: System.Windows

Zestaw:: PresentationCore.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

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.

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

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.

<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