Go Up to Form Designer Options
Tools > Options > Environment Options > Form Designer > Device Manager
The Device Manager shows a grid with the device presets. The device presets are the list of available devices to use at design time for example in the Multi-Device Preview Window. These devices can be used as views of your multi-device project if the view has been registered by installing the package of such view. By default, only generic devices have registered views. See how you can create your own views.
From this page you can add, edit, and delete a device preset. You cannot edit or delete built-in device presets, you can only edit or delete device presets that you add yourself to the Device Manager.
The Device Manager manages the
DevicePresets.xml file, when you add, edit, or delete a device preset from the Device Manager, the
DevicePresets.xml file updates automatically to reflect such changes. You can also add, edit, or delete devices directly from the
Buttons and Context Menu
At the bottom of the page you can find the buttons to manage the device presets. If you right-click anywhere in the page, a context menu pops up.
By using the buttons or the context menu, you can do one of the following actions:
|Add||Opens the New device settings editor to create a new device preset.|
|Edit|| Opens the Device Settings Window editor to edit the selected device preset.
|Delete|| Deletes the selected device preset. See Deleting a Device Preset.
Appmethod asks you for confirmation before it actually deletes the selected device preset.
DevicePresets.xml file defines the device presets information, these devices can be used at design time.
- Warning: We recommend to carefully check the modifications on the
DevicePresets.xmlfile. Please revise the xml tags to ensure that they are properly cased. Otherwise the designer could not understand them and behave unexpectedly.
This file allows you to edit the following device information:
- A friendly name for your view
- Available orientations
- Display size for each orientation
- Status bar position and size
- Image for the device frame
To add a new device preset to the
- Go to
- Note: This is a hidden folder. If you are not able to see it, make active the Show hidden files, folders, and drivers on the Folder Options dialog box in the Windows Control Panel.
- Open the file with a text editor.
- Inside the
<MobileDevices RepositoryVersion="3">tag, add a new
MobileDeviceelement as follows:
- Note: You need to replace
ARTWORK_PATHwith the correct path to your artwork.
- Warning: If you are adding a customized view to the view selector, you need to ensure that the name added between the
<Name></Name>tags matches the
ViewNameof the package of that view.
- Restart the IDE for the changes to take effect.
<MobileDevice> <Name>TestView</Name> <!-- Same unique ID used in the creation package if you are registering a new View --> <Displayname>My Android Phone</Displayname> <!-- Name to show in the Device Manager, View Selector and Multi-Device Preview --> <DevicePlatform>3</DevicePlatform> <FormFactor>2</FormFactor> <UserData>True</UserData> <Portrait Enabled="True" Width="360" Height="640" Top="61" Left="44" StatusbarHeight="25" StatusBarPos="0" Artwork="ARTWORK_PATH"/> <UpsideDown Enabled="True" Width="360" Height="640" Top="68" Left="47" StatusbarHeight="25" StatusBarPos="0" Artwork="ARTWORK_PATH"/> <LandscapeLeft Enabled="True" Width="640" Height="360" Top="44" Left="68" StatusbarHeight="25" StatusBarPos="0" Artwork="ARTWORK_PATH"/> <LandscapeRight Enabled="True" Width="640" Height="360" Top="47" Left="61" StatusbarHeight="25" StatusBarPos="0" Artwork="ARTWORK_PATH"/> </MobileDevice>
MobileDevice element may use any combination of the following elements:
|| Identifier used to create the package to add a new view.
||Friendly name to display where necessary, like for example in the View Selector, the Device Manager, and the Multi-Device Preview.|
<Displayname>My Android Phone</Displayname>
||Platform of the device.
|| Form factor of the device.
||Determines whether the device can be edited from the Device Manager.|| |
|| Orientation definition.
You may use any combination of these four elements. Use each element as a self-closed XML tag (
<Portrait Enabled="True" Width="360" Height="640" Top="61" Left="44" StatusbarHeight="25" StatusBarPos="0" Artwork="$(BDS)\ObjRepos\en\Devices\images\Android35.cpng" />
After saving new changes in the Device Manager, the
DevicePresets.xml file updates when the IDE closes to include the
<Thumbnail></Thumbnail> tags. The
<Thumbnail></Thumbnail> tags are automatically generated to include the location of the thumbnail images of the device presets used in the Device Manager and the Multi-Device Preview. You should not edit or delete the