Interaction.cs 10 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316
  1. using System;
  2. using System.Collections.Generic;
  3. using Avalonia.Controls;
  4. using Avalonia.Interactivity;
  5. using Avalonia.LogicalTree;
  6. using Avalonia.Reactive;
  7. namespace Avalonia.Xaml.Interactivity;
  8. /// <summary>
  9. /// Defines a <see cref="BehaviorCollection"/> attached property and provides a method for executing an <seealso cref="ActionCollection"/>.
  10. /// </summary>
  11. public class Interaction
  12. {
  13. static Interaction()
  14. {
  15. BehaviorsProperty.Changed.Subscribe(
  16. new AnonymousObserver<AvaloniaPropertyChangedEventArgs<BehaviorCollection?>>(BehaviorsChanged));
  17. }
  18. /// <summary>
  19. /// Gets or sets the <see cref="BehaviorCollection"/> associated with a specified object.
  20. /// </summary>
  21. public static readonly AttachedProperty<BehaviorCollection?> BehaviorsProperty =
  22. AvaloniaProperty.RegisterAttached<Interaction, AvaloniaObject, BehaviorCollection?>("Behaviors");
  23. /// <summary>
  24. /// Gets the <see cref="BehaviorCollection"/> associated with a specified object.
  25. /// </summary>
  26. /// <param name="obj">The <see cref="AvaloniaObject"/> from which to retrieve the <see cref="BehaviorCollection"/>.</param>
  27. /// <returns>A <see cref="BehaviorCollection"/> containing the behaviors associated with the specified object.</returns>
  28. public static BehaviorCollection GetBehaviors(AvaloniaObject obj)
  29. {
  30. if (obj is null)
  31. {
  32. throw new ArgumentNullException(nameof(obj));
  33. }
  34. var behaviorCollection = obj.GetValue(BehaviorsProperty);
  35. if (behaviorCollection is null)
  36. {
  37. behaviorCollection = [];
  38. obj.SetValue(BehaviorsProperty, behaviorCollection);
  39. SetVisualTreeEventHandlersFromGetter(obj);
  40. }
  41. return behaviorCollection;
  42. }
  43. /// <summary>
  44. /// Sets the <see cref="BehaviorCollection"/> associated with a specified object.
  45. /// </summary>
  46. /// <param name="obj">The <see cref="AvaloniaObject"/> on which to set the <see cref="BehaviorCollection"/>.</param>
  47. /// <param name="value">The <see cref="BehaviorCollection"/> associated with the object.</param>
  48. public static void SetBehaviors(AvaloniaObject obj, BehaviorCollection? value)
  49. {
  50. if (obj is null)
  51. {
  52. throw new ArgumentNullException(nameof(obj));
  53. }
  54. obj.SetValue(BehaviorsProperty, value);
  55. }
  56. /// <summary>
  57. /// Executes all actions in the <see cref="ActionCollection"/> and returns their results.
  58. /// </summary>
  59. /// <param name="sender">The <see cref="object"/> which will be passed on to the action.</param>
  60. /// <param name="actions">The set of actions to execute.</param>
  61. /// <param name="parameter">The value of this parameter is determined by the calling behavior.</param>
  62. /// <returns>Returns the results of the actions.</returns>
  63. public static IEnumerable<object> ExecuteActions(object? sender, ActionCollection? actions, object? parameter)
  64. {
  65. if (actions is null)
  66. {
  67. return [];
  68. }
  69. var results = new List<object>();
  70. foreach (var avaloniaObject in actions)
  71. {
  72. if (avaloniaObject is not IAction action)
  73. {
  74. continue;
  75. }
  76. var result = action.Execute(sender, parameter);
  77. if (result is not null)
  78. {
  79. results.Add(result);
  80. }
  81. }
  82. return results;
  83. }
  84. private static void BehaviorsChanged(AvaloniaPropertyChangedEventArgs<BehaviorCollection?> e)
  85. {
  86. var oldCollection = e.OldValue.GetValueOrDefault();
  87. var newCollection = e.NewValue.GetValueOrDefault();
  88. if (oldCollection == newCollection)
  89. {
  90. return;
  91. }
  92. if (oldCollection is { AssociatedObject: not null })
  93. {
  94. oldCollection.Detach();
  95. }
  96. if (newCollection is not null)
  97. {
  98. newCollection.Attach(e.Sender);
  99. SetVisualTreeEventHandlersFromChangedEvent(e.Sender);
  100. }
  101. }
  102. private static void SetVisualTreeEventHandlersFromGetter(AvaloniaObject obj)
  103. {
  104. if (obj is not Control control)
  105. {
  106. return;
  107. }
  108. // AttachedToVisualTree / DetachedFromVisualTree
  109. control.AttachedToVisualTree -= Control_AttachedToVisualTreeFromChangedEvent;
  110. control.DetachedFromVisualTree -= Control_DetachedFromVisualTreeFromChangedEvent;
  111. control.AttachedToVisualTree -= Control_AttachedToVisualTreeFromGetter;
  112. control.AttachedToVisualTree += Control_AttachedToVisualTreeFromGetter;
  113. control.DetachedFromVisualTree -= Control_DetachedFromVisualTreeFromGetter;
  114. control.DetachedFromVisualTree += Control_DetachedFromVisualTreeFromGetter;
  115. // AttachedToLogicalTree / DetachedFromLogicalTree
  116. control.AttachedToLogicalTree -= Control_AttachedToLogicalTreeFromChangedEvent;
  117. control.DetachedFromLogicalTree -= Control_DetachedFromLogicalTreeFromChangedEvent;
  118. control.AttachedToLogicalTree -= Control_AttachedToLogicalTreeFromGetter;
  119. control.AttachedToLogicalTree += Control_AttachedToLogicalTreeFromGetter;
  120. control.DetachedFromLogicalTree -= Control_DetachedFromLogicalTreeFromGetter;
  121. control.DetachedFromLogicalTree += Control_DetachedFromLogicalTreeFromGetter;
  122. // Loaded / Unloaded
  123. control.Loaded -= Control_LoadedFromChangedEvent;
  124. control.Unloaded -= Control_UnloadedFromChangedEvent;
  125. control.Loaded -= Control_LoadedFromGetter;
  126. control.Loaded += Control_LoadedFromGetter;
  127. control.Unloaded -= Control_UnloadedFromGetter;
  128. control.Unloaded += Control_UnloadedFromGetter;
  129. }
  130. private static void SetVisualTreeEventHandlersFromChangedEvent(AvaloniaObject obj)
  131. {
  132. if (obj is not Control control)
  133. {
  134. return;
  135. }
  136. // AttachedToVisualTree / DetachedFromVisualTree
  137. control.AttachedToVisualTree -= Control_AttachedToVisualTreeFromGetter;
  138. control.DetachedFromVisualTree -= Control_DetachedFromVisualTreeFromGetter;
  139. control.AttachedToVisualTree -= Control_AttachedToVisualTreeFromChangedEvent;
  140. control.AttachedToVisualTree += Control_AttachedToVisualTreeFromChangedEvent;
  141. control.DetachedFromVisualTree -= Control_DetachedFromVisualTreeFromChangedEvent;
  142. control.DetachedFromVisualTree += Control_DetachedFromVisualTreeFromChangedEvent;
  143. // AttachedToLogicalTree / DetachedFromLogicalTree
  144. control.AttachedToLogicalTree -= Control_AttachedToLogicalTreeFromGetter;
  145. control.DetachedFromLogicalTree -= Control_DetachedFromLogicalTreeFromGetter;
  146. control.AttachedToLogicalTree -= Control_AttachedToLogicalTreeFromChangedEvent;
  147. control.AttachedToLogicalTree += Control_AttachedToLogicalTreeFromChangedEvent;
  148. control.DetachedFromLogicalTree -= Control_DetachedFromLogicalTreeFromChangedEvent;
  149. control.DetachedFromLogicalTree += Control_DetachedFromLogicalTreeFromChangedEvent;
  150. // Loaded / Unloaded
  151. control.Loaded -= Control_LoadedFromGetter;
  152. control.Unloaded -= Control_UnloadedFromGetter;
  153. control.Loaded -= Control_LoadedFromChangedEvent;
  154. control.Loaded += Control_LoadedFromChangedEvent;
  155. control.Unloaded -= Control_UnloadedFromChangedEvent;
  156. control.Unloaded += Control_UnloadedFromChangedEvent;
  157. }
  158. // AttachedToVisualTree / DetachedFromVisualTree
  159. private static void Control_AttachedToVisualTreeFromGetter(object? sender, VisualTreeAttachmentEventArgs e)
  160. {
  161. if (sender is not AvaloniaObject d)
  162. {
  163. return;
  164. }
  165. GetBehaviors(d).Attach(d);
  166. GetBehaviors(d).AttachedToVisualTree();
  167. }
  168. private static void Control_DetachedFromVisualTreeFromGetter(object? sender, VisualTreeAttachmentEventArgs e)
  169. {
  170. if (sender is not AvaloniaObject d)
  171. {
  172. return;
  173. }
  174. GetBehaviors(d).DetachedFromVisualTree();
  175. GetBehaviors(d).Detach();
  176. }
  177. private static void Control_AttachedToVisualTreeFromChangedEvent(object? sender, VisualTreeAttachmentEventArgs e)
  178. {
  179. if (sender is not AvaloniaObject d)
  180. {
  181. return;
  182. }
  183. GetBehaviors(d).AttachedToVisualTree();
  184. }
  185. private static void Control_DetachedFromVisualTreeFromChangedEvent(object? sender, VisualTreeAttachmentEventArgs e)
  186. {
  187. if (sender is not AvaloniaObject d)
  188. {
  189. return;
  190. }
  191. GetBehaviors(d).DetachedFromVisualTree();
  192. }
  193. // AttachedToLogicalTree / DetachedFromLogicalTree
  194. private static void Control_AttachedToLogicalTreeFromGetter(object? sender, LogicalTreeAttachmentEventArgs e)
  195. {
  196. if (sender is not AvaloniaObject d)
  197. {
  198. return;
  199. }
  200. GetBehaviors(d).AttachedToLogicalTree();
  201. }
  202. private static void Control_DetachedFromLogicalTreeFromGetter(object? sender, LogicalTreeAttachmentEventArgs e)
  203. {
  204. if (sender is not AvaloniaObject d)
  205. {
  206. return;
  207. }
  208. GetBehaviors(d).DetachedFromLogicalTree();
  209. }
  210. private static void Control_AttachedToLogicalTreeFromChangedEvent(object? sender, LogicalTreeAttachmentEventArgs e)
  211. {
  212. if (sender is not AvaloniaObject d)
  213. {
  214. return;
  215. }
  216. GetBehaviors(d).AttachedToLogicalTree();
  217. }
  218. private static void Control_DetachedFromLogicalTreeFromChangedEvent(object? sender, LogicalTreeAttachmentEventArgs e)
  219. {
  220. if (sender is not AvaloniaObject d)
  221. {
  222. return;
  223. }
  224. GetBehaviors(d).DetachedFromLogicalTree();
  225. }
  226. // Loaded / Unloaded
  227. private static void Control_LoadedFromGetter(object? sender, RoutedEventArgs e)
  228. {
  229. if (sender is not AvaloniaObject d)
  230. {
  231. return;
  232. }
  233. GetBehaviors(d).Loaded();
  234. }
  235. private static void Control_UnloadedFromGetter(object? sender, RoutedEventArgs e)
  236. {
  237. if (sender is not AvaloniaObject d)
  238. {
  239. return;
  240. }
  241. GetBehaviors(d).Unloaded();
  242. }
  243. private static void Control_LoadedFromChangedEvent(object? sender, RoutedEventArgs e)
  244. {
  245. if (sender is not AvaloniaObject d)
  246. {
  247. return;
  248. }
  249. GetBehaviors(d).Loaded();
  250. }
  251. private static void Control_UnloadedFromChangedEvent(object? sender, RoutedEventArgs e)
  252. {
  253. if (sender is not AvaloniaObject d)
  254. {
  255. return;
  256. }
  257. GetBehaviors(d).Unloaded();
  258. }
  259. }