COLLECT

The COLLECT sample illustrates a variety of the collection classes offered by the Microsoft Foundation Class Library for Windows CE (MFC CE).

The MFC collection classes can be classified according to shape and design, as follows:

Shapes:

• Lists
• Arrays
• Maps

Designs:

• Use of a C++ template–based collection of simple elements.
• Use of a C++ template–based collection of type-safe pointers.
• No use of C++ templates.

The COLLECT sample illustrates nine of these collections classes, representing a diverse combination of shapes and designs. Because the CTypedPtrArray and CTypedPtrList template-based collections are used differently, depending on whether they are being used to hold pointers to CObjects or to non-CObjects, the COLLECT sample illustrates both cases.

The nine collections illustrated by COLLECT are:

Additional COLLECT Features

In addition to illustrating the MFC collection classes, COLLECT also illustrates:

• Coordinating the addition and removal of entries in a list box with the addition and removal of entries in a collection.
• Switching between different views of a document, with only one shown at a time. Although COLLECT has many different views, it has a single-document interface (SDI) instead of a multiple-document interface (MDI).

The Example menu lists the nine collection class illustrations. Each example presents a form view that exercises many of the common collection operations:

• Adding a new element
• Inserting a new element in the middle of a list.
• Searching an element (by clicking its entry in the dialog box's list box).
• Searching an entry in the map by entering the Key and clicking Find.
• Updating the value of an element.
• Removing an element.
• Removing all the elements of the collection.

This sample demonstrates the following keywords:

You can find the COLLECT project files in the Wce\Samples\Mfc\COLLECT directory.

For information on the Windows CE platforms that support this sample, see MFC for Windows CE Samples.