MDI (Multiple-Document Interface)

In a multiple-document interface application (that accepts DBCS text input), the DBCS keyboard shift status area should be included only in the primary window. To make child windows without the DBCS keyboard shift status area and share it with the parent window, the following are required:

• Create the parent window with FCF_DBE_APPSTAT frame control flag.

• Create the child windows without FCF_DBE_APPSTAT frame control flag.

• Issue WinDBCSIMEControl call with DBE_IMCTL_INHERIT_PFRAME flag for each child window (that accepts DBCS text input) to have the system maintain the DBCS input method status (enable, disable, enter or exit) of the child together with its parent.

• Issue WinDBCSModeControl call with DBE_MCTL_INHERIT_PFRAME flag for each child window (that accepts DBCS text input) to have the system maintain the the NLS shift status (country specific keyboard shift status) of the child together with its parent.

 IMEMODE IMEMode; ULONG usMode;
 ...
 /* create the parent window with FCF_DBE_APPSTAT flag */
 hwndFrame = WinCreateStdWindow(
     HWND_DESKTOP,
     ... ,
     FCF_DBE_APPSTAT | ... , /* with DBCS keyboard shift status area */
     ...
     hwndTop,
 );
 ...
 /* create the child windows without FCF_DBE_APPSTAT flag */
 hwndChildFrame = WinCreateStdWindow(
     hwndTop,
     ... ,
     ... , /* without DBCS keyboard shift status area */
     ...
     ...
 );
 ...
 /* issue WinDBCSIMEControl call with DBE_IMCTL_INHERIT_PFRAME flag */
 IMEMode.lenIMEMODE = sizeof(IMEMode);
 IMEMode.fIMEMode = DBE_IMCTL_INHERIT_PFRAME;
 WinDBCSIMEControl(hAB, hwndChildFrame, DBE_IMCTL_SET, &IMEMode);
 ...
 /* issue WinDBCSModeControl call with DBE_MCTL_INHERIT_PFRAME flag */
 usMode = DBE_MCTL_INHERIT_PFRAME;
 WinDBCSModeControl(hAB, hwndChildFrame, DBE_MCTL_SET,
                    DBE_MCTL_INPUTMODEREQUEST, &usMode);
 ...

The other capability of WinDBCSIMEControl call are to set or query the status (enabled, disabled, on or off) of the DBCS input method. The other capability of WinDBCSModeControl call is to set or query the NLS shift status. These usages are not explained in this book since usually these controls are done by keyboard operation rather than your program. The two calls are DBCS OS/2 unique calls and require special considerations to use; see Single Module.