226 lines
9.8 KiB
HTML
226 lines
9.8 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-splitbutton/data/style.css" rel="stylesheet" type="text/css">
|
||
|
|
<link href="../documentation/better-splitbutton/data/prettify.css" type="text/css" rel="stylesheet">
|
||
|
|
<script type="text/javascript" src="../documentation/better-splitbutton/data/prettify.js"></script><script type="text/javascript" src="../documentation/better-splitbutton/data/lang-vb.js"></script><link href="../documentation/better-splitbutton/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"></td>
|
||
|
|
<td class="navigation-index"><a href="documentation.html"><strong>Index</strong></a></td>
|
||
|
|
<td class="navigation-next"><a href="../documentation/better-splitbutton/data/chapter-properties.html"><strong>Better SplitButton Properties »
|
||
|
|
</strong></a></td>
|
||
|
|
</tr></table>
|
||
|
|
<br><h1>Quick Start</h1>
|
||
|
|
<div class="banner">
|
||
|
|
<a href="../better-listview.html"><img src="../documentation/better-splitbutton/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#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-splitbutton/data/designer.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 SplitButton.</p>
|
||
|
|
|
||
|
|
<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-splitbutton/data/choose_items.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.1.0.0 instead of
|
||
|
|
1.0.0.0) and click "<strong><em>OK</em></strong>":</p>
|
||
|
|
|
||
|
|
<p class="images"><img src="../documentation/better-splitbutton/data/toolbox.png"></p>
|
||
|
|
|
||
|
|
<p>Now the component should appear in your Toolbox. Select the
|
||
|
|
component and place it on designer surface:</p>
|
||
|
|
|
||
|
|
<p class="images"><img src="../documentation/better-splitbutton/data/place_button.png"></p>
|
||
|
|
|
||
|
|
<p>Now you can design Better SplitButton the same way as any other
|
||
|
|
control:</p>
|
||
|
|
|
||
|
|
<p class="images"><img src="../documentation/better-splitbutton/data/properties.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>Updating to Newer Version of Better SplitButton</h2>
|
||
|
|
|
||
|
|
|
||
|
|
<p>If a new version of Better SplitButton is released, to update to
|
||
|
|
newer version, simply <strong><em><a href="../bettersplitbutton.exe">download</a></em></strong>
|
||
|
|
and install the new version. The installer will prompt for updating to a
|
||
|
|
new version.</p>
|
||
|
|
|
||
|
|
<p>The DLL with the component (<span class="code">betterlistview.dll</span>) is
|
||
|
|
installed usually in <strong><em>Program Files</em></strong> folder, so if you
|
||
|
|
use copies of the library on other locations on your disk, replace the old
|
||
|
|
copies with the new version.</p>
|
||
|
|
|
||
|
|
<p>The <strong><em>licenses.licx</em></strong> file in your project may also
|
||
|
|
point to an older version of Better ListView. To update
|
||
|
|
<strong><em>licenses.licx</em></strong> open some form with Better ListView in
|
||
|
|
<strong><em>Windows Forms Designer</em></strong> and compile. A new line will
|
||
|
|
be added to the <strong><em>licenses.licx</em></strong> for the new version of
|
||
|
|
the Better ListView. You can delete the line with the reference to older
|
||
|
|
version, e.g.:</p>
|
||
|
|
|
||
|
|
<pre>ComponentOwl.BetterListView.BetterListView, BetterListView, Version=1.0.0.0, Culture=neutral, PublicKeyToken=e6c91a3add447be2</pre>
|
||
|
|
|
||
|
|
<p>should be switched to:</p>
|
||
|
|
|
||
|
|
<pre>ComponentOwl.BetterListView.BetterListView, BetterListView, Version=2.2.0.0, Culture=neutral, PublicKeyToken=e6c91a3add447be2</pre>
|
||
|
|
|
||
|
|
<p>if <span class="code">2.2.0.0</span> is the updated version of Better ListView.
|
||
|
|
You can do the update of licenses.licx file with text editor within
|
||
|
|
<strong><em>Visual Studio</em></strong>, if you know the new version
|
||
|
|
number.</p>
|
||
|
|
|
||
|
|
|
||
|
|
<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></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 SplitButton Samples</pre>
|
||
|
|
|
||
|
|
<p>Windows XP:</p>
|
||
|
|
|
||
|
|
<pre>\Documents and Settings\<user directory>\My Documents\ComponentOwl\Better SplitButton 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-splitbutton/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"></td>
|
||
|
|
<td class="navigation-index"><a href="documentation.html"><strong>Index</strong></a></td>
|
||
|
|
<td class="navigation-next"><a href="../documentation/better-splitbutton/data/chapter-properties.html"><strong>Better SplitButton Properties »
|
||
|
|
</strong></a></td>
|
||
|
|
</tr></table>
|
||
|
|
<br><table class="footer"><tr>
|
||
|
|
<td class="footer-title">Better SplitButton Documentation
|
||
|
|
</td>
|
||
|
|
<td class="footer-copyright">
|
||
|
|
Copyright © <a href="../index.html" target="_blank">ComponentOwl.com</a>
|
||
|
|
</td>
|
||
|
|
</tr></table>
|
||
|
|
</div></body>
|
||
|
|
</html>
|