</ iframe > </noscript> <!-- End Google Tag Manager (noscript) --> <div id="BeforeHeaderContent"> </div> <div id="HeaderContent"> <div id="ProjectTitle">ComponentOne List 8.0 for ActiveX</div> <div id="PageTitle"><div id="PageTitleText">Application Mode Bookmarks</div></div> </div> <div id="AfterHeaderContent"> <!-- Spacing --> <span id="ToggleAllSectionsLink" class="FunctionLink"> <label id="CollapseAllLabel">Collapse All</label> <label id="ExpandAllLabel" style="display: none;">Expand All</label> </span> </div> <div class="BreadcrumbsContainer"><table><tr><td> <a href="applicationmode.html">Application Mode</a> > Application Mode Bookmarks</td></tr></table></div> <div id="BodyContent"> <p>In application mode, a bookmark is a variant supplied by your application and used by the list as a means of uniquely identifying a row of data to be displayed or modified.</p> <p>Just as your application provides, stores, and maintains the data for the unbound list, you must deal similarly with the bookmarks. The bookmarks themselves must be supplied by your code in the <a href="unboundgetrelativebookmarkevent.html">UnboundGetRelativeBookmark</a> and <a href="classicreadevent.html">ClassicRead</a> events as variant data. You are free to use whatever you choose for the purpose of identifying a row, but keep in mind that the bookmarks <strong>must</strong> be unique for each row. In general, you will also want to be able to search for the associated record quickly when given a bookmark. Three common examples of what to use for bookmarks are:</p> <p>1. If you use the unbound list with a proprietary database, you can use the values of a unique key field as bookmarks. That way, when given a bookmark, you can search and retrieve the associated record quickly.</p> <p>2. If the database you use supports unique row IDs or record numbers, these can be conveniently used as bookmarks.</p> <p>3. If you use the list to display an array, the array's row index is an obvious choice for bookmarks.</p> <p>Bookmarks cannot exceed 255 characters in length. Since Visual Basic 5.0 uses 2 bytes per character, this means that string bookmarks cannot exceed 127 characters.</p> <p>True DBList's application mode supports string, integral, and floating point bookmarks. All other data types must be converted to strings before they are passed to the list as variant bookmarks.</p> <p>Since True DBList and Visual Basic differ in their treatment of bookmarks, some restrictions apply when manipulating them in code, as discussed in the following sections.</p> <a name="seealsobookmark"></a> <div class="SectionHeading" id="seealsoSectionHeading"><span class="SectionHeadingIcon"><!-- --></span><span class="SectionHeadingText">See Also</span></div><div id="seealsoSectionContent" class="SectionContent"><div class="SeeAlsoLink"> <a href="bookmarksintruedblist.html">Bookmarks in True DBList</a></div> <div class="SeeAlsoLink"> <a href="bookmarksinvisualbasic.html">Bookmarks in Visual Basic</a></div> </div> </div> <div id="FooterContent"> <p> </p><p> </p><hr style="height: 1px"><p>Copyright (c) <script type="text/javascript"> var theDate=new Date() document.write(theDate.getFullYear()) </script> GrapeCity, inc. All rights reserved. <script> $(document).ready(function() { if (!(window.self !== window.top)) { // Not running in a frameset // Get the page name var pageName = location.href.substring(location.href.lastIndexOf("/") + 1); if (pageName.indexOf("#") != -1) { pageName = pageName.substring(0, pageName.indexOf("#")); } // Append to webframe.html var framePage = "webframe.html#" + pageName; location.href = framePage; } }); </script></p> <a target="_blank" href="http://our.componentone.com/groups/">Product Support Forum</a> | <a target="_blank" href="http://feedback.componentone.com/forums/255792-activex-documentation">Documentation Feedback</a> </div> </body> </html>