</ 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">AllowFocus Property</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="objectreference.html">Object Reference</a> > <a href="truedbgridproperties.html">True DBGrid Properties</a> > AllowFocus Property</td></tr></table></div> <div id="BodyContent"> <p>AllowFocus Property</p> <p>Controls whether a column can receive focus.</p> <h3>Syntax</h3> <p>object.<strong>AllowFocus</strong>= boolean</p> <h3>Remarks</h3> <p>Read/Write at run time and design time.</p> <p>If <em><strong>True</strong></em> (the default), the user will be able to interactively select the object, giving it focus.</p> <p>If <em><strong>False</strong></em>, the user will not be able to interactively select the object. When clicked, the object will not receive focus and the control (or grid column) that previously had focus will retain it.</p> <p>For both split and column objects, setting AllowFocus to <em><strong>True</strong></em> enables cells within the object to receive focus. If set to <em><strong>False</strong></em>, there is no way to change the focus to a cell within the object. However, if an object already has the focus, setting AllowFocus to <em><strong>False</strong></em> will not give focus to another split, column, or control.</p> <p>If a cell in a column which does not allow focus is clicked, and the cell is in a row other than the current row, then the row is changed, but the column with the focus retains it.</p> <p>For splits, you can use this property in combination with the <a href="javascript:TL_1021168.HHClick()">AllowSizing</a> property to completely prohibit the user from making any changes to a split (by setting both properties to <em><strong>False</strong></em>). Unselectable splits are passed over when <a href="javascript:TL_1021169.HHClick()">TabAcrossSplits</a> is set to <em><strong>True</strong></em>.</p> <p>For columns, AllowFocus is a <i>split-specific</i> property, which means that the following statements are equivalent:</p> <p>TDBGrid1.Columns(1).AllowFocus = True</p> <p>TDBGrid1.Splits(TDBGrid1.Split).Columns(1).AllowFocus = True</p> <p>In other words, both of these statements affect column 1 in the current split only.</p> <p>Note</p> <p>At design time, the AllowFocus property appears in both the <strong>Splits</strong> property page (for <a href="javascript:TL_1021170.HHClick()">Split</a> objects) and the <strong>Layout</strong> property page (for <a href="javascript:TL_1021171.HHClick()">Column</a> objects).</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>