Viewing or Modifying Item Properties

This topic describes explains how to use the standard properties dialog and embedded property editors to view and edit item properties. Depending on how your team has set up the application, you may see a totally different dialog box called an alternate property editor (APE).

Every time the properties of an item are modified, a new revision of that item is created. If you modify a property, you should also create a revision comment explaining the modification using the Revision Comment tab. If you modify a property, you should also create a revision comment explaining the modification using the Comment tab provided in the Properties dialog box.

In this topic:

Using the Standard Properties Dialog Box

To view or modify properties for items using the standard properties dialog box, do the following:

1. Select a folder from the folder tree or in the upper pane on the Folder tab.
2. Select an item in one of the StarTeam or Eclipse views.

3. Do one of the following:

   • Select an item and double click on it.
   • Right-click the folder or item and choose Properties.
   • Right-click an item on the Reference tab in the lower pane and choose Item Properties.
   • Click the Properties button.
4. Modify any of the property fields in the corresponding Properties dialog box that opens, then click OK.

Back to top

Embedded Property Editors

Embedded property editors allow you to:

• View, edit, and compare multiple StarTeam items at once.
• Copy values from one property editor to another.
• Continue to do other work while the embedded property editor is open, even if it has unsaved changes.

Back to top

Using Embedded Property Editors

To use embedded property editors, do the following:

1. Click the Use Embedded Editor button.

   The persistent default display mode for the selected item type will now be embedded editors instead of property editor dialogs.

2. Do one of the following:

   • Double-click the item.
   • Right-click the item and select Properties from the shortcut menu.

Each item opened in an embedded editor is displayed as a tab in the Embedded Editor pane below the Items pane. Each tab represents a unique item (and version) of the same or different Item type. You can view multiple versions of the same Item as well as Items of different types in the same Embedded Editor pane.

Once an embedded editor is open, use the Details Display and Embedded Editor Display icons to toggle back and forth between the Details pane and the Embedded Editor pane.

When an item is edited, asterisks will appear in the title bar and tab of the item's embedded property editor to indicate there are unsaved changes. On the right side of the title bar, all of the toolbar icons will also be enabled (the Close andClose All icons are always enabled). Each item's embedded property editor toolbar contains the following icons:

	The Compare Properties icon is enabled when there are unsaved changes to the item displayed in the embedded property editor. Click the icon to view the Compare Properties dialog and review changes made to the item during the current session. The original and new values for edited fields are displayed in bold type. Note that this icon is currently not available for an embedded APE editor.
	The Save and Close icon is enabled when there are unsaved changes to the item displayed in the embedded property editor. Click the icon to save the changes to the Item and close the item's embedded editor tab.
	The Apply icon is enabled when there are unsaved changes to the item displayed in the embedded property editor. Click the icon to save the changes to the Item and leave the item's embedded editor tab open.
	The Reset icon enabled when there are unsaved changes to the item displayed in the embedded property editor. Click the icon to discard changes made to the item during the current session and leave the item's embedded editor tab open.
	The Close icon is always enabled. Click this icon to close the item displayed in the embedded property editor. You will be prompted to save any changes to the item. You can also click the X on the tab to close the item.
	The Close All icon is always enabled. Click this icon to close all open embedded editors. You will be prompted to individually save each item that has unsaved changes.

Back to top

Dragging and Dropping Items into the Details/Embedded Editor Pane to View an Embedded Editor

To drag/drop items into the Details/Embedded Editor pane to view an embedded editor. do the following:

1. Drag the first item(s) from the Items pane into the Details/Embedded Editor pane.
2. Drag any successive item(s) to the title bar of the active item's embedded editor tab.

Back to top

Toggling Full Screen and Standard View

To toggle full screen and standard view in an embedded editor, do the following:

1. Double-click the title bar of the embedded property editor to view it in full screen mode.
2. Double-click the title bar of the property editor again to return to standard view.

Back to top