Using the Catalog Editor to Edit an Existing Catalog File
Other versions of this page are also available for the following:
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/27/2008
In Platform Builder for Windows Embedded CE 6.0, you can use the Catalog Editor to view and edit existing Catalog files, such as .pbcxml files. For information about creating a Catalog item file, see Using the Catalog Editor to Create a Catalog File.
After you have done this, you can add the Catalog item to the Catalog. For information about adding a Catalog item to the Catalog, see Adding a Catalog Item to the Catalog.
Editing a Catalog item in an existing Catalog File
Open a Catalog file by using the Catalog Editor.
For more information, see Using the Catalog Editor to Open an Existing Catalog File.
If you have not yet created a Catalog item in the Catalog file, choose the Add arrow, and then choose Catalog Item.
Navigate to the Catalog item that you want to modify, select it, and then, from the context menu, select Properties.
In the Properties pane of the Catalog Editor, you can view and modify the properties for the Catalog item. For more information, see Catalog Item Properties.
To modify the supported CPUs for the Catalog item, enter the CPUs that you want to support in the Supported CPU field.
By default, this field is empty. Specifying a CPU means that your Catalog item is supported by only the board support packages (BSPs) that support the same CPU.
(Optional) If you want to include Help for your Catalog item, enter the link for the Help text that is associated with the Catalog item in the Help Link field.
To modify the display name displayed in the Catalog, enter the Catalog item name that you want to use in the Title field.
To modify the unique ID that is associated with the Catalog item in the Catalog, enter the ID string that you want to use.
Note
To avoid Catalog collisions, we recommend that you use an ID string that begins with the Catalog record type and the vendor name to avoid Catalog collisions. For example, for an ID string for a Catalog item, you would use the format <Item:DefaultVendor:DefaultItemName>, where <Item> is a placeholder for the Catalog record type, <DefaultVendor> is a placeholder for the vendor name, and <DefaultItemName> is a placeholder for the name of the Catalog item..
To save your changes, from the File menu, select Save.
Editing a source code link in an existing Catalog File
Open a Catalog file in the Catalog Editor.
If you have not yet created a source code link in the Catalog file, choose the Add arrow, and then choose Source Code Link.
Navigate to the source code link that you want to modify, and then select it.
In the Properties pane of the Catalog Editor, you can view and modify the default name and path properties of the source code link.
To edit the name that is displayed, enter a display name for the source code path in the Title field.
To edit the path for the source code link, enter the directory path, or browse to the source code for the selected Catalog item in the Path field.
To save your changes, from the File menu, select Save.
Editing a BSP in an existing Catalog File
Open a Catalog file in the Catalog Editor.
If you have not yet created a BSP item in the Catalog file, choose the Add arrow, and then choose BSP.
Navigate to the BSP that you want to modify, and then select it.
To modify the name of the subdirectory for the BSP in the %_WINCEROOT%\Platform directory, enter the name that you want to use in the Platform Directory field.
To modify the supported CPU for the BSP, enter the CPU that you want to support into the Supported CPU field.
(Optional) If you want to include Help for your BSP, enter the link for the Help associated with the BSP into the Help Link field.
To modify the display name of the Catalog item as it is displayed in the Catalog, enter the BSP name that you want to use into the Title field.
To modify the unique ID that is associated with the BSP that is in the Catalog, enter the ID string that you want to use.
Note
To avoid Catalog collisions, we recommend that you use an ID string that begins with the Catalog record type and the vendor name. For example, for an ID string for a BSP, you would use the format <Bsp:DefaultVendor:DefaultBspName>, where <Bsp> is a placeholder for the Catalog record type, <DefaultVendor> is a placeholder for the vendor name, and <DefaultBspName> is a placeholder for the name of the BSP.
To save your changes, from the File menu, select Save.
See Also
Concepts
Catalog Editor
Catalog Files
Catalog Item Properties