public/documentation/better-thumbnail-browser/data/chapter-sub-items.html

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xmlns:xlink="http://www.w3.org/1999/xlink">
<head>
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
<title>Sub-items</title>
<link href="style.css" rel="stylesheet" type="text/css">
<link href="prettify.css" type="text/css" rel="stylesheet">
<script type="text/javascript" src="prettify.js"></script><script type="text/javascript" src="lang-vb.js"></script><link href="../resources/main.css" media="screen" rel="stylesheet" type="text/css">
</head>
<body onload="prettyPrint()"><div class="placing">
<br><table class="navigation"><tr>
<td class="navigation-previous"><a href="chapter-sort.html"><strong>
                « Sorting Items</strong></a></td>
<td class="navigation-index"><a href="../../../better-thumbnail-browser/documentation.html"><strong>Index</strong></a></td>
<td class="navigation-next"><a href="chapter-tooltips.html"><strong>Tooltips »
              </strong></a></td>
</tr></table>
<br><h1>Sub-items</h1>
<div class="banner">
  <a href="../../../better-thumbnail-browser.html"><img src="../resources/better-thumbnail-browser-overview.gif" alt="Better Thumbnail Browser" class="ss"></a>
  <div class="inside">
    <div class="text">Better Thumbnail Browser for .NET (C#, VB) - Image thumbnail viewing and loading control</div>
    <span class="dbtn-c dbtn-hilight"><span class="dbtn-w"><a href="../../../betterthumbnailbrowser.exe" class="dbtn">Download</a></span></span>
    <span class="dbtn-c"><span class="dbtn-w"><a href="../../../better-thumbnail-browser.html" class="dbtn">More Info</a></span></span>
  </div>
</div>
  

  

  <p>Every item within the list view can contain sub-items. These can be
  accessed using <span class="code">BetterListViewItem.SubItems</span> collection.</p>

  <p>Sub-items are displayed only in the <strong><em>Details</em></strong> view
  when the columns are present. Each item can have any number of sub-items,
  but the number of sub-items displayed is limited by the number of column
  headers.</p>

  <p>The following screenshot shows Better ListView with items and
  sub-items displayed on the right of each items (in columns) with one
  sub-item being focused (see <strong><em><a href="chapter-focus.html">Focusing
  Elements</a></em></strong> for more information):</p>

  <p class="images"><img src="sub-items.png"></p>

  <h2>Sub-item Visibility</h2>
    

    <p>Sub-item visibility depends on current view and column
    headers.</p>

    <p>In <strong><em>Details</em></strong> view, every column header has a
    corresponding sub-item. If all column headers are visible, sub-item
    indices (<span class="code">BetterListViewSubItem.Index</span>) corresponding to their
    display order. When individual column headers are <strong><em><a href="chapter-columns.html#hide-custom">hidden</a></em></strong>, the
    corresponding sub-items are hidden as well. The display order can be
    retrieved using <span class="code">BetterListViewSubItem.DisplayIndex</span> property
    in the same way as <span class="code">BetterListViewColumnHeader.DisplayIndex</span>
    property. Of course, sub-items with higher display index than the display
    index of the last column are hidden.</p>

    <p>In <strong><em>Tile</em></strong> view, image and label of the first
    sub-item is displayed along with labels of the other sub-items.</p>

    <p>In other views, only the first sub-item is visible.</p>
  

  <h2>Copying sub-items</h2>
    

    <p>The sub-item collection behaves differently than other collections
    present in Better ListView.</p>

    <p>It always have to contain at least one sub-item. Even if you call
    <span class="code">Clear</span> method, one sub-item remains in the collection. This is
    because this sub-item represents properties of the item itself.</p>

    <p>To copy sub-items from one item to another, you have to consider
    <strong><em>setting</em></strong> the first sub-item, while adding the
    other:</p>

    <p><strong>C#</strong></p>
<pre class="prettyprint"><code class="lang-cs">itemTarget.SubItems[0] = (BetterListViewSubItem)itemSource.SubItems[0].Clone();

for (int indexSubItem = 1; indexSubItem &lt; itemSource.SubItems.Count; indexSubItem++)
{
  itemTarget.SubItems.Add((BetterListViewSubItem)itemSource.SubItems[indexSubItem].Clone());
}</code></pre>

    <p><strong>Visual Basic</strong></p>
<pre class="prettyprint"><code class="lang-vb">itemTarget.SubItems(0) = DirectCast(itemSource.SubItems(0).Clone(), BetterListViewSubItem)

For indexSubItem As Integer = 1 To itemSource.SubItems.Count - 1
  itemTarget.SubItems.Add(DirectCast(itemSource.SubItems(indexSubItem).Clone(), BetterListViewSubItem))
Next</code></pre>
  
<br><div class="banner">
  <a href="../../../better-thumbnail-browser.html"><img src="../resources/better-thumbnail-browser-overview.gif" alt="Better Thumbnail Browser" class="ss"></a>
  <div class="inside">
    <div class="text">Better Thumbnail Browser for .NET (C#, VB) - Image thumbnail viewing and loading control</div>
    <span class="dbtn-c dbtn-hilight"><span class="dbtn-w"><a href="../../../betterthumbnailbrowser.exe" class="dbtn">Download</a></span></span>
    <span class="dbtn-c"><span class="dbtn-w"><a href="../../../better-thumbnail-browser.html" class="dbtn">More Info</a></span></span>
  </div>
</div>
<table class="navigation"><tr>
<td class="navigation-previous"><a href="chapter-sort.html"><strong>
                « Sorting Items</strong></a></td>
<td class="navigation-index"><a href="../../../better-thumbnail-browser/documentation.html"><strong>Index</strong></a></td>
<td class="navigation-next"><a href="chapter-tooltips.html"><strong>Tooltips »
              </strong></a></td>
</tr></table>
<br><table class="footer"><tr>
<td class="footer-title">Better Thumbnail Browser Documentation
                </td>
<td class="footer-copyright">
              Copyright © 2010-2012  <a href="../../../index.html" target="_blank">ComponentOwl.com</a>
</td>
</tr></table>
</div></body>
</html>