Gestionnaire de périphériques

De RAD Studio
Aller à : navigation, rechercher

Remonter à Options du Concepteur de fiches


DeviceManager.png

Outils > Options > Options d'environnement > Concepteur de fiches > Gestionnaire de périphériques


Le Gestionnaire de périphériques affiche une grille avec les périphériques prédéfinis. Les périphériques prédéfinis sont une liste de périphériques disponibles à la conception, par exemple dans la fenêtre Aperçu multi-périphérique. Ces périphériques peuvent être utilisés comme vues de votre projet multi-périphérique si la vue a été recensée en installant le package associé. Par défaut, seuls les périphériques génériques ont des vues recensées. Voir comment créer vos propres vues.

A partir de cette page, vous pouvez ajouter, modifier et supprimer un périphérique prédéfini. Vous ne pouvez pas modifier ou supprimer les périphériques prédéfinis intégrés. Vous pouvez seulement modifier ou supprimer les périphériques prédéfinis que vous avez ajoutés vous-même au Gestionnaire de périphériques.

Le Gestionnaire de périphériques gère le fichier DevicePresets.xml, lorsque vous ajoutez, modifiez ou supprimez un périphérique prédéfini partir du Gestionnaire de périphériques. Le fichier DevicePresets.xml est mis à jour automatiquement pour refléter ces modifications. Vous pouvez également ajouter, modifier ou supprimer des périphériques directement à partir du fichier DevicePresets.xml.

Vous pouvez double-cliquer sur un périphérique dans la liste pour le modifier. Vous pouvez utiliser le menu contextuel ou les boutons pour accéder aux autres actions.

Boutons et menu contextuel

Vous trouverez en bas de la page les boutons permettant de gérer les périphériques prédéfinis. Si vous cliquez n'importe où sur la page avec le bouton droit, un menu contextuel apparaît.

En utilisant les boutons ou le menu contextuel, vous pouvez effectuer l'une des actions suivantes :

Elément Description
Ajouter Ouvre l'éditeur Paramètres du nouveau périphérique pour créer un nouveau périphérique prédéfini.
Modifier Ouvre l'éditeur de la fenêtre Paramètres du périphérique pour modifier le périphérique prédéfini sélectionné.
Remarque : Cette action est désactivée quand vous sélectionnez un périphérique prédéfini intégré. Vous ne pouvez pas modifier les périphériques prédéfinis intégrés.
Supprimer Supprime le périphérique prédéfini sélectionné. Voir Suppression d'un périphérique prédéfini.
Remarque : Cette action est désactivée quand vous sélectionnez un périphérique prédéfini intégré. Vous ne pouvez pas supprimer les périphériques prédéfinis intégrés.

RAD Studio vous demande une confirmation avant de supprimer réellement le périphérique prédéfini sélectionné.


DevicePresets.xml

Le fichier DevicePresets.xml définit les informations des périphériques prédéfinis. Ces périphériques peuvent être utilisés à la conception.

Avertissement : Vérifiez soigneusement les modifications apportées au fichier DevicePresets.xml. Contrôlez les balises xml afin de vous assurer que leur casse est correcte. Sinon, le concepteur risque de ne pas les comprendre et de se comporter de manière inattendue.

Ce fichier vous permet de modifier les informations de périphérique suivantes :

  • Un nom convivial pour votre vue
  • Les orientations disponibles
  • La taille de l'affichage pour chaque orientation
  • La position et la taille de la barre d'état
  • L'image pour le cadre du périphérique

Pour ajouter un nouveau périphérique prédéfini au fichier DevicePresets.xml :

  1. Allez sur C:\Users\<nom_utilisateur>\AppData\Roaming\Embarcadero\BDS\19.0
    Remarque : C'est un dossier masqué. Si vous ne le voyez pas, activez l'option Afficher les fichiers, dossiers et lecteurs cachés dans la boîte de dialogue Options des dossiers du Panneau de configuration Windows.
  2. Ouvrez le fichier avec un éditeur de texte.
  3. Dans la balise <MobileDevices RepositoryVersion="3">, ajoutez un nouvel élément MobileDevice comme suit :
      <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>
    
    Remarque : Remplacez ARTWORK_PATH par le chemin d'accès correct à votre illustration graphique.
    Avertissement : Si vous ajoutez une vue personnalisée au sélecteur de vue, vous devez vérifier que le nom ajouté entre les balises <Name></Name> correspond au nom de vue (ViewName) du package de cette vue.
  4. Redémarrez l'EDI pour que les modifications prennent effet.

