LibraryExplorer.xaml.cs 28 KB

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