SAMPLE: Expand.exe Expands the Size of a Dialog Box

ID: Q35499

The information in this article applies to:

SUMMARY

Expand.exe is a sample that demonstrates how to create a dialog box that expands to provide additional controls when the user clicks on a button control.

MORE INFORMATION

The following file is available for download from the Microsoft Software Library:

 ~ Expand.exe (size: 19505 bytes) 

For more information about downloading files from the Microsoft Software Library, please see the following article in the Microsoft Knowledge Base:

   ARTICLE-ID: Q119591
   TITLE     : How to Obtain Microsoft Support Files from Online Services

The remainder of this article describes the algorithm demonstrated in the EXPAND file.

To use an expanding dialog box in an application, perform the following two preparation steps:

1. Design the entire dialog box and determine what controls will not

   be initially visible.

2. Disable these hidden controls in the dialog box template by
   including the WS_DISABLED style bit. This prevents the TAB key or
   the appropriate mnemonic key from giving the focus to one of the
   hidden controls.

When the user clicks the "expand" button, perform the following five steps:

1. Disable the expand button using EnableWindow(hWnd, FALSE).

2. Enable the previously hidden controls using EnableWindow(hWnd,

   TRUE).

3. Use SetFocus() to place the focus on the appropriate control.

4. Use the following function to retrieve the current position and

   size of the dialog:

      GetWindowRect(hWndDlg, (LPRECT)&r);

5. Use the following function to expand the dialog to its new size

      MoveWindow(hWndDlg, r.left, r.top, r.right - r.left,
                       (r.bottom - r.top) + change, TRUE);

   where "change" is the difference between the small size and the
   large size.

Note that the MoveWindow() function can be used to expand a window in any direction.

Additional query words: Keywords : kbfile kbsample kbDlg kbGrpUser kbWinOS310 kbWinOS300

Last Reviewed: December 26, 1998