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.

次のマークアップ例のセット、AllowDropプロパティtrueで属性を使用して、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"
/>

注釈

ドラッグ アンド ドロップ操作が既定では、有効でないと、設定した意図的に有効にする必要がありますAllowDroptrueします。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プロパティ値の継承を有効にするには、このプロパティの指定 (Inheritstrueメタデータ内)。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. 実際にはつまり、ルート要素でドロップ操作を許可するかどうかを指定することができます、として割り当てられている値は、特にされているすべての子要素に反映されます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 なしNone

適用対象