Adding a Device Preset

From RAD Studio
Jump to: navigation, search

Go Up to Device Manager

Adding a device preset allows you to see the device in the Device Manager and in the Multi-Device Preview. If you also install the appropriate package for such device you can view it in the View Selector and use it as a FireMonkey View.

Note: Device presets can also be added from the DevicePresets.xml file.

To add a device preset to the list of device presets from the Device Manager, do the following:

  1. Select Tools > Options > Environment Options > Form Designer > Device Manager.
  2. Click Add. The New device settings window opens. You can use this window to configure your device preset.
  3. Enter some basic information about your new device preset:
    1. In Device Name, enter a unique name for your new device preset. For example, "My Smartphone".
    2. In Platform, select the platform that your new device preset is meant to run on. If your device supports several platforms, you must create a separated device preset for each platform it supports.
    3. In Form Factor, select the form factor of your new device preset.
  4. You can configure any combination of the four orientations a device preset may support. To configure an orientation:
    1. Click the tab of the target orientation:
      • Portrait
      • Upside down
      • Landscape left
      • Landscape right
    2. Check Enable Orientation to enable the selected orientation in your new device preset.
    3. In Device Background, click the ellipsis (...) button and select an image file to use as background image for your new device preset.
    4. In the Screen upper left corner, use the Left and Top fields to indicate the top-left corner of the screen in the device image.
    5. In Screen size, use the Width and Height fields to indicate the width and the height of the screen to calculate the bottom-right corner of the screen according to the top-left corner indicated above.
    6. In the Status bar:
      1. Use Size to define the height (portrait and upside down orientation) or width (landscape orientation) of the status bar. The status bar is located within the screen of the device preset, and takes space from your application unless your application is full-screen.
      2. Use Position to define where in the screen the status bar is anchored:
        • Top
        • Bottom
        • Left
        • Right
  5. Click OK to add your new device preset to the list of device presets.

You can edit your device preset later if you want to change any settings.

See Also