Eléments de DevicePresets.xml

Chaque élément MobileDevice peut utiliser toute combinaison des éléments suivants :

Elément Description Exemple
Name Identificateur utilisé pour créer le package pour ajouter une nouvelle vue.
Avertissement : Le nom doit être unique. Si vous ajoutez un nouveau périphérique prédéfini portant le même nom qu'un périphérique prédéfini existant, ce dernier est remplacé par le nouveau périphérique prédéfini lorsque le fichier DevicePresets.xml est mis à jour par l'EDI.
<Name>TestView</Name>
Displayname Nom convivial qui s'affiche partout où cela est nécessaire, par exemple dans le sélecteur de vue, le Gestionnaire de périphériques et l'Aperçu multi-périphérique.
<Displayname>My Android Phone</Displayname>
DevicePlatform Plate-forme du périphérique.
Nombre Définition
0 Windows
1 OS X
2 iOS
3 Android
<DevicePlatform>3</DevicePlatform>
FormFactor Facteur de forme du périphérique.
Nombre Définition
0 Bureau
2 Téléphone
3 Tablette
4 Lecteur multimédia
5 Automobile
6 Industriel
7 Incorporé
8 Montre
9 Lunettes
Remarque : Lors de la sélection du facteur de forme Bureau, il n'est pas nécessaire de configurer l'orientation car les orientations ne sont pas activées pour ce facteur de forme particulier.
<FormFactor>2</FormFactor>
UserData Détermine si le périphérique peut être modifié à partir du Gestionnaire de périphériques.
<UserData>True</UserData>
Portrait

UpsideDown
LandscapeLeft
LandscapeRight

Définition de l'orientation.

Vous pouvez utiliser toute combinaison de ces quatre éléments. Utilisez chaque élément comme une balise XML auto-fermée (<balise />), et utilisez toute combinaison des attributs suivants sur chaque balise :

Propriété Définition
Enabled Définissez cette propriété sur True si vous voulez utiliser cette orientation.
Width

Height

Mesures (en pixels) de la fiche. Représente la zone disponible.
Top

Left

Représente le coin supérieur gauche de la zone disponible. C'est le décalage à partir de l'origine de l'écran.
StatusbarHeight La hauteur de la barre d'état.

Par défaut : 0.

StatusBarPos La position de la barre d'état, 0 signifiant "en haut".

Par défaut : 0.

Valeur Position
0 Haut
1 Bas
2 Gauche
3 Droite
Artwork Le chemin complet du fichier. Lorsque le champ est vide, un petit cadre noir apparaît par défaut.
Mask Le chemin d'accès complet au fichier Mask. Il s'agit d'un champ facultatif, utilisé pour appliquer un masque à Artwork afin de définir des formes non rectangulaires dans les vues personnalisées. Dans ce but, le Mask définit les parties visibles et non visibles de Artwork sur la fiche. Quand le champ est vide, aucun masque n'est appliqué à Artwork.

Pour appliquer un Mask à Artwork, suivez les étapes ci-dessous :

  • Rendez la taille de Mask égale à celle de la fiche (Width et Height).
  • Ajoutez de la transparence à l'arrière-plan et à la zone écran du périphérique sur le Artwork.
  • Rendez transparente la partie visible de la fiche sur le Mask.
  • Rendez blanche (#FFFFFFF) la partie non visible de la fiche sur le Mask.
<Portrait
    Enabled="True"
    Width="360"
    Height="640"
    Top="61"
    Left="44"
    StatusbarHeight="25"
    StatusBarPos="0"
    Artwork="$(BDS)\ObjRepos\en\Devices\images\Android35.cpng"
    Mask="$(BDS)\ObjRepos\en\Devices\images\AndroidMask35.cpng"
    />

Après avoir enregistré les nouveaux changements dans le Gestionnaire de périphériques, le fichier DevicePresets.xml est mis à jour lors de la fermeture de l'EDI pour inclure les balises <Thumbnail></Thumbnail>. Les balises <Thumbnail></Thumbnail> sont automatiquement générées pour inclure l'emplacement des images miniatures des périphériques prédéfinis utilisés dans le Gestionnaire de périphériques et l'Aperçu multi-périphérique. Vous ne devez pas modifier ou supprimer les balises <Thumbnail></Thumbnail>.

Voir aussi