Utilisation de l'expert Nouveau composant

Remonter à Nouveau composant

Vous pouvez utiliser l'expert Composant > Nouveau composant pour créer un nouveau composant VCL ou un nouveau composant FireMonkey pour votre application.

Si un projet est ouvert ou si vous exécutez un produit à personnalité unique, l'expert détecte la personnalité et crée le type approprié de composant (Delphi ou C++).

Résumé : Etapes de la création d'un nouveau composant

1. Créez un nouveau package squelette (cette étape est facultative mais recommandée).
2. Démarrez l'expert et spécifiez la personnalité, le framework et la plate-forme.
3. Sélectionnez un composant ancêtre sur la page Composant ancêtre.
4. Spécifiez le nom de la classe et d'autres propriétés sur la page Composant.
5. Choisissez la façon dont vous voulez créer et installer l'unité :
   • Créez une unité, sur la page Créer une unité.
   • Installez l'unité dans un package existant, sur la page Package existant.
   • Installez l'unité en tant que nouveau package, sur la page Nouveau package.
   • Ajoutez l'unité à un package squelette que vous créez dans le projet en cours avant de commencer l'expert.

Remarque : Pour obtenir des informations sur la création de composants Win64, voir Nouveau composant.

Créer un package squelette (facultatif)

1. Créez un nouveau package squelette pour le nouveau composant en choisissant Fichier > Nouveau > Autre > Projets Delphi ou C++ .
2. Double-cliquez sur l'icône Package. Cette étape ajoute un nouveau projet package au Gestionnaire de projets et active l'option Ajouter une unité au projet <mon_nouveau_package> sur la page Créer une unité de l'expert.

Démarrer l'expert et spécifier la personnalité, le framework et la plate-forme

La page Personnalité, framework et plate-forme de l'expert est affichée seulement si vous démarrez l'expert quand aucun projet n'est ouvert dans l'EDI.

1. Dans l'EDI, choisissez l'une des actions suivantes :

• Composant > Nouveau composant
• Fichier > Nouveau > Autre > Projets Delphi > Fichiers Delphi > Composant > Fichiers Delphi
• Fichier > Nouveau > Autre > Projets C++Builder > Fichiers C++Builder > Composant > Fichiers C++

2. Si vous voyez la première page de l'expert Nouveau composant (la page Personnalité, framework et plate-forme), sélectionnez la personnalité (Delphi ou C++), le framework (bibliothèque) et la plate-forme que vous voulez utiliser. Choisissez parmi :

• VCL pour C++ ou VCL pour Delphi

  La VCL est seulement prise en charge sur Windows.

• FireMonkey pour C++ ou FireMonkey pour Delphi

  Delphi prend en charge FireMonkey sur Win32, Win64, macOS, Périphérique iOS 32 bits et 64 bits, Simulateur iOS et Android.

  C++Builder prend en charge FireMonkey sur Win32, Win64, macOS, Périphérique iOS 32 bits et 64 bits, Simulateur iOS et Android.

• Cliquez sur Suivant. La page Composant ancêtre apparaît.

Sélectionner le composant ancêtre

1. Sur la page Composant ancêtre, examinez la liste de tous les composants, avec le nom de l'unité qui définit chaque composant. Sélectionnez un composant ancêtre dans la liste.
2. Cliquez sur Suivant. La page Composant apparaît.

Spécifier le nom de la classe et d'autres propriétés

1. Sur la page Composant, les champs sont préremplis pour :
   • Nom de classe
   • Page de palette
   • Nom d'unité
   • Chemin de recherche

   Vous pouvez accepter les valeurs par défaut de ces champs ou modifier les valeurs en suivant les étapes ci-après. Si vous voulez accepter les valeurs par défaut, passez directement à la dernière étape de cette procédure.

2. Pour changer le nom de classe par défaut, entrez un autre nom de classe dans la zone de texte Nom de classe.
3. Pour changer la page de palette par défaut pour le composant, entrez dans la zone de texte Page de palette le nom de la zone de la palette d'outils choisie ou cliquez sur la flèche vers le bas pour faire une sélection parmi les zones de la palette d'outils.
4. Dans la zone de texte Nom d'unité, vous pouvez entrer ou modifier le chemin complet du nom de l'unité. Cliquez sur [...] pour naviguer et sélectionner l'unité voulue.
5. Entrez ou modifiez le chemin de recherche dans la zone de texte Chemin de recherche. Le chemin de recherche par défaut est l'ensemble des valeurs pour le chemin des bibliothèques sur :
   • Outils > Options > Options d'environnement > Options C++ > Chemins et répertoires (C++)
   • Outils > Options > Options d'environnement > Options Delphi > Bibliothèque (Delphi)
6. Cliquez sur Suivant. La page Créer une unité de l'expert s'ouvre.

Créer et installer l'unité

Vous disposez de quatre choix sur la page Créer une unité :

• Créer l'unité
• Installer dans un package existant
• Installer dans un nouveau package
• Ajouter une unité au projet <mon_nouveau_package> (cette sélection est présente seulement si vous créez un nouveau package avant de démarrer l'expert, ci-dessus)

Pour créer une unité

1. Sur la page Créer une unité, sélectionnez le bouton radio Créer l'unité.
2. Cliquez sur Terminer. La nouvelle unité s'ouvre dans l'éditeur de code.

Pour installer une unité dans un package existant

1. Sur la page Créer une unité, sélectionnez le bouton radio Installer dans un package existant.
2. Cliquez sur Suivant. La liste des packages existants est générée.
3. Sur la page Package existant, sélectionnez le package dans lequel vous voulez installer l'unité.
4. Cliquez sur Terminer. La nouvelle unité s'ouvre dans l'éditeur de code.

Pour installer une unité dans un nouveau package

1. Sur la page Créer une unité, sélectionnez le bouton radio Installer dans un nouveau package.
2. Cliquez sur Suivant.
3. Sur la page Nouveau package, entrez le nom du package dans la zone de texte Nom du package.
4. Dans la zone de texte Description, entrez la description de votre nouveau package.
5. Cliquez sur Terminer. La nouvelle unité s'ouvre dans l'éditeur de code.

Pour installer une unité dans un package squelette créé avant de démarrer l'expert

1. Sur la page Créer une unité, sélectionnez Ajouter l'unité au projet <mon_nouveau_package> . Cette option est activée quand vous créez un package squelette avant de démarrer l'expert, comme décrit dans Créer un package squelette, ci-dessus.
2. Cliquez sur Terminer. La nouvelle unité s'ouvre dans l'éditeur de code.

Voir aussi

• Présentation de la VCL

• Expert Nouveau composant
• Création d'un composant FireMonkey (Delphi)
• Création d'un composant FireMonkey (C++)
• Création d'un nouveau composant