UIElement.AllowDrop Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получение или установка значения, определяющего возможность использования элемента в качестве целевого объекта для операции перетаскивания. Это свойство зависимостей.
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
, если этот элемент можно использовать в качестве целевого объекта для операции перетаскивания; в противном случае — значение false
. Значение по умолчанию — false
.
Примеры
В следующем примере разметки AllowDrop true
свойство задается с помощью атрибута в объекте TextBox, а также при перетаскивании некоторых других связанных свойств, которые в статистическом виде позволяют TextBox быть целевым объектом многострочного текстового данных. Полный пример см. в разделе "Загрузка примера удаленного файла".
<TextBox
Name="tbDisplayFileContents"
Grid.Row="1"
AcceptsReturn="True" AcceptsTab="True"
AllowDrop="True"
BorderThickness="1" BorderBrush="Black"
HorizontalScrollBarVisibility="Auto" VerticalScrollBarVisibility="Auto"
PreviewDragOver="ehDragOver" PreviewDrop="ehDrop"
/>
Комментарии
Операции перетаскивания не включены по умолчанию и должны быть включены намеренно, задав для параметра значение AllowDrop true
. Помимо этого базового параметра поведение перетаскивания полностью зависит от реализации и не определяется классом UIElement других базовых элементов. Некоторые элементы управления, например, RichTextBoxимеют поведение по умолчанию. Дополнительные сведения о перетаскивании см. в разделе "Обзор перетаскивания".
FrameworkElement переопределяет метаданные для этого свойства зависимостей в реализации. В частности, указывает это свойство, FrameworkElement чтобы разрешить наследование значений свойства (Inherits находится true
в метаданных). Наследование значений свойства в этом контексте означает, что если дочерние элементы не имеют других значений, AllowDrop назначенных с помощью локальных значений или стилей, то значение ближайшего родительского элемента с назначенным значением (снова в стилях, по умолчанию или локальном значении), то значение родительского элемента будет назначено всем ранее неназначенным дочерним элементам системой свойств. На практике это означает, что можно указать, следует ли разрешать операции удаления в корневом элементе, и это значение будет распространяться на все дочерние элементы, которые не назначили его false
как.
Сведения о свойстве зависимостей
Поле идентификатора | AllowDropProperty |
Metadata properties set to true |
Нет |