DOCUMENT:Q192089  02-SEP-1998  [vbwin]
TITLE   :BUG: Setting OptionButton Value to True Sets TabStop to True
PRODUCT :Microsoft Visual Basic for Windows
PROD/VER:WINDOWS:5.0,6.0
OPER/SYS:WINDOWS
KEYWORDS:

======================================================================
---------------------------------------------------------------------
The information in this article applies to:

 - Microsoft Visual Basic Learning, Professional, and Enterprise Editions
   for Windows, versions 5.0, 6.0
---------------------------------------------------------------------

SYMPTOMS
========

Setting the Value property of an OptionButton equal to True, either by
setting it through code or clicking the radio button, the TabStop property
is also set to True.

STATUS
======

Microsoft has confirmed this to be a problem in the Microsoft products
listed at the beginning of this article.

MORE INFORMATION
================

Steps to Reproduce Behavior
---------------------------

1. Start a new Standard EXE project in Visual Basic. Form1 is created by
   default.

2. Add a CommandButton and an OptionButton to Form1.

3. Add the following code to the form module:

      Sub Form_Load()
         Option1.TabStop = False
      End Sub

      Sub Form_Click()
         Option1.Value = True
         Debug.Print Option1.TabStop
      End Sub

4. Save the project and run it.

5. Press the TAB key and note that you cannot tab between controls.

6. Now click on the Form, which will set the Value property of the
   OptionButton equal to True. The same behavior will occur if the
   OptionButton is clicked with the mouse.

7. Press the TAB key again. Note this time that you are able to tab to the
   OptionButton. This occurs because setting the Value property to True
   sets the TabStop property to True.

8. To work around this bug, reset the TabStop property equal to False after
   the Value property is set to True. In design-mode, modify the Form Click
   event to look similar to the following:

      Sub Form_Click()
         Option1.Value = True
         Option1.TabStop = False
         Debug.Print Option1.TabStop
      End Sub

9. Repeat steps 4-7, and note that the OptionButton is never in the tabbing
   sequence.

REFERENCES
==========

For additional information, please see the following article in the
Microsoft Knowledge Base:

   ARTICLE-ID: Q191720
   TITLE     : BUG: Option Button Value Changes When Group is Disabled

Additional query words: kbDSupport kbDSD kbVBp kbCtrl kbVBp600bug
kbVBp500bug
======================================================================
Version           : WINDOWS:5.0,6.0
Platform          : WINDOWS
Issue type        : kbbug

=============================================================================

THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS
PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND.  MICROSOFT DISCLAIMS
ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  IN NO
EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR
ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL,
CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF
MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES.  SOME STATES DO NOT ALLOW THE EXCLUSION
OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES
SO THE FOREGOING LIMITATION MAY NOT APPLY.

Copyright Microsoft Corporation 1998.