Context Menu preferences

You can customize context menu items for different object types to quickly access frequently used actions.

Customization of the context menu is available for the following object types:

  • Directories

  • File revisions

  • Files

  • Labels

  • Pending changelists

  • Shelved files

  • Streams

  • Submitted changelists

  • Workspaces

Edit a context menu

  1. In the Context menu for drop-down, select the type of object for which you want to customize the context menu.

  2. To add items to a context menu:

    • Click Insert items..., .

      The Insert Menu Items dialog opens.

    • Select the item to add, and then click OK.

      The item is added after the selected item, or at the bottom if no item is selected.

    You can also add:

    • Custom tools using Insert Custom Tools

    • HTML window actions using Insert HTML Windows

    When tools are available from more than one source, the Insert Menu Items dialog groups them by source.

    Custom tools can appear under:

    • My Custom Tools

    • Server Tools

    • Shared Tools

    HTML windows can appear under:

    • My HTML Windows

    • Server Tools

    • Shared Tools

    Published and shared tool-definition files can optionally specify a displayName attribute. When a non-empty displayName value is present, P4V displays that value instead of the default Server Tools or Shared Tools label. As a result, you might see custom group names such asDeveloper, ABC Developer, or Rob's Utilities.

    If multiple shared tool-definition files are available, each file appears as a separate Shared Tools (file-name) group by default. If a shared tool-definition file specifies a displayName attribute, P4V uses that value instead of the default naming convention.

    After adding them, you can drag these items to any position in the menu.

    Additional Custom tool and HTML Window actions can be added to the menu using these items:

    • All other Custom Tool actions
    • All other HTML Window actions
    The configuration of these actions depends on how you have configured custom tools and HTML window actions. To learn more, see Advanced options: custom tools and more.

  3. To remove items from a context menu, select the item you wish to remove and click Remove.

    The item is removed from the context menu.

  4. To reorder items, drag items to your desired location. Alternatively, use the Move Up and Move Down buttons to adjust the position of the selected items.

  5. To add a break between the context menu items, click Insert Separator.

    The new separator will be added after your selected item; if no item is selected, it will be placed at the bottom of the menu.

  6. Click OK to save your changes.

P4V preserves the source of each custom tool and HTML window that you add to a context menu. If tools with the same name exist in multiple sources, the context menu continues to reference the specific tool source that you selected.

To restore the default settings for the current menu displayed, click Reset to Default.

Unavailable P4 Server tools

If a context menu contains a Server Tool from a P4 Server that is not currently connected, P4V preserves the menu configuration.

In the Context Menus preferences page, the unavailable tool appears disabled and identifies the P4 Server that originally provided it.

For example: Server tool from ssl:server:1666 (not connected)

An unavailable Server Tool:

  • remains in the saved configuration

  • does not appear in live context menus

  • can be removed from the configuration