BDeskbar Use Cases and Implementation Details:

This document describes the BDeskbar interface and some basics of how it is implemented. The document has the following sections:

  1. BDeskbar Interface
  2. BDeskbar Use Cases
  3. BDeskbar Implementation

BDeskbar Interface:

The BDeskbar class is a simple class for getting information from the deskbar and for modifying it from your application. The best source of source of information for the BDeskbar interface can be found here in the Be Book.

BDeskbar Use Cases:

The following use cases cover the BDeskbar functionality:

  1. Construction: A BDeskbar does not take any arguments when it is constructed. The BDeskbar instance creates a connection to the deskbar in order to get and change its state.

  2. Destruction: When a BDeskbar is deconstructed, the application's connection to the deskbar is closed. However any change to the deskbar's state made through the BDeskbar instance persists.

  3. Add Item 1:

  4. Add Item 2:

  5. Remove Item 1:

  6. Remove Item 2:

  7. Count Items:

  8. Has Item 1:

  9. Has Item 2:

  10. Get Item Info 1:

  11. Get Item Info 2:

  12. Frame:

  13. Location:

  14. Is Expanded:

  15. Set Location:

  16. Expand:

BDeskbar Implementation:

Internally, the BDeskbar uses a BMessenger to communicate with the deskbar itself. The actual messages used to perform its tasks will be documented here once they are determined. The source code from the OpenTracker project will be used as a reference for this effort.