Managing the Summary and Details Panes (Windows Embedded CE 6.0)

1/6/2010

A service provider should never display its own progress box. ActiveSync uses its main program window to handle this task. The summary pane displays a status string and status bar. The details pane, immediately below the summary pane, lists the programs corresponding to the enabled service providers and displays status strings for individual service providers.

You do not need to control the progress bar. ActiveSync updates the progress bar while it looks for and synchronizes changes. It calculates the progress bar relative to the number of unsynchronized items reported by all the enabled service providers.

If you use the standard programming interfaces (for example, reporting the number of unsynchronized items), ActiveSync automatically manages the status string displayed in both the summary and details panes.

To provide accurate and useful information to the user, report only the items the user has selected to synchronize. For example, if a user chooses to synchronize a Web page, count only the one Web page as unsynchronized, not all the graphics, tables, frames, or other objects on the Web page. If a user chooses to synchronize financial transactions and makes three purchases, report three purchases as unsynchronized. Do not report the details, which might include the sum of three expenditures, three new payees, three new expense categories, and three new notes fields. A count of every synchronized object is interesting to programmers, but of no use to the average user.

See Also

Concepts

Design Guidelines for ActiveSync Synchronization Service Providers