Нин Чжан блог

Введение

Перетащите является общей парадигмы UX и верхней востребованной функцией. В Silverlight 4 Beta, мы ввели базовый набор API для того, чтобы наиболее распространенных сценария перетащить файлы фотографий и бросая их в Silverlight приложений, и мы разработали API, чтобы позволить нам раскрыть более перетаскивания функциональности по дороге без изменений API , с надеждой.

API

Ниже является ядром нового API:

  имен System.Windows 
  ( 
  общественного абстрактного класса UIElement: DependencyObject 
  ( 
  / / Поля 
  общественности статической чтения DependencyProperty AllowDropProperty; 

  / / События 
  общественное мероприятие DragEventHandler DragEnter; 
  общественное мероприятие DragEventHandler DragLeave; 
  общественное мероприятие DragEventHandler DragOver; 
  общественное мероприятие DragEventHandler Drop; 

  / / Свойства 
  риЬИс Ьоо AllowDrop (, который демонстрирует;) 
  ) 

  sender, DragEventArgs e); общественного делегата недействительными DragEventHandler (объект отправителя, DragEventArgs е); 

  общественного запечатанных класс DragEventArgs: RoutedEventArgs 
  ( 
  / / Методы 
  общественного Пойнт GetPosition (UIElement relativeTo); 

  / / Свойства 
  общественного IDataObject данных ([SecuritySafeCritical] получить;) 
  риЬИс Ьоо (обрабатывались, который демонстрирует;) 
  ) 
  ) 

  имен System.Windows.Controls 
  ( 
  общественного абстрактного класса управления: FrameworkElement 
  ( 
  защищенных виртуальных недействительными OnDragEnter (DragEventArgs е); 
  защищенных виртуальных недействительными OnDragLeave (DragEventArgs е); 
  защищенных виртуальных недействительными OnDragOver (DragEventArgs е); 
  защищенных виртуальных недействительными OnDrop (DragEventArgs е); 
  ) 
  ) 

• AllowDrop: это зависимость имущества с указанием того элемента перетаскивания.
• DragEnter, DragLeave, DragOver и Drop: они разгромили событий. Они пузыриться, и огонь только на элементы с AllowDrop установлен верно.
• OnDragEnter, OnDragLeave, OnDragOver и OnDrop: это защищенных виртуальных функций на подклассы для переопределения.
• DragEventArgs: этот класс позволяет перетаскивания обработчики событий или метод перекрывает доступ к данным тащат или сняты.

Использование

Есть в основном два способа использования Silverlight перетащить и падение API:

• Silverlight приложения могут обрабатывать эти события перетаскивания и обрабатывать файлы, упал в обработчики событий.
• Silverlight управления могут переопределять перетаскивания виртуальных функций для обработки данных, перетаскивать, и позволить себе быть падение показателей.

Недостатки

Перетаскивания поставляется в Silverlight 4 Beta только позволяет наиболее распространенный сценарий: Silverlight плагин, как файл каждого снимка. Обратите внимание на следующие ограничения текущей реализации:

• нет источника падение поддержки (QueryContinueDrag и GiveFeedback).
• нет DragDropEffects или DragDropKeyStates в DragEventArgs.
• нет визуальных для вытащили объекта или DragDropEffects.
• только файл перетащить при поддержке:
  • все перетаскивания пожары только тогда, когда файлы были перетаскивать.
  • IDataObject, DataObject и DragEventArgs.Data поддерживает только один формат: "FileDrop", и данные типа FileInfo [].
• большинство методов IDataObject бросить NotImplementedException.
  
• для перетаскивания для работы на Windows, Silverlight плагин должен быть оконном. В другой слово, если <param name="windowless" value="true"/> указано, падение событий не будет срабатывать.
• с Silverlight плагина на Mac всегда окон, необходимо подключить события JavaScript капли для запуска Silverlight событий капли. В другой слово, если вы хотите, чтобы ваш Silverlight приложения для поддержки файл падение на Mac, а также Windows, вам нужно добавить следующий сценарий и Silverlight плагин атрибуты хостинг HTML или ASPX странице:

    <! - Добавить следующий сценарий до конца тега HEAD -> 
    <script type= "text/javascript"> 
    Функция handleDragEnter (oEvent) ( 
    / / По умолчанию операций предупреждении 
    oEvent.preventDefault (); 
  
    VAR = флаг silverlightControl.dragEnter (oEvent); 
  
    / / Если мы справились успешно, то остановить распространение события 
    если (флаг) 
    oEvent.stopPropagation (); 
    ) 
  
    Функция handleDragLeave (oEvent) ( 
    / / По умолчанию операций предупреждении 
    oEvent.preventDefault (); 
  
    VAR = флаг silverlightControl.dragLeave (oEvent); 
  
    / / Если мы справились успешно, то остановить распространение события 
    если (флаг) 
    oEvent.stopPropagation (); 
    ) 
  
    Функция handleDragOver (oEvent) ( 
    / / По умолчанию операций предупреждении 
    oEvent.preventDefault (); 
  
    VAR = флаг silverlightControl.dragOver (oEvent); 
  
    / / Если мы справились успешно, то остановить распространение события 
    если (флаг) 
    oEvent.stopPropagation (); 
    ) 
  
    Функция handleDropEvent (oEvent) ( 
  
    / / По умолчанию операций предупреждении 
    oEvent.preventDefault (); 
  
    VAR = флаг silverlightControl.dragDrop (oEvent); 
  
    / / Если мы справились успешно, то остановить распространение события 
    если (флаг) 
    oEvent.stopPropagation (); 
    ) 
    </> Сценарий 
    <! - Использование JavaScript события перетаскивания для показа событий в Silverlight перетаскивания -> 
    type= "application/x-silverlight-2" width= "100%" height= "100%" <Объект данных = "данные: application/x-silverlight-2", типа = "application/x-silverlight-2" ширина = "100%" высота = "100%" 
    ondragover= "handleDragOver(event)" ID = "silverlightControl" ondragenter = "handleDragEnter (событие)" ondragover = "handleDragOver (событие)" 
    > ondragleave = "handleDragLeave (событие)" ondrop = "handleDropEvent (событие)"> 
  

  
  

• DragEventArgs.Data доступна только в мероприятии Drop. Доступ в DragEventArgs.Data DragEnter, DragOver DragLeave и может привести к SecurityException . И доступ к Directory, Имя_папки или FullName свойство объекта FileInfo от DragEventArgs.Data может привести к ArgumentNullException.

Демо App

Ниже демо-приложения:

• верхнем левом углу вложенных сеток использовать капли целевой обработчик событий для отображения DragEventArgs информации.
• в правом верхнем углу вложенных сеток содержат управления ImageDropTarget пользователь, который переопределяет метод OnDrop оказать упал файл, если он есть образ.
• нижний ListBox показывает последовательность событий перетаскивания их бьется, и DragEventArgs информации.

Вы можете найти полный исходный здесь .

Обратная связь

Хотя мы рады добавить перетащить к Silverlight, мы знаем, Есть много, чтобы закончить / улучшить, а то, что мы выпустили всего лишь бета. Как всегда, ваше мнение высоко ценится, и будет использоваться в качестве важных данных, помогая нам приоритетов в работе. Спасибо!