Source Code Browsing (Windows CE 5.0)

The Source Code Browsing functionality in Windows CE extends the existing source code browsing system by allowing the integrated development environment (IDE) to display the location of the primary source code supporting Windows CE functionality, and in most cases, the code itself.

This makes it easier to understand which source code sections contribute to a specific Catalog item's functionality, and speeds the customization of the target device.

Source Code Browsing is not intended to allow you to build a Catalog item from the OSDesignView tab in the Workspace window.

To use Source Code Browsing, the source code must be registered in the Catalog, and it must be selected in your OS design.

For each Catalog item that has source code, the OSDesignView tab displays all source projects as subordinate nodes.

Syntax

To display source code information in the FileView window, Platform Builder collects the following:

  • The relative path for the directory where the sources file is located
  • A project description

These are imported into the Catalog, and drive the tree control for the display.

You specify this information through Catalog item (.cec) files, using the Action command in one of the BuildMethod blocks for your implementation.

  Action('#SRCCODE(type, "path"[, "Description"])')
  • type
    This specifies the type of build file referenced.

  • path
    This specifies the path to the sources, dirs, or Platform Builder project (.pbpxml) file.

    If a project is specified, include the file name for the project.

    If the directory or the file is not present, the OSDesignView tab does not display the node. Platform Builder also uses this path when you display the property page for the project or a source file.

  • description
    This contains the friendly description for the project, which is displayed in the OSDesignView tab.

In the following example, the source code for a Catalog item named Sample Component is in a sources file in the %_WINCEROOT%\Comp\Samples directory.

  Implementation
(
   Name ( "Sample Component" )
   GUID ({...})
   ...
   BuildMethods
   (
      BuildMethods
      {
         Step ( BSP )
         CPU ( DEFAULT )
         Action('#SRCCODE(SOURCES,"$(_WINCEROOT)\...", "Sample Component")')

See Also

Source Code Control | OS Design Configuration Files | Sources File | Dirs File | Catalog Window | OSDesignView Tab | Catalog Item Icon Types | Run-Time Image and OS Directories

Last updated on Thursday, February 02, 2006

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.