UIElement.AllowDrop プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
この要素をドラッグアンドドロップ操作の対象として使用できるかどうかを示す値を取得または設定します。 これは依存関係プロパティです。
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
です。
例
次のマークアップの例では、属性をTextBox使用してプロパティtrue
を設定AllowDropします。また、集計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プロパティ値の継承を許可するようにこのプロパティを指定します (Inheritstrue
メタデータ内にあります)。 このコンテキストでのプロパティ値の継承は、ローカル値またはスタイルを介して割り当てられた他の値 AllowDrop を持たない子要素がある場合、この値が割り当てられた最も近い親要素の値 (スタイル、既定値、またはローカル値のいずれか) が存在する場合、親要素の値がプロパティ システムによって以前に割り当てられていないすべての子要素に割り当てられることを意味します。 実際には、これはルート要素でドロップ操作を許可するかどうかを指定できることを意味し、その値は、明示的に割り当て false
されていないすべての子要素に反映されます。
依存プロパティ情報
識別子フィールド | AllowDropProperty |
メタデータのプロパティが次に設定されている true |
なし |