Controlling the Tab Order in Custom Dialogs
PSS ID Number: Q101551
Article last modified on 07-14-1994

2.00 2.00a 2.00a-CD 2.00b 2.00c

WINDOWS


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

 - Microsoft Word for Windows, versions 2.0, 2.0a, 2.0a-CD, 2.0b,
    and 2.0c
-------------------------------------------------------------------

SUMMARY
=======

There is currently no facility in the Microsoft Word for Windows
Dialog Editor for indicating the order in which items are selected
when the TAB key is pressed. Instead, the tab order is determined
by the position of the item descriptions within the actual custom
dialog definition.

By default, this tab order follows the order in which items were
created in the dialog box editor. In order to change this order,
you can physically reorder the item definitions in the dialog
definition after it has been copied into the macro editing window.

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

Consider the following dialog example:

   Sub Main
   Begin Dialog UserDialog 362, 275, "Microsoft Word"
    CancelButton 106, 246, 79, 21
    OKButton 16, 246, 79, 21
    TextBox 110, 5, 230, 18, .Text
    CheckBox 18, 33, 160, 18, "Check Me 1", .Check1
   End Dialog         'End of dialog definition
   Dim dlg As UserDialog
   n = Dialog(dlg)
   End Sub

The tab order for the above dialog is as follows:

1. CancelButton
2. OKButton
3. TextBox
4. CheckBox

To change the tab order of the items, you can reorder the items in the
dialog definition as follows:

   Sub Main
   Begin Dialog UserDialog 362, 275, "Microsoft Word"
    TextBox 110, 5, 230, 18, .Text
    CheckBox 18, 33, 160, 18, "Check Me 1", .Check1
    OKButton 16, 246, 79, 21
    CancelButton 106, 246, 79, 21
   End Dialog         'End of dialog definition
   Dim dlg As UserDialog
   n = Dialog(dlg)
   End Sub

The tab order for the above dialog is as follows:

1. TextBox
2. CheckBox
3. OKButton
4. CancelButton

REFERENCES
==========

"Using WordBasic" by WexTech Systems, Inc., and Microsoft Corporation,
Microsoft Press, 1992

Additional reference words: 2.00 2.00a 2.00a-CD 2.00b 2.00c w4wmacro
winword user defined editor

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

Copyright Microsoft Corporation 1994.
