UIElement.AllowDrop Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft einen Wert ab bzw. legt einen Wert fest, der angibt, ob dieses Element als Ziel eines Drag & Drop-Vorgangs verwendet werden kann. Hierbei handelt es sich um eine Abhängigkeitseigenschaft.
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
Eigenschaftswert
true
, wenn dieses Element als Ziel eines Drag & Drop-Vorgangs verwendet werden kann, andernfalls false
. Der Standardwert ist false
.
Beispiele
Im folgenden Markupbeispiel wird die AllowDrop Eigenschaft true
mithilfe eines Attributs auf einem TextBox, sowie durch Festlegen einiger anderer verwandter Eigenschaften festgelegt, die TextBox das Ziel eines mehrzeiligen Textdatenobjekts ermöglichen, wenn er gezogen wird. Informationen zum vollständigen Beispiel finden Sie unter Laden eines Abgelegten Dateibeispiels.
<TextBox
Name="tbDisplayFileContents"
Grid.Row="1"
AcceptsReturn="True" AcceptsTab="True"
AllowDrop="True"
BorderThickness="1" BorderBrush="Black"
HorizontalScrollBarVisibility="Auto" VerticalScrollBarVisibility="Auto"
PreviewDragOver="ehDragOver" PreviewDrop="ehDrop"
/>
Hinweise
Drag-and-Drop-Vorgänge sind standardmäßig nicht aktiviert und müssen absichtlich durch Einstellung AllowDrop aktiviert true
werden. Über diese grundlegende Einstellung hinaus ist das Drag-and-Drop-Verhalten vollständig implementierungsspezifisch und wird von UIElement keiner anderen Basiselementklasse definiert. Bestimmte Steuerelemente, z. B RichTextBox., verfügen über ein Standardverhalten. Weitere Informationen zum Ziehen und Ablegen finden Sie unter "Übersicht über Ziehen und Ablegen".
FrameworkElement überschreibt die Metadaten für diese Abhängigkeitseigenschaft in ihrer Implementierung. Gibt insbesondere diese Eigenschaft an, FrameworkElement die Vererbung von Eigenschaftenwerten zuzulassen (Inherits ist true
in Metadaten). Die Eigenschaftswertvererbung in diesem Kontext bedeutet, dass es untergeordnete Elemente ohne AllowDrop anderen Wert für zugewiesene lokale Werte oder Formatvorlagen gibt, der Wert des nächsten übergeordneten Elements mit diesem Wert zugewiesen ist (wieder in Formatvorlagen, standardwerten oder einem lokalen Wert), dann wird der Wert aus dem übergeordneten Element allen zuvor nicht zugewiesenen untergeordneten Elementen durch das Eigenschaftssystem zugewiesen. In der Praxis bedeutet dies, dass Sie angeben können, ob Dropvorgänge im Stammelement zulässig sind, und dieser Wert wird an alle untergeordneten Elemente verteilt, die sie false
nicht speziell zugewiesen haben.
Informationen zur Abhängigkeitseigenschaft
Bezeichnerfeld | AllowDropProperty |
Metadateneigenschaften auf true festgelegt |
Keine |