Share via


Pocket PC Platform Behavior

[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]

It is important to be aware of platform-specific behavior when developing applications for Pocket PCs, especially when creating forms.

To prevent confusion and a cluttered appearance, the .NET Compact Framework displays forms to occupy the entire screen of 240x320 pixels. Forms cannot be resized or repositioned.

The Pocket PC taskbar is at the bottom of the screen, and used by all applications to display menu selections and to show and hide the InputPanel Component. When the user switches to a different application or form, the taskbar always shows the menu associated with the currently active form. The .NET Compact Framework hides the taskbar if the active form does not have a menu associated; therefore, the main form is created with an associated menu to prevent the taskbar from being hidden.

Note

On Windows CE, the main application form is not initially created with a menu. If one is added, it is positioned at the top of the form.

Controls and Core Elements

The following table lists how controls and other elements operate and appear on the Pocket PC. For more information about controls, see Controls in the .NET Compact Framework.

Note

Values greater than a 16-bit signed integer are not supported on a Pocket PC.

Control or Element

Behavior

BackColor for container controls

The BackColor for a Form, Panel, and TabPage is the Window system color.

Buttons to minimize and close programs

If ControlBox = true, the form displays the OK button in the upper-right corner which closes the form.

If ControlBox = true and Minimize = true, the form displays the smart minimize X button in the upper-right corner which runs the program in the background.

If ControlBox = false, the form does not display OK or X buttons.

Desktop

Screen without the menu bar.

ClientSize

Property decreases when a menu bar is added to a form.

Location

Property cannot be set unless FormBorderStyle = None

Size

Property cannot be unless FormBorderStye = None

Maximize Box

Setting to true or false has no affect. Maximize always has no affect because Pocket PC applications are run at full size.

Menus

Applications include a menu on the main form, by default, with all form menus positioned at the bottom of the display.

Menu Bar and Toolbar

(These controls are combined and can display both menu items and toolbar buttons.)

Retains a fixed position at the bottom of the screen. The location cannot be changed, as it is owned by the system.

Menu separator on the Main Menu

A menu separator is included on the Main Menu.

MessageBoxIcon enumeration

Supports the Asterisk, Exclamation, Hand, None, and Question enumerations.

Navigation Bar

This bar is the top portion of a Pocket PC application that contains the Start button, the title of the application, and the OK and X (smart minimize) buttons.

SaveFileDialog

If you do not specify a file name extension, Pocket PC appends the extension of the selected type in the dialog box.

Smart Minimize Button (X)

Sets the application to run in the background but does not close it.

Tab Control

Location is always anchored at 0,0 and stretches to fit the width of its container.

FormBorderStyle

The following table describes window characteristics on the Pocket PC.

FormBorderStyle

Behavior

Fixed3D

Same as FixedSingle.

FixedDialog

Same as FixedSingle.

FixedSingle

Window occupies the entire desktop and cannot be moved or resized.

FixedToolWindow

Same as FixedSingle.

None

Window is movable and resizable. Window is borderless with no window caption.

Sizable

Same as FixedSingle.

SizableToolWindow

Same as FixedSingle.

FormWindowState

The following table describes window states on the Pocket PC.

FormWindowState

Behavior

Maximized

If no menu bar, window occupies entire screen.

Normal

Window occupies the entire desktop.

Shortcuts

To have an icon saved in the Pocket PC Start Menu Most Recently Used (MRU) List, create a shortcut to your application somewhere under \Windows\Start Menu\Programs. When your application is launched from this shortcut an icon for your applications will appear the MRU list.

Display Shortcut Menus from a Hardware Button

You can configure a hardware button on a Pocket PC to display a shortcut menu, implemented by the ContextMenu control, with a Form or control in your application. You can associate one or more shortcut menus with hardware buttons, such as in the following scenario:

  • A Form associated with contextmenu1 displayed with hardware button 1.

  • A Panel associated with contextmenu2 displayed with hardware button 2.

  • A Button associated with contextmenu3 displayed with hardware button 3.

To associate a hardware button with a shortcut menu

  1. Develop your application to have shortcut menus using the ContextMenu control.

  2. On the Pocket PC, tap Start, Settings, Personal, and then Buttons.

  3. Select a button and assign it to a shortcut menu.

If a control with a shortcut menu has the focus, then pressing the associated hardware button displays its shortcut menu.

This feature is not available in Pocket PC 2002 and earlier versions.

See Also

Concepts

Pocket PC Form Style

Other Resources

Pocket PC Development and the .NET Compact Framework