304 lines
13 KiB
HTML
304 lines
13 KiB
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>Quick Start</title>
|
|
<link href="../documentation/better-listview-express/data/style.css" rel="stylesheet" type="text/css">
|
|
<link href="../documentation/better-listview-express/data/prettify.css" type="text/css" rel="stylesheet">
|
|
<script type="text/javascript" src="../documentation/better-listview-express/data/prettify.js"></script><script type="text/javascript" src="../documentation/better-listview-express/data/lang-vb.js"></script><link href="../documentation/better-listview-express/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="../documentation/better-listview-express/data/chapter-introduction.html"><strong>
|
|
« Introduction, Comparison</strong></a></td>
|
|
<td class="navigation-index"><a href="documentation.html"><strong>Index</strong></a></td>
|
|
<td class="navigation-next"><a href="../documentation/better-listview-express/data/chapter-background-image.html"><strong>Background Image »
|
|
</strong></a></td>
|
|
</tr></table>
|
|
<br><h1>Quick Start</h1>
|
|
<div class="banner">
|
|
<a href="../better-listview.html"><img src="../documentation/better-listview-express/resources/overview.gif" alt="Better ListView" class="ss"></a>
|
|
<div class="inside">
|
|
<div class="text">Better ListView: Ultimate .NET ListView replacement control for WinForms (C#, VB.NET)</div>
|
|
<span class="dbtn-c dbtn-hilight"><span class="dbtn-w"><a href="../betterlistview.exe" class="dbtn">Download</a></span></span>
|
|
<span class="dbtn-c"><span class="dbtn-w"><a href="../better-listview.html" class="dbtn">More Info</a></span></span>
|
|
</div>
|
|
</div>
|
|
<h2>Table of Contents</h2>
|
|
<p class="toc-entry"><a href="quick-start-guide.html#prerequisites">Tutorial Prerequisites</a></p>
|
|
<p class="toc-entry"><a href="quick-start-guide.html#tutorial">Step-by-step tutorial</a></p>
|
|
<p class="toc-entry"><a href="quick-start-guide.html#troubleshooting">Installation
|
|
Troubleshooting</a></p>
|
|
<p class="toc-entry"><a href="quick-start-guide.html#migrating">Migrating from .NET ListView</a></p>
|
|
<p class="toc-entry"><a href="quick-start-guide.html#support">Learning Resources and Getting
|
|
Support</a></p>
|
|
|
|
|
|
|
|
|
|
<h2>
|
|
<a name="prerequisites" id="prerequisites"></a>Tutorial Prerequisites</h2>
|
|
|
|
|
|
<ul>
|
|
<li>
|
|
<p>Visual Studio 2010 / 2008 / 2005</p>
|
|
</li>
|
|
<li>
|
|
<p>.NET Framework 2.0 / 3.0 / 3.5 / 4.0 (<strong><em>make sure it is
|
|
not a "Client Profile" or "Compact Framework" - these are not
|
|
supported</em></strong>)</p>
|
|
</li>
|
|
<li>
|
|
<p>Visual C# or Visual Basic</p>
|
|
</li>
|
|
</ul>
|
|
<h2>
|
|
<a name="tutorial" id="tutorial"></a>Step-by-step Tutorial</h2>
|
|
|
|
|
|
<p>Start with a new "<strong><em>Windows Forms Application</em></strong>"
|
|
project. A designer with empty Form appears. Display the
|
|
<strong><em>Toolbox</em></strong> window (<strong><em>View -
|
|
Toolbox</em></strong>):</p>
|
|
|
|
<p class="images"><img src="../documentation/better-listview-express/data/quickstart1.png"></p>
|
|
|
|
<p>The Toolbox should contain a new tab called
|
|
"<strong><em>ComponentOwl</em></strong>" containing all the installed component
|
|
from ComponentOwl, including Better ListView.</p>
|
|
|
|
<br><hr>
|
|
<p class="note">Express editions of ComponentOwl Controls are listed in separate
|
|
tab called "ComponentOwl (Express Controls)".</p>
|
|
<hr>
|
|
<br><p>If you chose <strong><em>not to</em></strong> integrate component in
|
|
Visual Studio during installation or the component have not been
|
|
successfully integrated, please follow the next steps.</p>
|
|
|
|
<p>Right-click on empty area of the Toolbox window and select
|
|
"<strong><em>Choose Items...</em></strong>":</p>
|
|
|
|
<p class="images"><img src="../documentation/better-listview-express/data/quickstart2.png"></p>
|
|
|
|
<p>In the "<strong><em>Choose Toolbox Items</em></strong>" dialog, select
|
|
the "<strong><em>.NET Framework Components</em></strong>" tab. If the comonent
|
|
has been properly installed, it will be already listed here. If you find
|
|
it, make sure the newest version is checked (e.g. 2.5.2.0 instead of
|
|
1.0.0.0) and click "<strong><em>OK</em></strong>":</p>
|
|
|
|
<p class="images"><img src="../documentation/better-listview-express/data/quickstart3-1.png"></p>
|
|
|
|
<p>If you need other than installed version (e.g. DLL to match for
|
|
specific .NET Framework version) click on the
|
|
"<strong><em>Browse...</em></strong>" button:</p>
|
|
|
|
<p class="images"><img src="../documentation/better-listview-express/data/quickstart3-2.png"></p>
|
|
|
|
<p>Browse for the <span class="code">betterlistview.dll</span> file containing the
|
|
component.</p>
|
|
|
|
<br><hr>
|
|
<p class="note">If you use <strong><em>Better ListView Express</em></strong> edition,
|
|
locate component named <span class="code">BetterListViewExpress</span> or DLL named
|
|
<span class="code">betterlistviewexpress.dll</span>.</p>
|
|
<hr>
|
|
<br><p>The location depends on where you installed the product. The default
|
|
location is:</p>
|
|
|
|
<pre>C:\Program Files\Component Owl\Better ListView\Redistributable</pre>
|
|
|
|
<p>You can choose the file right within
|
|
"<strong><em>Redistributable</em></strong>" folder. This is .NET 2.0 component
|
|
compatible with .NET Framework 2.0 or higher. If you want binary for a
|
|
specific .NET version, choose the file from "<strong><em>.NET Framework
|
|
Specific</em></strong>" folder:</p>
|
|
|
|
<p class="images"><img src="../documentation/better-listview-express/data/quickstart4.png"></p>
|
|
|
|
<p>Make sure the check box next to
|
|
"<strong><em>BetterListView</em></strong>" is checked and click
|
|
"<strong><em>OK</em></strong>":</p>
|
|
|
|
<p class="images"><img src="../documentation/better-listview-express/data/quickstart5.png"></p>
|
|
|
|
<p>Now the component should appear in your Toolbox:</p>
|
|
|
|
<p class="images"><img src="../documentation/better-listview-express/data/quickstart6.png"></p>
|
|
|
|
<p>Select the component and place it on designer surface:</p>
|
|
|
|
<p class="images"><img src="../documentation/better-listview-express/data/quickstart7.png"></p>
|
|
|
|
<p>Now you can design Better ListView the same way as any other
|
|
control:</p>
|
|
|
|
<p class="images"><img src="../documentation/better-listview-express/data/quickstart8.png"></p>
|
|
|
|
|
|
<h2>
|
|
<a name="troubleshooting" id="troubleshooting"></a>Installation
|
|
Troubleshooting</h2>
|
|
|
|
|
|
<p>If the component does not appear in Toolbox, make sure that your
|
|
target framework version is a full-featured .NET Framework 2.0, 3.0, 3.5
|
|
or 4.0. The Compact Framework or Client Profile are not supported.</p>
|
|
|
|
<p>You can also try the "<strong><em>Reset Toolbox</em></strong>" option
|
|
from the Toolbox context menu, restart Visual Studio and try to add the
|
|
control again.</p>
|
|
|
|
<p>Sometimes even the Toolbox can get corrupted (known issue on Visual
|
|
Studio 2010) and its cache needs to be cleared. Simply remove all
|
|
"<strong><em>.tbd</em></strong>" files from this folder:</p>
|
|
|
|
<p>Vista/Windows 7:</p>
|
|
|
|
<pre>\Users\<user>\AppData\Local\Microsoft\VisualStudio\10.0\*.tbd</pre>
|
|
|
|
<p>Windows XP:</p>
|
|
|
|
<pre>\Documents and Settings\<user directory>\Local Settings\Application Data\Microsoft\VisualStudio\10.0\*.tbd</pre>
|
|
|
|
<p>Make sure the Visual Studio is not running when removing the files.
|
|
The Toolbox should reload its default items when opened.</p>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<h2>
|
|
<a name="migrating" id="migrating"></a>Migrating from .NET ListView</h2>
|
|
|
|
|
|
<p>We did our best to make Better ListView as similar to regular .NET
|
|
ListView as possible. Better ListView, however, is not a ListView-derived
|
|
control - it is completely autonomous WinForms control. The following
|
|
rules of thumb will help you to migrate from ListView to Better
|
|
ListView:</p>
|
|
|
|
<ul>
|
|
<li>
|
|
<p>Most structures are named equally, only with
|
|
<strong><em>Better-</em></strong> prefix (e.g.
|
|
<span class="code">BetterListViewItem</span> instead of
|
|
<span class="code">ListViewItem</span>).</p>
|
|
</li>
|
|
<li>
|
|
<p>Better ListView <strong><em>does not</em></strong> use the same
|
|
structures and classes as .NET ListView (e.g. use
|
|
<span class="code">ComponentOwl.BetterListView.BetterListViewView</span> instead of
|
|
<span class="code">System.Windows.Forms.View</span>).</p>
|
|
</li>
|
|
<li>
|
|
<p>Many features and structures of Better ListView are richer (e.g.
|
|
insertion mark, Drag and Drop functionality), so they contain extra
|
|
overrides for constructors, methods and properties - sometimes they
|
|
are used differently and behave little bit differently; look in the
|
|
documentation first to avoid confusion.</p>
|
|
</li>
|
|
</ul>
|
|
<p>To compare usage of .NET ListView and Better ListView, consider the
|
|
following code using the <strong><em>regular .NET
|
|
ListView</em></strong>:</p>
|
|
|
|
<p><strong>C#</strong></p>
|
|
<pre class="prettyprint"><code class="lang-cs">BetterListView listView = new BetterListView();
|
|
|
|
BetterListViewItem item = new BetterListViewItem("new item");
|
|
|
|
listView.Items.Add(item);
|
|
|
|
listView.View = BetterListViewView.List;
|
|
|
|
// ...
|
|
|
|
BetterListViewHitTestInfo hitTestInfo = listView.HitTest(new Point(0, 0));</code></pre>
|
|
|
|
<p><strong>Visual Basic</strong></p>
|
|
<pre class="prettyprint"><code class="lang-vb">Dim listView As New BetterListView()
|
|
|
|
Dim item As New BetterListViewItem("new item")
|
|
|
|
listView.Items.Add(item)
|
|
|
|
listView.View = BetterListViewView.List
|
|
|
|
' ...
|
|
|
|
Dim hitTestInfo As BetterListViewHitTestInfo = listView.HitTest(New Point(0, 0))</code></pre>
|
|
|
|
|
|
<h2>
|
|
<a name="support" id="support"></a>Learning resources and getting
|
|
support</h2>
|
|
|
|
|
|
<p>The documentation and learning resources include:</p>
|
|
|
|
<ul>
|
|
<li>
|
|
<p><strong><em>HTML documentation</em></strong> with over 30 chapters
|
|
(the Quick Start guide you are reading right now is the second
|
|
chapter)</p>
|
|
</li>
|
|
<li>
|
|
<p>Sample projects in C# and VB.NET</p>
|
|
</li>
|
|
<li>
|
|
<p>Samples explorer (which includes source code snippets as
|
|
well)</p>
|
|
</li>
|
|
<li>
|
|
<p>Class reference (technical documentation)</p>
|
|
</li>
|
|
</ul>
|
|
<p>You can find all these resources in <strong><em>Start Menu - Better
|
|
ListView</em></strong>.</p>
|
|
|
|
<p>The C# and Visual Basic Samples are located at:</p>
|
|
|
|
<p>Vista/Windows 7:</p>
|
|
|
|
<pre>\Users\<user>\Documents\ComponentOwl\Better ListView Samples</pre>
|
|
|
|
<p>Windows XP:</p>
|
|
|
|
<pre>\Documents and Settings\<user directory>\My Documents\ComponentOwl\Better ListView Samples</pre>
|
|
|
|
<p>Make sure the Visual Studio is not running when removing the files.
|
|
The Toolbox should reload its default items when opened.</p>
|
|
|
|
<p>We will happily answer any of your questions and provide further
|
|
assistance. Just email us at <strong><em><a href="mailto:support@componentowl.com?subject=Better%20ListView%20Support">support@componentowl.com</a></em></strong>.
|
|
Or, you can use the online form at <strong><em><a href="../support.html">www.componentowl.com/support</a></em></strong>.</p>
|
|
|
|
|
|
|
|
<br><div class="banner">
|
|
<a href="../better-listview.html"><img src="../documentation/better-listview-express/resources/overview.gif" alt="Better ListView" class="ss"></a>
|
|
<div class="inside">
|
|
<div class="text">Better ListView: Ultimate .NET ListView replacement control for WinForms (C#, VB.NET)</div>
|
|
<span class="dbtn-c dbtn-hilight"><span class="dbtn-w"><a href="../betterlistview.exe" class="dbtn">Download</a></span></span>
|
|
<span class="dbtn-c"><span class="dbtn-w"><a href="../better-listview.html" class="dbtn">More Info</a></span></span>
|
|
</div>
|
|
</div>
|
|
<table class="navigation"><tr>
|
|
<td class="navigation-previous"><a href="../documentation/better-listview-express/data/chapter-introduction.html"><strong>
|
|
« Introduction, Comparison</strong></a></td>
|
|
<td class="navigation-index"><a href="documentation.html"><strong>Index</strong></a></td>
|
|
<td class="navigation-next"><a href="../documentation/better-listview-express/data/chapter-background-image.html"><strong>Background Image »
|
|
</strong></a></td>
|
|
</tr></table>
|
|
<br><table class="footer"><tr>
|
|
<td class="footer-title">Better ListView Express Documentation
|
|
</td>
|
|
<td class="footer-copyright">
|
|
Copyright © <a href="../index.html" target="_blank">ComponentOwl.com</a>
|
|
</td>
|
|
</tr></table>
|
|
</div></body>
|
|
</html>
|