UIElement.AllowDrop Propriété

Définition

Espace de noms:

Microsoft.UI.Xaml

Obtient ou définit une valeur qui détermine si cet élément UIElement peut être une cible de déplacement à des fins d’opérations de glisser-déplacer.

public:
 property bool AllowDrop { bool get(); void set(bool value); };

bool AllowDrop();

void AllowDrop(bool value);

public bool AllowDrop { get; set; }

var boolean = uIElement.allowDrop;
uIElement.allowDrop = boolean;

Public Property AllowDrop As Boolean

<uiElement AllowDrop="bool"/>

Valeur de propriété

Boolean

bool

true si cet élément UIElement peut être une cible de déplacement à des fins d’opérations de glisser-déplacer ; sinon, false. Par défaut, il s’agit de false.

Remarques

La valeur de AllowDrop détermine si divers événements liés au fait d’être une cible de suppression ou à la réponse au fait d’être déplacés vers le dessus peuvent être gérés. Ces événements ne peuvent être gérés que si AllowDrop se trouve true sur l’élément UIElement qui est une cible de suppression potentielle. Ces événements sont les suivants :

• DragEnter
• DragLeave
• DragOver
• Goutte

Chacun des événements répertoriés est un événement routé. Si vous souhaitez gérer un événement de glisser-déplacer bouillonnant, la cible de suppression potentielle doit avoir AllowDrop la valeur true, et l’objet dans lequel l’événement est géré doit avoir AllowDrop la valeur true. Pour plus d’informations sur les concepts des événements routés, consultez Vue d’ensemble des événements et des événements routés.

L’implémentation Windows Runtime de concepts de glisser-déplacer permet uniquement à certains contrôles et actions d’entrée d’initier une action de glisser-déplacer. Il n’existe aucune méthode généralisée DoDragDrop qui permettrait à un élément d’interface utilisateur de lancer une action de glisser-déplacer. La main source d’une action de glisser-déplacer dans une application consiste à faire glisser les éléments d’une liste telle que GridView. Toutefois, une fois l’action lancée, n’importe quel élément UIElement dans l’application peut potentiellement être une cible de suppression tant qu’il AllowDrop se trouve true sur cet élément. Tous les éléments que l’action glisser-déplacer transmet peuvent gérer DragEnter, DragLeave ou DragOver. L’affichage de liste de lancement ne nécessite AllowDroppas . Au lieu de cela, la valeur de CanDragItems est utilisée pour déterminer si les éléments de la liste peuvent être utilisés pour démarrer une action de glisser-déplacer.

Un élément d’interface utilisateur ne peut pas être une cible de déplacement pour une action de glisser-déplacer qui commence à l’extérieur de l’application actuelle. Cela inclut les actions qui proviennent d’une autre application, ce qui est possible pour une vue alignée.

Voir aussi

• Vue d’ensemble du glisser-déplacer
• Exemple de glisser-déplacer (UWP)