VMware

VMware ACE

Features | Documentation | Knowledge Base | Discussion Forums

previous Prev   Contents   Last   Next next

Customizing the VMware ACE Interface

Customizing the VMware ACE Interface

You may customize several aspects of the VMware ACE user interface, including the text that appears in the title bar and the way removable devices are represented in the interface.

You save these customizations in a text file and identify that text file, called the skin file, by adding a line to the preferences.ini file in the project folder.

Creating and Specifying the Skin File

Creating and Specifying the Skin File

Each line in the skin file has the following form:

parameter = "value"

To comment out a line in the skin file, begin the line with the # sign.

The parameters, acceptable values and defaults are listed in tables in this section.

Save the skin file with any filename you wish. Save the skin file in the Project Resources folder under the project folder for the project to which it applies.

  1. Use a text editor to open the preferences.ini file in the project folder and add the following line:

    vmplayer.skin = "<filename>"

    If the skin file is not in the project folder, specify the full path to the file.

  2. Save preferences.ini.
Customizing the VMware ACE Icons

Customizing the VMware ACE Icons

VMware ACE has separate large and small application icons. The large icon is used in the application switching interface (visible when you press Alt-Tab). The size of the large icon is usually 32x32 pixels, but VMware ACE uses whatever size is specified in the system preference for icon size. The small (16x16) icon is used in the VMware ACE title bar and on the Windows taskbar button for VMware ACE.

The icons used for these purposes must be in .ico format and are specified by the following options in the skin file:

player.iconSmall = "<filename>"
player.iconLarge = "<filename>"

One .ico file can contain multiple icons of different sizes. You can specify the same .ico file for player.iconSmall and player.iconLarge. VMware ACE extracts the icon of the appropriate size for each use.

Customizing the Title Bar Text

Customizing the Title Bar Text

You may specify what text appears in the VMware ACE title bar. You may also specify the font and font size used to display the text.

The text displayed in the title bar consists of three sections — a prefix, the virtual machine name and a suffix. The parameters listed here allow you to set any prefix and suffix, or to omit the prefix, the suffix or both. They also allow you to include or omit the virtual machine name.

If you leave the defaults for all values, the title bar displays only the virtual machine name at 32 points in the font MS Shell Dlg.

 Parameter
 Type
 Default
 Controls
 player.title.prefix
 string
 ""
 Title bar prefix
 player.title.useVMName
 boolean (TRUE or FALSE)
 TRUE
 Is virtual machine name displayed?
 player.title.suffix
 string
 ""
 Title bar suffix
 player.title.font.face
 string
 "MS Shell Dlg"
 Name of font (font must be on end user's computer)
 player.title.font.size
 integer
 32
 Point size for the text

Customizing the Removable Device Display

Customizing the Removable Device Display

Removable devices are shown in the VMware ACE interface either by buttons on a toolbar or by menu items on a Connect menu. You can specify the type of display. You can also specify text, icon or a combination of the two and specify custom icons.

If you use custom icons, copy the icon files to the Project Resources folder under the project folder for the project in which they are used.

Settings you make in the skin file override any settings the end user may make in the VMware ACE preferences dialog box.

Use the following parameter to control whether devices are shown as toolbar items.

 Parameter
 Type
 Default
 Controls
 player.deviceBar.toplevel
 boolean
 FALSE
 Use TRUE for a toolbar, FALSE for a menu

You may customize the display for each removable device configured in the virtual machine. The following device names are used for the removable devices you can control with these parameters:

  • floppy0, floppy1
  • serial0, serial1, serial2, serial3
  • parallel0, parallel1, parallel2
  • ide0:0, ide0:1, ide1:0, ide1:1 (IDE CD-ROM or hard drives)
  • scsi0:0-scsi0:7 (SCSI CD-ROM or hard drives)

Substitute the appropriate device name for <deviceName> in the parameters in the following table:

 Parameter
 Type
 Default
 Controls
 player.deviceBar.<deviceName>.buttonStyle
 string (text, icon, texticon)
 
 Appearance of toolbar button or menu item
 player.deviceBar.<deviceName>.buttonText
 string
 User-friendly device name
 Text that appears on the toolbar button or menu item when device is connected
 player.deviceBar.<deviceName>.buttonTextDisconnected
 string (optional)
 Normal button text
 Text that appears on the toolbar button or menu item when device is disconnected
 player.deviceBar.<deviceName>.tooltip
 string
 ""
 Text that appears in the tooltip when device is connected
 player.deviceBar.<deviceName>.tooltipDisconnected
 string (optional)
 Normal tooltip
 Text that appears in the tooltip when device is disconnected
 player.deviceBar.<deviceName>.icon
 filename
 Icon representing this type of device
 Custom icon file when device is connected; copy icon file to the Project Resources folder under the project folder
 player.deviceBar.<deviceName>iconDisconnected
 filename (optional)
 Normal icon
 Custom icon file when device is disconnected
 player.deviceBar.<deviceName>.shortcutKey
 keySpec
 
 Shortcut key combination to toggle device between connected and disconnected

For details on the values for keySpec, see the section below.

Shortcut Key Values

Shortcut Key Values

The shortcut key entries described in this section require you to enter a virtual key code as part of the value for an option. Virtual key codes are entered in hexadecimal format — as a hexadecimal number preceded by 0x. For example, to use the virtual key code of 5A as a value, type 0x5A.

Microsoft provides a reference list of virtual key codes on the MSDN Web site. At the time this manual was written, the reference list was at msdn.microsoft.com/library/en-us/winui/WinUI/WindowsUserInterface/UserInput/VirtualKeyCodes.asp.

The hot key entries also include modifier keys. The modifier keys are Ctrl, Alt and Shift, or a combination of those keys.

 Modifier key
 Value
 No modifier
 0x0
 Alt
 0x1
 Ctrl
 0x2
 Shift
 0x4
 Ctrl-Alt
 0x3
 Alt-Shift
 0x5
 Ctrl-Shift
 0x6
 Ctrl-Alt-Shift
 0x7

When listing a key plus a modifier, type the virtual key code for the key followed by a comma, then type the value for the modifier key or keys. For example, the value entry for Ctrl-Shift-F1 is 0x70,0x6.

Note: Keep the following limitations in mind when defining shortcut keys:

  • Do not use the Pause key with the Ctrl key. You may use the Pause key with other modifier keys.
  • If you use F12, you must use one or more modifier keys. You cannot use F12 alone.
  • You cannot use combinations that include only the Shift, Ctrl and Alt keys. These keys may be used only as modifiers in combination with some other key.
Sample Skin File

Sample Skin File

player.title.prefix = "Our Company <<"
player.title.suffix = ">> Environment"
# player.title.useVMName = FALSE

# player.deviceBar.toplevel = TRUE
player.deviceBar.floppy0.buttonStyle = "icon"
player.deviceBar.floppy0.buttonText = "First Floppy Drive"
player.deviceBar.floppy0.shortcutKey = "0x30,0x7"
player.deviceBar.floppy0.icon = "custom-floppy.ico"
player.deviceBar.floppy0.tooltip = "Click to disconnect"
player.deviceBar.floppy0.tooltipDisconnected = "Click to connect"
# player.deviceBar.ide1:0.buttonStyle = "icon"

previous Prev   Contents   Last   Next next