UIElement.AllowDrop UIElement.AllowDrop UIElement.AllowDrop UIElement.AllowDrop Property

定義

この要素をドラッグアンドドロップ操作の対象として使用できるかどうかを示す値を取得または設定します。Gets or sets a value indicating whether this element can be used as the target of a drag-and-drop operation. これは依存関係プロパティです。This is a dependency property.

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。それ以外の場合は falsetrue if this element can be used as the target of a drag-and-drop operation; otherwise, false. 既定値は false です。The default value is false.

次のマークアップの例AllowDroptrueは、の属性TextBoxを使用してプロパティを設定します。また、集計内のTextBox他の関連するプロパティを設定することにより、これを複数行テキストデータオブジェクトのターゲットにすることができます。これはでドラッグされます。The following markup example sets the AllowDrop property true using an attribute on a TextBox, as well as setting some other related properties that in aggregate enable that TextBox to be the target of a multiline text data object when it is dragged in. 完全なサンプルについては、「削除されたファイルの読み込みのサンプル」を参照してください。For the complete sample, see Load a Dropped File Sample.

<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することにより、この操作を意図的に有効にする必要があります。Drag-and-drop operations are not enabled by default, and must be enabled deliberately by setting AllowDrop to true. この基本設定以外に、ドラッグアンドドロップ動作は完全に実装固有であり、またはUIElement他の基本要素クラスでは定義されません。Beyond this basic setting, drag-and-drop behavior is entirely implementation specific and is not defined by UIElement or any other base element class. たとえばRichTextBox、などの特定のコントロールには、既定の動作があります。Certain controls, for example, RichTextBox, do have a default behavior. ドラッグアンドドロップの詳細については、「ドラッグアンドドロップの概要」を参照してください。For more information on drag and drop, see Drag and Drop Overview.

FrameworkElement実装で、この依存関係プロパティのメタデータをオーバーライドします。FrameworkElement overrides the metadata for this dependency property in its implementation. 具体的にFrameworkElementは、はプロパティ値の継承を許可Inheritsするtrueようにこのプロパティを指定します (はメタデータです)。Specifically, FrameworkElement designates this property to allow property value inheritance (Inherits is true in metadata). このコンテキストでのプロパティ値の継承は、ローカル値またはスタイルを使用しAllowDropて他の値が割り当てられていない子要素が存在する場合、この値が割り当てられている最も近い親要素の値 (既定では、スタイルのいずれかになります) を意味します。値またはローカル値) の場合、親要素の値は、プロパティシステムによって以前に割り当てられていないすべての子要素に割り当てられます。Property value inheritance in this context means that if there are child elements with no other value for AllowDrop assigned through local values or styles, the value of the nearest parent element with this value assigned (again, either in styles, by default values, or a local value), then the value from the parent element will be assigned to all previously unassigned child elements by the property system. 実際には、ルート要素で drop 操作を許可するかどうかを指定し、その値がとしてfalse明示的に割り当てられていないすべての子要素に反映されることを意味します。In practice this means that you can specify whether to allow drop operations at the root element, and that value will propagate to all child elements that have not specifically assigned it as false.

依存プロパティ情報Dependency Property Information

識別子フィールドIdentifier field AllowDropProperty
メタデータプロパティがに設定されるtrueMetadata properties set to true NoneNone

適用対象