UIElement.AllowDrop Właściwość
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
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
.
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"
/>
Operacje przeciągania i upuszczania nie są domyślnie włączone i muszą być celowo włączone przez ustawienie na AllowDrop true
wartość . 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
.
Pole identyfikatora | AllowDropProperty |
Właściwości metadanych ustawione na true |
Brak |
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 |