"The program may not display properly..." warning

Windows Mobile 2003 Second Edition has introduced support for screen rotation (switching between portrait and landscape modes without resetting the device) as well as square screens. When installing a CAB package on a Windows Mobile 2003 Second Edition device or later, the following warning message may be displayed:

"The program you have installed may not display properly because it was designed for a previous version of Windows Mobile software."

This warning message is to advise the user that the installed application may not be aware of square screens and/or screen rotation, and may not display properly in landscape mode. This is by no means an error message and it does not indicate a problem with the CAB package. Please see the MSDN article Developing Screen Orientation-Aware Applications for more details about this warning message as well as guidelines for supporting the new screen orientation features introduced in Windows Mobile 2003 Second Edition.

This warning message is showed only if the Minimum Operating System version specified for the CAB package is less than 4.21 (this is the core Windows CE OS version for Windows Mobile 2003 Second Edition devices as showed in the platforms summary table). However, setting the minimum OS version to this value will prevent the CAB package from installing on older platforms and device types. The recommended way to disable this warning is by setting the OS Build Max value to one of the values in the following table:

BuildMax valueMeaning
HexadecimalDecimal (unsigned)Decimal (signed)
0xA00000002684354560-1610612736The application supports square screens (240x240 pixels).
0xC00000003221225472-1073741824The application supports screen rotation.
0xE00000003758096384-536870912The application supports square screens and screen rotation.

NoteIn Advanced Installer, the minimum and maximum OS versions for the CAB package are computed automatically at build time if one of the first 2 radio buttons are selected in the Target Platforms tab from the Configurations page. In this case, you can use the “Screen Orientation Options” combobox in order to prevent the warning message from appearing, which will set the OS Build Max value accordingly.

TipWhen the third radio button is selected, you can enter the OS Build Max value directly in the corresponding field from the Operating System tab of the “Advanced Platform Settings” dialog. Make sure you enter one of the unsigned decimal values above (this will be improved in a future Advanced Installer version).