</ iframe > </noscript> <!-- End Google Tag Manager (noscript) --> <div id="BeforeHeaderContent"> </div> <div id="HeaderContent"> <div id="ProjectTitle">ComponentOne True DBGrid Pro 8</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 grid 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 grid, you must deal similarly with the bookmarks. The bookmarks themselves must be supplied by your code in the <a href="javascript:TL_1019115.HHClick()">UnboundGetRelativeBookmark</a>, <a href="javascript:TL_1019116.HHClick()">ClassicRead</a>, and <a href="javascript:TL_1019117.HHClick()">ClassicAdd</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> <ol> <li> <p>If you use the unbound grid 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> </li> <li> <p>If the database you use supports unique row IDs or record numbers, these can be conveniently used as bookmarks.</p> </li> <li> <p>If you use the grid to display an array, the array's row index is an obvious choice for bookmarks.</p> </li> </ol> <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 DBGrid'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 grid as variant bookmarks.</p> <p>Since True DBGrid 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> <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>