LibraryExplorer.xaml.cs 28 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640
  1. using MahApps.Metro.Controls;
  2. using MediaBrowser.Common;
  3. using MediaBrowser.Controller.Entities;
  4. using MediaBrowser.Controller.Entities.Movies;
  5. using MediaBrowser.Controller.Entities.TV;
  6. using MediaBrowser.Controller.Library;
  7. using MediaBrowser.Controller.Localization;
  8. using MediaBrowser.Model.Dto;
  9. using MediaBrowser.Model.Entities;
  10. using MediaBrowser.Model.Logging;
  11. using MediaBrowser.Model.Querying;
  12. using MediaBrowser.Model.Serialization;
  13. using System;
  14. using System.Collections.Generic;
  15. using System.Globalization;
  16. using System.Linq;
  17. using System.Text;
  18. using System.Threading;
  19. using System.Threading.Tasks;
  20. using System.Windows;
  21. using System.Windows.Controls;
  22. using System.Windows.Data;
  23. using System.Windows.Input;
  24. using System.Windows.Media.Imaging;
  25. namespace MediaBrowser.ServerApplication
  26. {
  27. /// <summary>
  28. /// Interaction logic for LibraryExplorer.xaml
  29. /// </summary>
  30. public partial class LibraryExplorer : MetroWindow
  31. {
  32. private readonly ILogger _logger;
  33. private readonly IJsonSerializer _jsonSerializer;
  34. private readonly ILibraryManager _libraryManager;
  35. private readonly IDisplayPreferencesManager _displayPreferencesManager;
  36. /// <summary>
  37. /// The current user
  38. /// </summary>
  39. private User CurrentUser;
  40. /// <summary>
  41. /// Initializes a new instance of the <see cref="LibraryExplorer" /> class.
  42. /// </summary>
  43. /// <param name="jsonSerializer">The json serializer.</param>
  44. /// <param name="logger">The logger.</param>
  45. /// <param name="appHost">The app host.</param>
  46. /// <param name="userManager">The user manager.</param>
  47. /// <param name="libraryManager">The library manager.</param>
  48. /// <param name="displayPreferencesManager">The display preferences manager.</param>
  49. public LibraryExplorer(IJsonSerializer jsonSerializer, ILogger logger, IApplicationHost appHost, IUserManager userManager, ILibraryManager libraryManager, IDisplayPreferencesManager displayPreferencesManager)
  50. {
  51. _logger = logger;
  52. _jsonSerializer = jsonSerializer;
  53. _libraryManager = libraryManager;
  54. _displayPreferencesManager = displayPreferencesManager;
  55. InitializeComponent();
  56. lblVersion.Content = "Version: " + appHost.ApplicationVersion;
  57. foreach (var user in userManager.Users)
  58. ddlProfile.Items.Add(user);
  59. ddlProfile.Items.Insert(0,new User {Name = "Physical"});
  60. ddlProfile.SelectedIndex = 0;
  61. ddlIndexBy.Visibility = ddlSortBy.Visibility = lblIndexBy.Visibility = lblSortBy.Visibility = Visibility.Hidden;
  62. }
  63. /// <summary>
  64. /// Handles the Click event of the btnLoad control.
  65. /// </summary>
  66. /// <param name="sender">The source of the event.</param>
  67. /// <param name="e">The <see cref="RoutedEventArgs" /> instance containing the event data.</param>
  68. private void btnLoad_Click(object sender, RoutedEventArgs e)
  69. {
  70. }
  71. /// <summary>
  72. /// Loads the tree.
  73. /// </summary>
  74. /// <returns>Task.</returns>
  75. private async Task LoadTree()
  76. {
  77. tvwLibrary.Items.Clear();
  78. lblLoading.Visibility = Visibility.Visible;
  79. //grab UI context so we can update within the below task
  80. var ui = TaskScheduler.FromCurrentSynchronizationContext();
  81. //this whole async thing doesn't really work in this instance since all my work pretty much needs to be on the UI thread...
  82. Cursor = Cursors.Wait;
  83. await Task.Run(() =>
  84. {
  85. IEnumerable<BaseItem> children = CurrentUser.Name == "Physical" ? _libraryManager.RootFolder.Children : _libraryManager.RootFolder.GetChildren(CurrentUser);
  86. children = OrderByName(children, CurrentUser);
  87. foreach (Folder folder in children)
  88. {
  89. var currentFolder = folder;
  90. Task.Factory.StartNew(() =>
  91. {
  92. var prefs = ddlProfile.SelectedItem != null ? _displayPreferencesManager.GetDisplayPreferences(currentFolder.GetDisplayPreferencesId((ddlProfile.SelectedItem as User).Id)).Result ?? new DisplayPreferences { SortBy = ItemSortBy.SortName } : new DisplayPreferences { SortBy = ItemSortBy.SortName };
  93. var node = new TreeViewItem { Tag = currentFolder };
  94. var subChildren = currentFolder.GetChildren(CurrentUser, prefs.IndexBy);
  95. subChildren = OrderByName(subChildren, CurrentUser);
  96. AddChildren(node, subChildren, CurrentUser);
  97. node.Header = currentFolder.Name + " (" +
  98. node.Items.Count + ")";
  99. tvwLibrary.Items.Add(node);
  100. }, CancellationToken.None, TaskCreationOptions.None, ui);
  101. }
  102. });
  103. lblLoading.Visibility = Visibility.Hidden;
  104. Cursor = Cursors.Arrow;
  105. }
  106. /// <summary>
  107. /// Orders the name of the by.
  108. /// </summary>
  109. /// <param name="items">The items.</param>
  110. /// <param name="user">The user.</param>
  111. /// <returns>IEnumerable{BaseItem}.</returns>
  112. private IEnumerable<BaseItem> OrderByName(IEnumerable<BaseItem> items, User user)
  113. {
  114. return OrderBy(items, user, ItemSortBy.SortName);
  115. }
  116. /// <summary>
  117. /// Orders the name of the by.
  118. /// </summary>
  119. /// <param name="items">The items.</param>
  120. /// <param name="user">The user.</param>
  121. /// <returns>IEnumerable{BaseItem}.</returns>
  122. private IEnumerable<BaseItem> OrderBy(IEnumerable<BaseItem> items, User user, string order)
  123. {
  124. return _libraryManager.Sort(items, user, new[] { order }, SortOrder.Ascending);
  125. }
  126. /// <summary>
  127. /// Adds the children.
  128. /// </summary>
  129. /// <param name="parent">The parent.</param>
  130. /// <param name="children">The children.</param>
  131. /// <param name="user">The user.</param>
  132. private void AddChildren(TreeViewItem parent, IEnumerable<BaseItem> children, User user)
  133. {
  134. foreach (var item in children)
  135. {
  136. var node = new TreeViewItem { Tag = item };
  137. var subFolder = item as Folder;
  138. if (subFolder != null)
  139. {
  140. var prefs = _displayPreferencesManager.GetDisplayPreferences(subFolder.GetDisplayPreferencesId(user.Id)).Result;
  141. AddChildren(node, OrderBy(subFolder.GetChildren(user), user, prefs.SortBy), user);
  142. node.Header = item.Name + " (" + node.Items.Count + ")";
  143. }
  144. else
  145. {
  146. node.Header = item.Name;
  147. }
  148. parent.Items.Add(node);
  149. }
  150. }
  151. /// <summary>
  152. /// TVWs the library_ selected item changed.
  153. /// </summary>
  154. /// <param name="sender">The sender.</param>
  155. /// <param name="e">The e.</param>
  156. private async void tvwLibrary_SelectedItemChanged(object sender, RoutedPropertyChangedEventArgs<object> e)
  157. {
  158. if (tvwLibrary.SelectedItem != null)
  159. {
  160. var item = (BaseItem)(tvwLibrary.SelectedItem as TreeViewItem).Tag;
  161. lblObjType.Content = "Type: " + item.GetType().Name;
  162. var movie = item as Movie;
  163. var folder = item as Folder;
  164. if (folder != null)
  165. {
  166. lblIndexBy.Visibility = ddlIndexBy.Visibility = ddlSortBy.Visibility = lblSortBy.Visibility = Visibility.Visible;
  167. ddlIndexBy.ItemsSource = folder.IndexByOptionStrings;
  168. ddlSortBy.ItemsSource = new []
  169. {
  170. ItemSortBy.SortName,
  171. ItemSortBy.Album,
  172. ItemSortBy.AlbumArtist,
  173. ItemSortBy.Artist,
  174. ItemSortBy.CommunityRating,
  175. ItemSortBy.DateCreated,
  176. ItemSortBy.DatePlayed,
  177. ItemSortBy.PremiereDate,
  178. ItemSortBy.ProductionYear,
  179. ItemSortBy.Random,
  180. ItemSortBy.Runtime
  181. };
  182. var prefs =
  183. await
  184. _displayPreferencesManager.GetDisplayPreferences(folder.GetDisplayPreferencesId((ddlProfile.SelectedItem as User).Id));
  185. ddlIndexBy.SelectedItem = prefs != null
  186. ? prefs.IndexBy ?? LocalizedStrings.Instance.GetString("NoneDispPref")
  187. : LocalizedStrings.Instance.GetString("NoneDispPref");
  188. ddlSortBy.SelectedItem = prefs != null
  189. ? prefs.SortBy ?? ItemSortBy.SortName
  190. : ItemSortBy.SortName;
  191. }
  192. else
  193. {
  194. lblIndexBy.Visibility = ddlIndexBy.Visibility = ddlSortBy.Visibility = lblSortBy.Visibility = Visibility.Hidden;
  195. }
  196. txtData.Text = FormatJson(_jsonSerializer.SerializeToString(item));
  197. var previews = new List<PreviewItem>();
  198. await Task.Run(() =>
  199. {
  200. if (!string.IsNullOrEmpty(item.PrimaryImagePath))
  201. {
  202. previews.Add(new PreviewItem(item.PrimaryImagePath, "Primary"));
  203. }
  204. if (item.HasImage(ImageType.Banner))
  205. {
  206. previews.Add(new PreviewItem(item.GetImage(ImageType.Banner), "Banner"));
  207. }
  208. if (item.HasImage(ImageType.Logo))
  209. {
  210. previews.Add(new PreviewItem(item.GetImage(ImageType.Logo), "Logo"));
  211. }
  212. if (item.HasImage(ImageType.Art))
  213. {
  214. previews.Add(new PreviewItem(item.GetImage(ImageType.Art), "Art"));
  215. }
  216. if (item.HasImage(ImageType.Thumb))
  217. {
  218. previews.Add(new PreviewItem(item.GetImage(ImageType.Thumb), "Thumb"));
  219. }
  220. if (item.BackdropImagePaths != null)
  221. previews.AddRange(
  222. item.BackdropImagePaths.Select(
  223. image => new PreviewItem(image, "Backdrop")));
  224. });
  225. lstPreviews.ItemsSource = previews;
  226. lstPreviews.Items.Refresh();
  227. }
  228. }
  229. /// <summary>
  230. /// The INDEN t_ STRING
  231. /// </summary>
  232. private const string INDENT_STRING = " ";
  233. /// <summary>
  234. /// Formats the json.
  235. /// </summary>
  236. /// <param name="str">The STR.</param>
  237. /// <returns>System.String.</returns>
  238. private static string FormatJson(string str)
  239. {
  240. var indent = 0;
  241. var quoted = false;
  242. var sb = new StringBuilder();
  243. for (var i = 0; i < str.Length; i++)
  244. {
  245. var ch = str[i];
  246. switch (ch)
  247. {
  248. case '{':
  249. case '[':
  250. sb.Append(ch);
  251. if (!quoted)
  252. {
  253. sb.AppendLine();
  254. Enumerable.Range(0, ++indent).ForEach(item => sb.Append(INDENT_STRING));
  255. }
  256. break;
  257. case '}':
  258. case ']':
  259. if (!quoted)
  260. {
  261. sb.AppendLine();
  262. Enumerable.Range(0, --indent).ForEach(item => sb.Append(INDENT_STRING));
  263. }
  264. sb.Append(ch);
  265. break;
  266. case '"':
  267. sb.Append(ch);
  268. bool escaped = false;
  269. var index = i;
  270. while (index > 0 && str[--index] == '\\')
  271. escaped = !escaped;
  272. if (!escaped)
  273. quoted = !quoted;
  274. break;
  275. case ',':
  276. sb.Append(ch);
  277. if (!quoted)
  278. {
  279. sb.AppendLine();
  280. Enumerable.Range(0, indent).ForEach(item => sb.Append(INDENT_STRING));
  281. }
  282. break;
  283. case ':':
  284. sb.Append(ch);
  285. if (!quoted)
  286. sb.Append(" ");
  287. break;
  288. default:
  289. sb.Append(ch);
  290. break;
  291. }
  292. }
  293. return sb.ToString();
  294. }
  295. /// <summary>
  296. /// Handles the SelectionChanged event of the ddlProfile control.
  297. /// </summary>
  298. /// <param name="sender">The source of the event.</param>
  299. /// <param name="e">The <see cref="SelectionChangedEventArgs" /> instance containing the event data.</param>
  300. private void ddlProfile_SelectionChanged(object sender, SelectionChangedEventArgs e)
  301. {
  302. CurrentUser = ddlProfile.SelectedItem as User;
  303. if (CurrentUser != null)
  304. LoadTree().ConfigureAwait(false);
  305. }
  306. /// <summary>
  307. /// Handles the Click event of the btnRefresh control.
  308. /// </summary>
  309. /// <param name="sender">The source of the event.</param>
  310. /// <param name="e">The <see cref="RoutedEventArgs" /> instance containing the event data.</param>
  311. private void btnRefresh_Click(object sender, RoutedEventArgs e)
  312. {
  313. if (tvwLibrary.SelectedItem != null)
  314. {
  315. var item = ((TreeViewItem)tvwLibrary.SelectedItem).Tag as BaseItem;
  316. if (item != null)
  317. {
  318. item.RefreshMetadata(CancellationToken.None, forceRefresh: cbxForce.IsChecked.Value);
  319. tvwLibrary_SelectedItemChanged(this, null);
  320. }
  321. }
  322. }
  323. /// <summary>
  324. /// Handles the SelectionChanged event of the ddlIndexBy control.
  325. /// </summary>
  326. /// <param name="sender">The source of the event.</param>
  327. /// <param name="e">The <see cref="SelectionChangedEventArgs" /> instance containing the event data.</param>
  328. private async void ddlIndexBy_SelectionChanged(object sender, SelectionChangedEventArgs e)
  329. {
  330. if (ddlIndexBy.SelectedItem != null)
  331. {
  332. var treeItem = tvwLibrary.SelectedItem as TreeViewItem;
  333. var folder = treeItem != null
  334. ? treeItem.Tag as Folder
  335. : null;
  336. var prefs = folder != null ? _displayPreferencesManager.GetDisplayPreferences(folder.GetDisplayPreferencesId(CurrentUser.Id)).Result : new DisplayPreferences { SortBy = ItemSortBy.SortName };
  337. if (folder != null && prefs.IndexBy != ddlIndexBy.SelectedItem as string)
  338. {
  339. //grab UI context so we can update within the below task
  340. var ui = TaskScheduler.FromCurrentSynchronizationContext();
  341. Cursor = Cursors.Wait;
  342. await Task.Factory.StartNew(() =>
  343. {
  344. using (
  345. new Profiler("Explorer full index expansion for " +
  346. folder.Name, _logger))
  347. {
  348. //re-build the current item's children as an index
  349. prefs.IndexBy = ddlIndexBy.SelectedItem as string;
  350. treeItem.Items.Clear();
  351. AddChildren(treeItem, OrderBy(folder.GetChildren(CurrentUser, prefs.IndexBy), CurrentUser, prefs.SortBy), CurrentUser);
  352. treeItem.Header = folder.Name + "(" +
  353. treeItem.Items.Count + ")";
  354. Cursor = Cursors.Arrow;
  355. }
  356. }, CancellationToken.None, TaskCreationOptions.None,
  357. ui);
  358. }
  359. }
  360. }
  361. /// <summary>
  362. /// Handles the SelectionChanged event of the ddlSortBy control.
  363. /// </summary>
  364. /// <param name="sender">The source of the event.</param>
  365. /// <param name="e">The <see cref="SelectionChangedEventArgs" /> instance containing the event data.</param>
  366. private async void ddlSortBy_SelectionChanged(object sender, SelectionChangedEventArgs e)
  367. {
  368. if (ddlSortBy.SelectedItem != null)
  369. {
  370. var treeItem = tvwLibrary.SelectedItem as TreeViewItem;
  371. var folder = treeItem != null
  372. ? treeItem.Tag as Folder
  373. : null;
  374. var prefs = folder != null ? _displayPreferencesManager.GetDisplayPreferences(folder.GetDisplayPreferencesId(CurrentUser.Id)).Result : new DisplayPreferences();
  375. if (folder != null && prefs.SortBy != ddlSortBy.SelectedItem as string)
  376. {
  377. //grab UI context so we can update within the below task
  378. var ui = TaskScheduler.FromCurrentSynchronizationContext();
  379. Cursor = Cursors.Wait;
  380. await Task.Factory.StartNew(() =>
  381. {
  382. using (
  383. new Profiler("Explorer sorting by " + ddlSortBy.SelectedItem + " for " +
  384. folder.Name, _logger))
  385. {
  386. //re-sort
  387. prefs.SortBy = ddlSortBy.SelectedItem as string;
  388. treeItem.Items.Clear();
  389. AddChildren(treeItem, OrderBy(folder.GetChildren(CurrentUser, prefs.IndexBy), CurrentUser, prefs.SortBy ?? ItemSortBy.SortName), CurrentUser);
  390. treeItem.Header = folder.Name + "(" +
  391. treeItem.Items.Count + ")";
  392. Cursor = Cursors.Arrow;
  393. }
  394. }, CancellationToken.None, TaskCreationOptions.None,
  395. ui);
  396. }
  397. }
  398. }
  399. }
  400. /// <summary>
  401. /// Class PreviewItem
  402. /// </summary>
  403. public class PreviewItem
  404. {
  405. /// <summary>
  406. /// The preview
  407. /// </summary>
  408. private readonly string preview;
  409. /// <summary>
  410. /// The name
  411. /// </summary>
  412. private readonly string name;
  413. /// <summary>
  414. /// Gets the preview.
  415. /// </summary>
  416. /// <value>The preview.</value>
  417. public string Preview
  418. {
  419. get { return preview; }
  420. }
  421. /// <summary>
  422. /// Gets the name.
  423. /// </summary>
  424. /// <value>The name.</value>
  425. public string Name
  426. {
  427. get { return name; }
  428. }
  429. /// <summary>
  430. /// Initializes a new instance of the <see cref="PreviewItem" /> class.
  431. /// </summary>
  432. /// <param name="p">The p.</param>
  433. /// <param name="n">The n.</param>
  434. public PreviewItem(string p, string n)
  435. {
  436. preview = p;
  437. name = n;
  438. }
  439. }
  440. /// <summary>
  441. /// Class Extensions
  442. /// </summary>
  443. static class Extensions
  444. {
  445. /// <summary>
  446. /// Fors the each.
  447. /// </summary>
  448. /// <typeparam name="T"></typeparam>
  449. /// <param name="ie">The ie.</param>
  450. /// <param name="action">The action.</param>
  451. public static void ForEach<T>(this IEnumerable<T> ie, Action<T> action)
  452. {
  453. foreach (var i in ie)
  454. {
  455. action(i);
  456. }
  457. }
  458. }
  459. #region ItemToImageConverter
  460. /// <summary>
  461. /// Class ItemToImageConverter
  462. /// </summary>
  463. [ValueConversion(typeof(string), typeof(bool))]
  464. public class ItemToImageConverter : IValueConverter
  465. {
  466. /// <summary>
  467. /// The instance
  468. /// </summary>
  469. public static ItemToImageConverter Instance =
  470. new ItemToImageConverter();
  471. /// <summary>
  472. /// Converts a value.
  473. /// </summary>
  474. /// <param name="value">The value produced by the binding source.</param>
  475. /// <param name="targetType">The type of the binding target property.</param>
  476. /// <param name="parameter">The converter parameter to use.</param>
  477. /// <param name="culture">The culture to use in the converter.</param>
  478. /// <returns>A converted value. If the method returns null, the valid null value is used.</returns>
  479. public object Convert(object value, Type targetType,
  480. object parameter, CultureInfo culture)
  481. {
  482. var item = value as BaseItem ?? new Folder();
  483. switch (item.DisplayMediaType)
  484. {
  485. case "DVD":
  486. case "HD DVD":
  487. case "Blu-ray":
  488. case "Blu-Ray":
  489. case "Movie":
  490. {
  491. var uri = new Uri
  492. ("pack://application:,,,/Resources/Images/movie.png");
  493. var source = new BitmapImage(uri);
  494. return source;
  495. }
  496. case "Series":
  497. {
  498. var uri = new Uri
  499. ("pack://application:,,,/Resources/Images/series.png");
  500. var source = new BitmapImage(uri);
  501. return source;
  502. }
  503. case "Season":
  504. {
  505. var uri = new Uri
  506. ("pack://application:,,,/Resources/Images/season.png");
  507. var source = new BitmapImage(uri);
  508. return source;
  509. }
  510. case "Episode":
  511. {
  512. var uri = new Uri
  513. ("pack://application:,,,/Resources/Images/episode.png");
  514. var source = new BitmapImage(uri);
  515. return source;
  516. }
  517. case "BoxSet":
  518. {
  519. var uri = new Uri
  520. ("pack://application:,,,/Resources/Images/boxset.png");
  521. var source = new BitmapImage(uri);
  522. return source;
  523. }
  524. case "Audio":
  525. {
  526. var uri = new Uri
  527. ("pack://application:,,,/Resources/Images/audio.png");
  528. var source = new BitmapImage(uri);
  529. return source;
  530. }
  531. case "Person":
  532. {
  533. var uri = new Uri
  534. ("pack://application:,,,/Resources/Images/persons.png");
  535. var source = new BitmapImage(uri);
  536. return source;
  537. }
  538. case "MusicArtist":
  539. {
  540. var uri = new Uri
  541. ("pack://application:,,,/Resources/Images/artist.png");
  542. var source = new BitmapImage(uri);
  543. return source;
  544. }
  545. case "MusicAlbum":
  546. {
  547. var uri = new Uri
  548. ("pack://application:,,,/Resources/Images/album.png");
  549. var source = new BitmapImage(uri);
  550. return source;
  551. }
  552. case "Trailer":
  553. {
  554. var uri = new Uri
  555. ("pack://application:,,,/Resources/Images/trailer.png");
  556. var source = new BitmapImage(uri);
  557. return source;
  558. }
  559. case "None":
  560. {
  561. Uri uri;
  562. if (item is Movie)
  563. uri = new Uri("pack://application:,,,/Resources/Images/movie.png");
  564. else if (item is Series)
  565. uri = new Uri("pack://application:,,,/Resources/Images/series.png");
  566. else if (item is BoxSet)
  567. uri = new Uri("pack://application:,,,/Resources/Images/boxset.png");
  568. else
  569. uri = new Uri("pack://application:,,,/Resources/Images/folder.png");
  570. return new BitmapImage(uri);
  571. }
  572. default:
  573. {
  574. var uri = new Uri("pack://application:,,,/Resources/Images/folder.png");
  575. var source = new BitmapImage(uri);
  576. return source;
  577. }
  578. }
  579. }
  580. /// <summary>
  581. /// Converts a value.
  582. /// </summary>
  583. /// <param name="value">The value that is produced by the binding target.</param>
  584. /// <param name="targetType">The type to convert to.</param>
  585. /// <param name="parameter">The converter parameter to use.</param>
  586. /// <param name="culture">The culture to use in the converter.</param>
  587. /// <returns>A converted value. If the method returns null, the valid null value is used.</returns>
  588. /// <exception cref="System.NotSupportedException">Cannot convert back</exception>
  589. public object ConvertBack(object value, Type targetType,
  590. object parameter, CultureInfo culture)
  591. {
  592. throw new NotSupportedException("Cannot convert back");
  593. }
  594. }
  595. #endregion // ItemToImageConverter
  596. }