UIElement.AllowDrop Propriedade

Definição

Namespace:

Microsoft.UI.Xaml

Obtém ou define um valor que determina se esse UIElement pode ser um destino de soltar para fins de operações de arrastar e soltar.

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"/>

Valor da propriedade

Boolean

bool

true se esse UIElement puder ser um destino de soltar para fins de operações de arrastar e soltar; caso contrário, false. O padrão é false.

Comentários

O valor de AllowDrop determina se vários eventos relacionados a ser um destino de soltar ou responder a serem arrastados podem ser tratados. Esses eventos só poderão ser tratados se AllowDrop estiver true no UIElement que é um possível destino de descarte. Esses eventos são:

• DragEnter
• DragLeave
• DragOver
• Gota

Cada um dos eventos listados é um evento roteado. Se você quiser manipular um evento de arrastar-soltar borbulhante, o destino de soltar potencial deve ter AllowDrop definido como truee o objeto em que o evento é manipulado deve ter AllowDrop definido como true. Para obter mais informações sobre conceitos de eventos roteado, consulte Visão geral de eventos e eventos roteado.

A implementação Windows Runtime de conceitos de arrastar e soltar permite que apenas determinados controles e ações de entrada iniciem uma ação de arrastar-soltar. Não há nenhum método generalizado DoDragDrop que permita que qualquer elemento de interface do usuário inicie uma ação de arrastar-soltar. A origem main de uma ação de arrastar-soltar em um aplicativo é quando você arrasta os itens de uma lista, como GridView. No entanto, depois que a ação for iniciada, qualquer UIElement no aplicativo poderá ser um destino de descarte, desde AllowDrop que esteja true nesse elemento. Todos os elementos passados pela ação drag-drop podem manipular DragEnter, DragLeave ou DragOver. A exibição de lista inicial não requer AllowDrop. Em vez disso, o valor de CanDragItems é usado para determinar se os itens na lista podem ser usados para iniciar uma ação de arrastar-soltar.

Um elemento de interface do usuário não pode ser um destino de soltar para qualquer ação de arrastar-soltar que comece de fora do aplicativo atual. Isso inclui ações provenientes de outro aplicativo, o que é possível para um modo de exibição ajustado.

Confira também

• Visão geral de arrastar e soltar
• Exemplo de arrastar e soltar (UWP)