Fichier package compilé Delphi (*.dcp)

2025-05-28T09:52:23Z

Yukikoi : Yukikoi a déplacé la page Fichier package compilé Delphi vers Fichier package compilé Delphi (*.dcp)

{{Parent|Types de fichiers - Index}}

Lorsque vous [[Compilation de packages|construisez un package {{Delphi}}]], {{Product}} génère un fichier package compilé {{Delphi}}. Les projets utilisant votre package doivent accéder à votre fichier package compilé {{Delphi}} lors de la construction.

Un fichier package compilé {{Delphi}} est une image binaire contenant un en-tête de package et la concaténation de tous les [[Fichier unité compilé Delphi|fichiers package compilés Delphi]] de votre package, y compris toutes les informations de symboles requises par le compilateur et le lieur.

Lorsque vous construisez votre package {{Delphi}}, votre fichier package compilé {{Delphi}} est généré par défaut sous {{Path|{{Placeholder|package}}.dcp}} dans le dossier suivant :

* Pour Windows 32 bits : {{Path|{{PublicDocumentsPath}}\DCP}}
* Pour les autres plates-formes : {{Path|{{PublicDocumentsPath}}\DCP\{{Placeholder|plate-forme}}}}

{{Note|Le fichier DCP doit se trouver dans le même répertoire que le package que vous êtes en train de déboguer ou dans le chemin de recherche des symboles de débogage. Sinon, le débogueur ne le trouvera pas. Cela ne s'applique qu'aux plates-formes Win32 et Win64. Pour changer le répertoire de destination DCP, sélectionnez {{Menu|Projet > Options > [[Compilateur Delphi|Compilateur Delphi]]}}. Pour changer le chemin de recherche des symboles de débogage, sélectionnez {{Menu|Projet > Options > Débogueur > [[Tables de symboles du débogueur|Tables de symboles]]}}.}}

==Voir aussi==

* [[Fichier unité compilé Delphi|Fichier unité compilé Delphi (*.dcu)]]
* [[Fichiers de packages créés lors d'une compilation|Fichiers de packages créés lors d'une compilation]]

[[Category:Référence EDI]]
[[Category:XE7]]
[[Category:AMMigrate]]

Fichier unité compilé Delphi (*.dcu)

2025-05-28T09:50:10Z

Yukikoi :

{{Parent|Types de fichiers - Index}}

Lorsque vous construisez un projet {{Delphi}}, {{Product}} génère un fichier unité compilé (DCU) {{Delphi}} pour chaque [[Unité|unité]] de votre projet. Vous n'avez pas besoin d'ouvrir ces fichiers binaires ou de les distribuer avec votre projet.

Un fichier unité compilé {{Delphi}} est un fichier de sortie intermédiaire du compilateur, produit à partir du code source de chaque unité de votre projet. Les fichiers unité compilés {{Delphi}} permettent une compilation et une liaison rapides.

Vous pouvez lier un projet {{Delphi}} à des fichiers unité compilés {{Delphi}} pour toute [[Plates-formes cible supportées|plate-forme cible sprise en charge]].

Lorsque vous construisez votre projet {{Delphi}}, vos fichiers unité compilés {{Delphi}} sont générés par défaut dans {{Path|{{ProjectsPath}}\{{Placeholder|projet}}\{{Placeholder|plate-forme}}\{{Placeholder|configuration de construction}}}} avec {{Path|{{Placeholder|unité}}.dcu}} comme nom de fichier.

{{Note|Le fichier DCU doit se trouver dans le même répertoire que le fichier DLL que vous êtes en train de déboguer ou dans le chemin de recherche des symboles de débogage. Sinon, le débogueur ne trouvera pas les symboles de débogage. Cela ne s'applique qu'aux plates-formes Win32 et Win64. Pour changer le répertoire de sortie du DCU, sélectionnez {{Menu|Projet > Options > [[Compilateur Delphi|Compilateur Delphi]]}}. Pour changer le chemin de recherche des symboles de débogage, sélectionnez {{Menu|Projet > Options > Débogueur > [[Tables de symboles du débogueur|Tables de symboles]]}}.}}

==Voir aussi==

* [[Fichier package compilé Delphi|Fichier package compilé Delphi (*.dcp)]]
* [[Fichiers de packages créés lors d'une compilation|Fichiers de packages créés lors d'une compilation]]

[[Category:Référence EDI]]
[[Category:XE7]]
[[Category:AMMigrate]]

Fichier unité compilé Delphi

2025-05-28T09:48:05Z

Yukikoi : Yukikoi a déplacé la page Fichier unité compilé Delphi vers Fichier unité compilé Delphi (*.dcu)

#REDIRECTION [[Fichier unité compilé Delphi (*.dcu)]]

Fichier unité compilé Delphi (*.dcu)

2025-05-28T09:48:05Z

Yukikoi : Yukikoi a déplacé la page Fichier unité compilé Delphi vers Fichier unité compilé Delphi (*.dcu)

{{Parent|Types de fichiers - Index}}

Lorsque vous construisez un projet {{Delphi}}, {{Product}} génère un fichier unité compilé (DCU) {{Delphi}} pour chaque [[Unité|unité]] de votre projet. Vous n'avez pas besoin d'ouvrir ces fichiers binaires ou de les distribuer avec votre projet.

Un fichier unité compilé {{Delphi}} est un fichier de sortie intermédiaire du compilateur, produit à partir du code source de chaque unité de votre projet. Les fichiers unité compilés {{Delphi}} permettent une compilation et une liaison rapides.

Vous pouvez lier un projet {{Delphi}} à des fichiers unité compilés {{Delphi}} pour toute [[Plates-formes cible supportées|plate-forme cible sprise en charge]].

Lorsque vous construisez votre projet {{Delphi}}, vos fichiers unité compilés {{Delphi}} sont générés par défaut dans {{Path|{{Chemin projet}}\{{Placeholder|projet}}\{{Placeholder|plate-forme}}\{{Placeholder|configuration de construction}}}} avec {{Path|{{Placeholder|unité}}.dcu}} comme nom de fichier.

{{Note|Le fichier DCU doit se trouver dans le même répertoire que le fichier DLL que vous êtes en train de déboguer ou dans le chemin de recherche des symboles de débogage. Sinon, le débogueur ne trouvera pas les symboles de débogage. Cela ne s'applique qu'aux plates-formes Win32 et Win64. Pour changer le répertoire de sortie du DCU, sélectionnez {{Menu|Projet > Options > [[Compilateur Delphi|Compilateur Delphi]]}}. Pour changer le chemin de recherche des symboles de débogage, sélectionnez {{Menu|Projet > Options > Débogueur > [[Tables de symboles du débogueur|Tables de symboles]]}}.}}

==Voir aussi==

* [[Fichier package compilé Delphi|Fichier package compilé Delphi (*.dcp)]]
* [[Fichiers de packages créés lors d'une compilation|Fichiers de packages créés lors d'une compilation]]

[[Category:Référence EDI]]
[[Category:XE7]]
[[Category:AMMigrate]]

Utilisation des styles FireMonkey natifs et personnalisés

2025-05-28T09:34:26Z

Yukikoi : 1 révision importée : LOC-23438

{{Parent|Personnalisation des applications FireMonkey avec les styles}}

Les diverses [[Plates-formes cible prises en charge|plates-formes]] prennent en charge différentes résolutions :

{| class="wikitable"
|-
! rowspan="2" | Plate-forme
! colspan="5" | Résolutions prises en charge
|-
! 1x
! 1.25x
! 1.5x
! 2x
! 3x
|-
| Windows
| {{V}}
| {{V}}
| {{V}}
|
|
|-
|macOS
| {{V}}
|
|
| {{V}}
|
|-
| iOS
| {{V}}
|
|
| {{V}}
| {{V}}
|-
| Android
| {{V}}
|
| {{V}}
| {{V}}
| {{V}}
|}

: '''Remarque :''' Sur '''iOS''', seuls iPhone 6 Plus et iPhone 6S Plus prennent en charge la résolution 3x.

Les applications {{FM}} sont chargées automatiquement et affichent le '''style natif''' approprié à l'exécution (selon le périphérique cible), sans que vous ayez besoin d'ajouter un livre de styles ou du code. De plus, les applications {{FM}} peuvent avoir des '''styles personnalisés''' qui s'affichent bien sur les affichages en haute résolution, ainsi que sur les affichages en résolution standard. Les styles en haute résolution (tels que Retina) sont seulement affichés à l'exécution.

==Chargement des styles à l'exécution==

Pour appliquer un style spécifique à une fiche, appelez par programmation '''[[lib_fr:FMX.Styles.TStyleManager.SetStyleFromFile|TStyleManager.SetStyleFromFile]]'''. Par exemple :

'''{{Delphi}} :'''<source lang="delphi">
procedure TForm1.FormCreate(Sender: TObject);
begin
// ...
TStyleManager.SetStyleFromFile('Air.style');</source>

'''C++ :'''<source lang="cpp">
void __fastcall TForm1::FormCreate(TObject *Sender)
{
//...
TStyleManager::SetStyleFromFile(L"Air.style");</source>

:'''Remarque :''' Vous devez ajouter l'unité '''FMX.Styles'''.

Notez que, pour fournir un style avec votre application, la meilleure approche consiste à ajouter le fichier au [[Gestionnaire de déploiement - Ajout de fichiers|Gestionnaire de déploiement]]. Après avoir ajouté le fichier, vous devez fournir le '''Chemin distant''' pour les différentes plates-formes que votre application va prendre en charge. Pour de plus amples informations sur les fonctions de chemin de fichier pour les différentes plates-formes, voir [[Fonctions RTL standard relatives aux chemins sur les plates-formes cible prises en charge|Fonctions RTL standard relatives aux chemins sur les plates-formes cible prises en charge]].

==Utilisation automatique des styles en haute résolution dans les applications 3D {{FM}}==

Tous les composants 3D de {{FM}} sont automatiquement affichés en mode haute résolution lorsqu'ils sont exécutés sur des périphériques iOS Retina ou sur des périphériques Android en mode haute résolution. Aucune propriété supplémentaire n'est requise.

Les composants 3D de {{FM}} sont [[lib_fr:FMX.Forms3D.TForm3D|TForm3D]], [[lib_fr:FMX.Viewport3D.TViewport3D|TViewport3D]], et [[lib_fr:FMX.Layers3D.TLayer3D|TLayer3D]].

==Détection de la version mobile==

Pour détecter la version mobile utilisée sur le périphérique SE cible (et pour assigner un style disponible approprié à l'exécution), utilisez la méthode [[lib_fr:System.SysUtils.TOSVersion.Check|TOSVersion.Check]] de la façon suivante.

'''Exemple :''' Le fragment de code suivant vérifie si le périphérique cible est un périphérique iOS 8 ou un périphérique Android exécutant Lollipop (5.0). Selon la version du SE, un style est assigné en particulier.

'''{{Delphi}} :'''<source lang="delphi">
procedure TForm1.FormCreate(Sender: TObject);
var
MyStyle: TFmxObject;
begin
{$IFDEF IOS}
if TOSVersion.Check(8, 0) then
MyStyle := TStyleManager.LoadFromResource(HInstance, 'iOSBlack', RT_RCDATA)
else
MyStyle := TStyleManager.LoadFromResource(HInstance, 'iOSTransparent', RT_RCDATA);
TStyleManager.SetStyle(MyStyle);
{$ENDIF}

{$IFDEF Android}
if TOSVersion.Check(5, 0) then
MyStyle := TStyleManager.LoadFromResource(HInstance, 'RT_DARK', RT_RCDATA)
else
MyStyle := TStyleManager.LoadFromResource(HInstance, 'RT_LIGHT', RT_RCDATA);
TStyleManager.SetStyle(MyStyle);
{$ENDIF}

end;</source>

'''C++ :'''<source lang="cpp">
void __fastcall TForm1::FormCreate(TObject *Sender)
{
TFmxObject *MyStyle;

#if (TARGET_OS_IPHONE)
if (TOSVersion::Check(8, 0))
MyStyle = TStyleManager::LoadFromResource((unsigned int)HInstance, "iOSBlack", RT_RCDATA);
else
MyStyle = TStyleManager::LoadFromResource((unsigned int)HInstance, "iOSTransparent", RT_RCDATA);
TStyleManager::SetStyle(MyStyle);
#endif

#if defined(__Android__)
if (TOSVersion::Check(5, 0))
MyStyle = TStyleManager::LoadFromResource((unsigned int)HInstance, "RT_DARK", RT_RCDATA);
else
MyStyle = TStyleManager::LoadFromResource((unsigned int)HInstance, "RT_LIGHT", RT_RCDATA);
TStyleManager::SetStyle(MyStyle);
#endif
}</source>

:'''Remarque :''' Reportez-vous à [[Etape 3 - Ajouter des ressources de styles en tant que RCDATA (Delphi)|Ajouter des ressources de styles en tant que RCDATA]] pour de plus amples informations sur l'utilisation de ressources afin de charger des styles dans votre application.

Pour de plus amples information sur la compilation conditionnelle :

* [[Création d'une app iOS#Ecriture de code pour iOS seulement|Ecriture de code pour iOS seulement]]
* [[Création d'une app Android|Création d'une app Android]]

==Chargement de vos propres styles personnalisés==

Les instructions ci-dessous décrivent l'utilisation des styles personnalisés, tels que le style '''Jet''' disponible dans le '''{{FM}} Premium Style Pack'''.

===Ajout d'un style personnalisé à votre application mobile===

{{Variables|Product}} inclut les styles mobiles personnalisés suivants :

*'''Android''' :
**AndroidDark.fsf
**AndroidLDark.fsf
**AndroidLDarkBlue.fsf
**AndroidLight.fsf
**AndroidLLight.fsf
**GoogleGlass.fsf
*'''iOS''' :
**iOSBlack.fsf
**iOSTransparent.fsf

Ces styles sont installés sur votre système, sous le répertoire '''Styles''' dans les répertoires suivants propres aux différentes plates-formes :

{{StylesPath}}\iOS
{{StylesPath}}\Android

Les styles mobiles personnalisés pour iOS et Android incluent la prise en charge des périphériques standard et haute résolution dans un fichier de style. Cela comprend la prise en charge intégrée pour :

* Les périphériques iOS standard et iOS Retina (1x, 2x) et les périphériques iOS Retina HD (3x)
* Plusieurs résolutions pour les périphériques Android (1x, 1.5x, 2x, 3x)

En outre, le [https://getitnow.embarcadero.com/category/styles/?p=1 FireMonkey Premium Style Pack] offre de nouveaux styles {{FM}} qui prennent également en charge la résolution 3x pour les périphériques iOS 8.

Sur le bureau, c'est également vrai pour les styles '''Jet''' et '''Diamond Mac''' personnalisés, qui sont disponibles dans le '''{{FM}} Premium Style Pack''' ; ces styles incluent la prise en charge des périphériques Retina et non Retina MacBook dans un fichier de style.

====Pour ajouter un style personnalisé à une application multi-périphérique {{FM}}====

# Créez une '''[[Application multi-périphérique|application multi-périphérique]]'''.
# La vue '''maître''' étant sélectionnée, ajoutez un composant '''[[lib_fr:FMX.Controls.TStyleBook|TStyleBook]]''' à votre fiche.
# Sur la vue '''maître''', sélectionnez un style dans le menu déroulant '''Style''' du concepteur de fiches (Windows, macOS, iOS ou Android). Cet exemple utilise le style Android pour la vue '''maître''' :
#:[[Image:SelectAStyle.png|550 px]]
# Chargez un fichier de style FireMonkey pour la plate-forme appropriée :
## Double-cliquez sur le livre de styles. Le '''[[Concepteur de styles FireMonkey|Concepteur de styles {{FM}}]]''' s'ouvre.
## Cliquez sur le bouton [[File:OpenIcon.png|Ouvrir un style]] sur la barre d'outils '''Concepteur de styles {{FM}}'''.
## Naviguez jusqu'au fichier de style FireMonkey voulu.
##:Par exemple, si '''Android''' est le style du Concepteur de fiches défini pour la vue en cours, vous devriez charger et assigner un style Android tel que '''AndroidLight.fsf'''.
##:
##: '''Remarque :''' Les styles FireMonkey pour les divers styles du Concepteur de fiches sont situés dans des répertoires parallèles :
##::'''Windows :''' <code>{{StylesPath}}</code>
##::'''Android :''' <code>{{StylesPath}}\Android</code>
##::'''iOS :''' <code>{{StylesPath}}\iOS</code>
# Basculez vers chacune des vues créées, sélectionnez le composant '''TStyleBook''' dans la vue concernée et chargez le style personnalisé pour cette plate-forme. Lorsque vous travaillez avec des styles FireMonkey personnalisés, chaque vue, notamment la vue '''maître''', doit avoir un style assigné dans le Concepteur de fiches.
#: Cela signifie que vous chargez un style Windows pour la vue "Bureau Windows", un style Android pour la vue "Android...", un style Mac pour la vue "Bureau macOS", un style iOS pour les vues "iPad" et "iPhone".
#: '''Remarque :''' Si les vues sont différentes pour iPad et iPhone, vous devez charger le même style iOS pour chaque vue.
# Pour utiliser le style personnalisé au lieu du style natif dans une fiche, vous devez sélectionner le livre de styles voulu dans la fiche au moment de la conception :
#* Dans la propriété [[lib_fr:FMX.Forms.TForm.StyleBook|StyleBook]] de la fiche, sélectionnez dans le menu déroulant le livre de styles à appliquer.
#* '''Remarque :''' Reportez-vous à la section [[#Utilisation de styles personnalisés dans des fiches multiples|Utilisation de styles personnalisés dans des fiches multiples]] pour apprendre à appliquer un style personnalisé particulier à plusieurs fiches sans modifier la propriété [[lib_fr:FMX.Forms.TForm.StyleBook|StyleBook]] de chaque fiche.

===Utilisation de styles personnalisés dans des fiches multiples===

Pour appliquer le même style personnalisé à toutes les fiches d'une application au lieu de définir la propriété [[lib_fr:FMX.Forms.TCommonCustomForm.StyleBook|StyleBook]] de chaque fiche lors de la conception, vous pouvez effectuer cette opération durant l'exécution à l'aide de la propriété [[lib_fr:FMX.Controls.TStyleBook.UseStyleManager|UseStyleManager]].

Pour utiliser le même style personnalisé sur toutes les fiches d'une application.

* Placez le composant [[lib_fr:FMX.Controls.TStyleBook|TStyleBook]] dans la fiche principale.
* Définissez la propriété [[lib_fr:FMX.Controls.TStyleBook.UseStyleManager|UseStyleManager]] dans [[Inspecteur d'objets|l'inspecteur d'objets]] sur <code>True</code>
* Double-cliquez sur le livre de styles pour ouvrir le '''Concepteur de styles FireMonkey''' et [[#Pour ajouter un style personnalisé à une application multi-périphériques {{FM}}| chargez le style]].

===Utilisation de styles personnalisés sur les contrôles dans des fiches multiples===

Une application peut avoir plusieurs objets [[lib_fr:FMX.Controls.TStyleBook|TStyleBook]], alors plusieurs fiches peuvent utiliser la propriété [[lib_fr:FMX.Forms.TForm.StyleBook|StyleBook]] pour référencer l'un de ces livres de style, un à la fois. Notez que les contrôles de toute fiche peuvent utiliser toujours la propriété [[lib_fr:FMX.Controls.TStyledControl.StyleLookup|StyleLookup]] pour spécifier tout style personnalisé défini dans tout objet [[lib_fr:FMX.Controls.TStyleBook|TStyleBook]] utilisé dans le groupe de projets en cours.

==Voir aussi==

* [https://getitnow.embarcadero.com/category/styles/?p=1 FireMonkey Premium Style Pack]
* [[Personnalisation des applications FireMonkey avec les styles|Personnalisation des applications FireMonkey avec les styles]]
* [[Utilisation de styles définis par des composants dans des packages de conception installés dans l'EDI|Utilisation de styles définis par des composants dans des packages de conception installés dans l'EDI]]
* [[Utilisation des styles pour iOS : les styles multi-résolutions, et les styles noir et transparent|Utilisation des styles pour iOS : les styles multi-résolutions, et les styles noir et transparent]]
* [[Concepteur de styles FireMonkey|Concepteur de styles FireMonkey]]
* [[Application des styles FireMonkey|Application des styles FireMonkey]]
* [[Création et déploiement d'icônes d'apps|Création et déploiement d'icônes d'apps]]
* [[Etape 3 - Ajouter des ressources de styles en tant que RCDATA (Delphi)|Etape 3 - Ajouter des ressources de styles sous RCDATA ({{Delphi}})]]
* [[Informations de version|Informations de version]]
* [[lib_fr:FMX.Controls.TStyleBook|FMX.Controls.TStyleBook]]
* [[lib_fr:FMX.Forms.TForm.StyleBook|FMX.Forms.TForm.StyleBook]]
* [[lib_fr:FMX.Styles.TStyleManager.SetStyle|FMX.Styles.TStyleManager.SetStyle]]
* [[lib_fr:FMX.Styles.TStyleManager.SetStyleFromFile|FMX.Styles.TStyleManager.SetStyleFromFile]]

[[Category:XE5]]
[[Category:FMX]]
[[Category:AMMigrate]]

Page d'accueil

2025-05-28T09:34:25Z

Yukikoi : 1 révision importée : LOC-23438

{{Parent|Menu Voir}}

{{Menu|Voir > Page d'accueil}}

{{Product}} affiche la '''page d'accueil''' à l'ouverture de l'EDI. Cette page présente du contenu utile lorsque vous démarrez l'EDI pour la première fois, comme des raccourcis permettant de rouvrir rapidement des projets récents, de créer de nouveaux projets ou de voir des informations provenant de notre chaîne Youtube ou de GetIt.

La '''page d'accueil''' est entièrement personnalisable. Elle comporte plusieurs cadres que vous pouvez ajouter, supprimer, repositionner ou redimensionner comme vous le souhaitez pour organiser les sections avec les informations que vous considérez comme les plus utiles.

[[File:WelcomePage.png|link=|border|900px]]

==Boutons du haut==

===Etendre l'EDI===

Permet d'ajouter des plates-formes, des packages ou des options à l'EDI en sélectionnant l'une des options de cette section.

===Gérer les plates-formes===

Cliquez sur ce bouton pour accéder aux '''Plates-formes''' et '''Autres options''' {{Product}} installées. Vous pouvez désinstaller toutes ces plates-formes ou en appliquer de nouvelles.

===Gestionnaire de packages GetIt===

Cliquez sur ce bouton pour afficher le Gestionnaire de packages GetIt.

===Correctif disponible===

Ce bouton n'est pas toujours visible, mais il s'affiche lorsqu'un correctif ou une mise à jour est disponible pour {{Product}}. Nous recommandons d'installer tous les correctifs. Pour ce faire, cliquez sur ce bouton.

==Fonctionnalité intégrée==

Les cadres suivants sont fournis par Embarcadero et affichés par défaut :

===Créer===

Ce cadre vous permet de créer rapidement un nouveau projet. Il affiche le même contenu que le menu {{Menu|Fichier > Nouveau}}. Vous pouvez passer de {{Delphi}} à C++.

===Ouvrir Récents===

Pour un accès rapide, cette section répertorie tous les projets et les fichiers récents sur lesquels vous avez travaillé récemment. Cliquez sur l'icône Cœur pour ajouter un élément récemment ouvert à vos favoris. Il s'affichera en haut de la liste.

Vous avez la possibilité d'ouvrir votre projet depuis le contrôle de version.

===Learn===

Cette section affiche les vidéos récentes de notre chaîne Youtube, pour vous aider à apprendre de nouvelles choses sur {{Product}}, {{Delphi}}, C++, etc.

===Nouveau dans GetIt===

Cette section affiche les derniers packages ajoutés au gestionnaire de packages GetIt. Double-cliquez sur un package pour l'ouvrir dans le gestionnaire de packages GetIt et l'installer.

===Promu dans GetIt===

Cette section affiche des packages spécifiques disponibles dans le gestionnaire de packages susceptibles de vous intéresser.

==Edition==

===Modifier la disposition===

Cliquez sur le bouton '''Modifier la disposition''' en bas à gauche de la '''page d'accueil'''. Si certaines pages ne sont pas visibles sur la page d'accueil, elles seront disponibles dans la colonne de gauche : double-cliquez sur une page pour l'ajouter à la page d'accueil. Une fois ajoutés, les cadres peuvent être sélectionnés puis déplacés, redimensionnés ou supprimés. A ce point, ils réapparaîtront dans la liste de gauche.

Les cadres sont placés sur une grille. Vous pouvez agrandir ou réduire la grille en cliquant sur les boutons + et - dans les en-têtes de colonne et de ligne. Un plus grand nombre de lignes et de colonnes permet une disposition plus complexe ou affinée.

[[File:Edit Layout.png|link=|border|700px]]

Pour modifier un cadre spécifique, cliquez sur ce cadre dans la section principale de l'éditeur pour le sélectionner. Une fois sélectionné, il sera en surbrillance et contiendra des boutons vous permettant de le modifier. Vous pouvez :

* Supprimer le cadre en cliquant sur le bouton X rouge
* Déplacer le cadre vers le haut et vers le bas ou vers la gauche et vers la droite (en conservant la même taille)
* Agrandir ou réduire le cadre verticalement (en partant du bas) ou horizontalement (en partant de la droite)

Cela vous permet de placer un cadre où vous le souhaitez, avec la forme et la taille voulues. Les zones vides de la grille seront simplement vierges lorsque la page d'accueil s'affichera.

[[File:Layout Editor.png|link=|border|700px]]

Cliquez sur '''Rétablir la disposition par défaut''' pour supprimer vos modifications.

Cliquez sur '''Options...''' pour modifier le thème de l'arrière-plan de la page d'accueil. Pour de plus amples informations, consultez la [[Présentation de l'EDI|page d'accueil]].

[[File:Background Theme.png|link=|border|700px]]

Vous pouvez également définir la couleur de vos onglets avec un plugin ToolAPI appelé interface INTACustomEditorView280.

[[File:Tab Colors.png|link=|border]]

Les fichiers ouverts pendant le débogage affichent une case à cocher indiquant qu'ils seront fermés à la fin de la session de débogage. Le bouton Fermer "X" est facultatif. Pour le configurer, accédez à la section [[Onglets|Onglets]].

==Autre==

Par défaut, la page de bienvenue est fermée quand vous ouvrez un projet. Pour la laisser ouverte, décochez la case '''Fermer l'écran d'accueil à l'ouverture d'un nouveau projet'''.

Pour rouvrir la '''page d'accueil''', choisissez {{Menu|Voir > Page d'accueil}}.

==Voir aussi==

* [[Présentation de l'EDI|Présentation de l'EDI]]
* [[Aperçu et page d'accueil#Page d'accueil|Aperçu et Page d'accueil (tutoriel de l'EDI)]]
* [[Introduction à RAD Studio|Introduction à RAD Studio]]
* [[Nouveautés|Nouveautés]]
*[[Gestionnaire de fonctionnalités|Boîte de dialogue Gestionnaire de fonctionnalités]]
*[[Gestionnaire de packages GetIt|Gestionnaire de packages GetIt]]

[[Category:Référence RAD Studio]]
[[Category:AMMigrate]]

Utilisation de notifications

2025-05-28T09:34:25Z

Yukikoi : 1 révision importée : LOC-23438

{{Parent|Utilisation de la RTL dans les applications multi-périphériques}}

Les '''notifications''' sont des messages que les applications envoient pour communiquer des informations ou des alertes.

{{Note| Cette rubrique traite des '''notifications locales''' qui sont des notifications envoyées par les applications du périphérique. Pour les '''notifications distantes''', voir [[Notifications push|Notifications push]].}}

{{Product}} fournit le composant [[lib_fr:System.Notification.TNotificationCenter|TNotificationCenter]] pour gérer les notifications multi-périphériques. Le Centre de notifications vous permet d'envoyer des messages depuis les applications en cours d'exécution. Les applications peuvent utiliser les notifications pour informer l'utilisateur.

Le composant [[lib_fr:System.Notification.TNotification|TNotification]] est le message que l'application envoie au Centre de notifications pour l'afficher sur la zone de notification désignée, selon la plate-forme.

Vous pouvez créer des notifications pour {{f|vcl|Windows en utilisant la VCL, ou pour}} vos [[Applications multi-périphériques - Index|applications multi-périphériques]] en utilisant {{FM}}.

==Prise en charge des notifications selon la plate-forme==

{| class="wikitable"
|-
! '''Elément'''
! '''Windows'''
! '''macOS'''
! '''iOS'''
! '''Android'''
|- valign="top"
| '''Plates-formes prises en charge'''
| style="text-align: center;" | {{V}}
Windows 10 et Windows 8
| style="text-align: center;" | {{V}}
10.8+
| style="text-align: center;" | {{V}}
| style="text-align: center;" | {{V}}
|- valign="top"
| '''Nom de la zone de notification'''
| style="text-align: center;" | [https://en.wikipedia.org/wiki/Action_Center Centre de notifications ou Action Center (EN)]
| style="text-align: center;" | [https://en.wikipedia.org/wiki/Notification_Center Centre de notifications ou Notification Center (EN)]
| style="text-align: center;" | [https://en.wikipedia.org/wiki/Notification_Center Centre de notifications ou Notification Center (EN)]
| style="text-align: center;" | [http://developer.android.com/guide/topics/ui/notifiers/notifications.html Tiroir de notifications ou Notification Drawer (EN)]
|- valign="top"
| colspan="5" style="background: #d7d7d7;" | '''[[lib_fr:System.Notification.TNotification|TNotification]]'''
|- valign="top"
| '''[[lib_fr:System.Notification.TNotification.Name|TNotification.Name]]'''
| style="text-align: center;" | {{V}}
| style="text-align: center;" | {{V}}
| style="text-align: center;" | {{V}}
| style="text-align: center;" | {{V}}
|- valign="top"
| '''[[lib_fr:System.Notification.TNotification.AlertBody|TNotification.AlertBody]]'''
| style="text-align: center;" | {{V}}
| style="text-align: center;" | {{V}}
| style="text-align: center;" | {{V}}
Obligatoire
| style="text-align: center;" | {{V}}
|- valign="top"
| '''[[lib_fr:System.Notification.TNotification.Title|TNotification.Title]]'''
| style="text-align: center;" | {{V}}
| style="text-align: center;" | {{V}}
En absence de titre, le nom de l'app est utilisé comme titre.
| style="text-align: center;" | Non pris en charge.
Nom d'app utilisé comme titre.
| style="text-align: center;" | {{V}}
En absence de titre, le nom de l'app est utilisé comme titre.
|- valign="top"
| '''[[lib_fr:System.Notification.TNotification.FireDate|TNotification.FireDate]]'''
| style="text-align: center;" | Non pris en charge.
| style="text-align: center;" | {{V}}
| style="text-align: center;" | {{V}}
| style="text-align: center;" | {{V}}
|- valign="top"
| '''[[lib_fr:System.Notification.TNotification.Number|TNotification.Number]]'''
| style="text-align: center;" | Non pris en charge.
| style="text-align: center;" | Non pris en charge.
| style="text-align: center;" | {{V}}
Définit le numéro de badge.
| style="text-align: center;" | {{V}}
|- valign="top"
| '''[[lib_fr:System.Notification.TNotification.EnableSound|TNotification.EnableSound]]'''
| style="text-align: center;" | {{V}}
| style="text-align: center;" | {{V}}
| style="text-align: center;" | {{V}}
| style="text-align: center;" | {{V}}
|- valign="top"
| '''[[lib_fr:System.Notification.TNotification.AlertAction|TNotification.AlertAction]]'''
| style="text-align: center;" | Non pris en charge.
| style="text-align: center;" | {{V}}
| style="text-align: center;" | {{V}}
| style="text-align: center;" | Non pris en charge.
|- valign="top"
| '''[[lib_fr:System.Notification.TNotification.HasAction|TNotification.HasAction]]'''
| style="text-align: center;" | Non pris en charge.
| style="text-align: center;" | {{V}}
| style="text-align: center;" | {{V}}
| style="text-align: center;" | Non pris en charge.
|- valign="top"
| '''[[lib_fr:System.Notification.TNotification.RepeatInterval|TNotification.RepeatInterval]]'''
| style="text-align: center;" | Non pris en charge.
| style="text-align: center;" | {{V}}
| style="text-align: center;" | {{V}}
| style="text-align: center;" | {{V}}
|- valign="top"
| colspan="5" style="background: #d7d7d7;" | '''[[lib_fr:System.Notification.TCustomNotificationCenter|TCustomNotificationCenter]]'''
|- valign="top"
| '''[[lib_fr:System.Notification.TCustomNotificationCenter.ApplicationIconBadgeNumber|TCustomNotificationCenter.ApplicationIconBadgeNumber]]'''
| style="text-align: center;" | Non pris en charge.
| style="text-align: center;" | Non pris en charge.
Voir [[samp_en:OSX Dock Badges (Delphi)|l'exemple OS X Badge]].
| style="text-align: center;" | {{V}}
| style="text-align: center;" | Non pris en charge.
|- valign="top"
| '''[[lib_fr:System.Notification.TCustomNotificationCenter.ScheduleNotification|TCustomNotificationCenter.ScheduleNotification]]'''
| style="text-align: center;" | Non pris en charge.
| style="text-align: center;" | {{V}}
| style="text-align: center;" | {{V}}
| style="text-align: center;" | {{V}}
|- valign="top"
| '''[[lib_fr:System.Notification.TCustomNotificationCenter.PresentNotification|TCustomNotificationCenter.PresentNotification]]'''
| style="text-align: center;" | {{V}}
| style="text-align: center;" | {{V}}
| style="text-align: center;" | {{V}}
| style="text-align: center;" | {{V}}
|}

===Notifications Windows===

Les notifications toast sont compatibles avec les versions suivantes de Windows :

* '''Windows 8''' : Windows 8 affiche les notifications pendant un bref laps de temps. Elles ne sont ensuite plus accessibles à l'utilisateur.
* '''Windows 10''' : Windows 10 affiche les notifications pendant un bref laps de temps. Elles sont ensuite accessibles depuis le '''Centre de notifications'''.

Pour accéder au Centre de notifications, cliquez sur l'icône Centre de notifications sur la barre des tâches. L'icône change selon que des notifications sont en attente ou non :

:
{| class="wikitable"
|-
! Notifications en attente
! Aucune notification en attente
|- valign="center"
| style="text-align: center" | [[File:W10-NotificationsPending.png]]
| style="text-align: center" | [[File:W10-NoNotificationsPending.png]]
|}

===Notifications macOS===

Depuis la version 10.8, macOS prend en charge les notifications. Pour de plus amples informations sur macOS, voir [[Utilisation du Centre de notifications macOS|Utilisation du Centre de notifications macOS]].

===Notifications iOS===

====Permissions d'utilisation====

Pour utiliser des notifications sur iOS, ajoutez des permissions de notifications à votre application :

# Sélectionnez {{Menu|Projet > Options > [[Informations de version|Informations de version]]}}.
# Sélectionnez la plate-forme cible iOS appropriée.
# Dans la zone de liste clé-valeur, définissez la valeur de {{Code|FMLocalNotificationPermission}} sur {{True}}.

: [[File:FMLocalNotificationPermission.png]]

====Alerte de notification====

iOS permet à l'utilisateur de définir si les notifications d'une app sont affichées sous forme de bannière ou d'alerte. Les bannières sont affichées à l'écran pendant une courte durée, alors que les alertes restent affichées à l'écran jusqu'à ce que l'utilisateur interagisse.

Pour afficher les notifications sous forme d'alertes, l'utilisateur final doit accéder aux paramètres de notifications de l'application sur le périphérique iOS, et définir le paramètre '''Style d'alerte si déverrouillé''' sur '''Alertes'''.

==Création de notifications==

La classe [[lib_fr:System.Notification.TNotification|TNotification]] est utilisée pour créer des messages de notification. Vous devez utiliser le composant [[lib_fr:System.Notification.TNotificationCenter|TNotificationCenter]] pour gérer une ou plusieurs instances de [[lib_fr:System.Notification.TNotification|TNotification]].

Une fois le composant [[lib_fr:System.Notification.TNotificationCenter|TNotificationCenter]] installé sur votre fiche, vous pouvez déclarer une variable <code>TNotification</code> et appeler la méthode [[lib_fr:System.Notification.TCustomNotificationCenter.CreateNotification|CreateNotification]] pour créer la notification.

<l s="delphi" />'''{{Delphi}} : '''<source lang="delphi">
MyNotification:= NotificationCenter1.CreateNotification;</source><l e="delphi" />

<l s="cpp" />'''C++ : '''<source lang="cpp">
TNotification *MyNotification = NotificationCenter1->CreateNotification();</source><l e="cpp" />

Une fois la notification créée, nous vous recommandons de définir au moins les champs suivants :

* [[lib_fr:System.Notification.TNotification.Name|Name]] : le nom unique permettant d'identifier la notification.
* [[lib_fr:System.Notification.TNotification.AlertBody|AlertBody]] : le texte de la notification. Sous iOS, il est obligatoire de spécifier <code>AlertBody</code>.

Les paramètres suivants peuvent être également spécifiés pour vos notifications :

* [[lib_fr:System.Notification.TNotification.Title|Title]] : le titre de la notification. iOS n'est pas compatible avec le champ <code>Title</code> et affiche toujours le nom de l'app comme titre.

* [[lib_fr:System.Notification.TNotification.Number|Number]] : utilisez ce champ pour mettre à jour le numéro de notification sous Android ou le numéro de badge d'application sous iOS.

* [[lib_fr:System.Notification.TCustomNotificationCenter.ApplicationIconBadgeNumber|ApplicationIconBadgeNumber]] : utilisez cette propriété pour mettre à jour le numéro de badge de l'application sous iOS.

:
{| class="wikitable"
|-
! '''Numéro de badge iOS'''
! '''Numéro de notification Android'''
|- valign="center"
| [[File:IOSNotification.PNG|120px]]
| [[File:Android Notification with number.png]]
|}

===Création d'un canal de notification===

{{Note|Depuis la release 'Android 8.0', toutes les 'notifications' doivent être affectées à un ''''canal de notification''''.}}

Le 'canal de notification' de secours est uniquement créé dans les cas suivants :

* L'application reçoit une 'charge utile de notification push' qui ne définit pas la clé 'gcm.notification.android_channel_id' et vous n'avez défini aucun 'id de canal de notification' par défaut
* L'application reçoit une 'charge utile de notification push' qui ne définit pas la clé 'gcm.notification.android_channel_id', vous avez défini un 'id de canal de notification' par défaut, mais le 'canal de notification' par défaut n'a pas été créé dans le code
* L'application reçoit une 'charge utile de notification push' qui définit la clé 'gcm.notification.android_channel_id', ce 'canal de notification' n'a pas été créé dans le code et vous n'avez défini aucun 'id de canal de notification' par défaut
* L'application reçoit une 'charge utile de notification push' qui définit la clé 'gcm.notification.android_channel_id', ce 'canal de notification' n'a pas été créé dans le code, vous avez défini un 'id de canal de notification' par défaut, mais le 'canal de notification' par défaut n'a pas été créé dans le code

La manipulation des ‘canaux de notification’ est réalisée par le biais des méthodes suivantes de la classe [[lib_fr:TSystem.Notification.TNotificationCenter|TNotificationCenter]] :

<source lang="Delphi">
function CreateChannel: TChannel; overload;
function CreateChannel(const AId: string; const ATitle: string; const ADescription: string = ''): TChannel; overload;
procedure CreateOrUpdateChannel(const AChannel: TChannel);
procedure DeleteChannel(const AChannelId: string);
procedure GetAllChannels(const AChannels: TChannels);</source>

====Créer un 'canal de notification' personnalisé et le définir comme canal par défaut====

N'oubliez pas que vous n'avez pas besoin de changer la 'description' du 'canal de notification' de secours. Il vous faut seulement éviter sa création en suivant ces étapes :

1. Création de votre 'canal de notification' personnalisé dans le code :
<source lang="Delphi">
procedure CreateDefaultNotificationChannel;
var
NotificationChannel: TChannel;
begin
NotificationChannel := NotificationCenter.CreateChannel;
NotificationChannel.Id := 'custom_notification_channel';
NotificationChannel.Title := 'Custom notification channel';
NotificationChannel.Description := 'Notification channel used for Firebase';
NotificationChannel.Importance := TImportance.High; // NOTE: This is a 'heads-up notification'.

NotificationCenter.CreateOrUpdateChannel(NotificationChannel);
end;</source>
2. Définition de 'l'id du canal de notification' par défaut dans les options du projet :

* Cliquez sur l'élément de menu 'Projet > Options...'
* Accédez à la page d'options 'Application > Services'
* Remplacez 'l'id du canal de notification local par défaut' par 'custom_notification_channel'
* Enregistrez les modifications dans les options du projet

3. S'assurer que les nouvelles options du projet sont appliquées :

* Construisez et déployez votre application
* Ouvrez le fichier 'AndroidManifest.xml' généré
* Recherchez la déclaration 'meta-data' suivante :

<code><meta-data android:name="com.google.firebase.messaging.default_notification_channel_id" android:value="custom_notification_channel" /></code>

4. Envoi des 'charges utiles de notification push' au serveur 'Firebase Cloud Messaging' :

* Sur le périphérique Android...
**Lancez votre application
**Ouvrez l'application 'Paramètres' de votre périphérique de test
**Appuyez sur l'élément 'Apps & notifications'
**Dans la liste, appuyez sur l'élément correspondant à votre application
**Appuyez sur l'élément 'Notifications'
**Vérifiez que 'Canal de notification personnalisé' est répertorié comme un 'canal de notification'
* Sur l'hôte Windows...
**Envoyez une 'charge utile de notification push' au serveur 'Firebase Cloud Messaging', en définissant le 'token d'enregistrement du périphérique'
*De retour sur le périphérique Android...
**Ouvrez l'application 'Paramètres' de votre périphérique de test
**Appuyez sur l'élément 'Apps & notifications'
**Dans la liste, appuyez sur l'élément correspondant à votre application
**Appuyez sur l'élément 'Notifications'
**Vérifiez que le 'canal de notification pour Firebase' n'est pas répertorié comme un 'canal de notification'

{{Note|Pour éviter de créer le ‘canal de notification’ de secours, vous n'avez pas besoin de définir ‘l'id du canal de notification’ dans la ‘charge utile de notification push’ pour pouvoir assigner des ‘notifications push’ à votre ‘canal de notification’ par défaut.}}

====Créer plusieurs 'canaux de notification' et leur assigner des 'notifications push'====

Pour créer plusieurs ‘canaux de notification’, vous devez créer plusieurs ‘canaux de notification’ dans le code et définir ‘l'id des canaux de notification’ dans la ‘charge utile de notification push’.

Suivez ces étapes pour créer plusieurs 'canaux de notification' et leur assigner des 'notifications push'. Vous trouverez ci-dessous toutes les possibilités disponibles pour assigner des 'notifications push' aux 'canaux de notification', soit en définissant 'l'id des canaux de notification' dans la 'charge utile de notification push', soit en définissant 'l'id du canal de notification' par défaut dans les options du projet.

Suivez ces instructions pour créer plusieurs 'canaux de notification' dans le code :

<source lang="Delphi">
procedure CreateNotificationChannel(const Id: string; const Title: string; const Description: string; Importance: TImportance);
var
NotificationChannel: TChannel;
begin
NotificationChannel := NotificationCenter.CreateChannel;
NotificationChannel.Id := Id;
NotificationChannel.Title := Title;
NotificationChannel.Description := Description;
NotificationChannel.Importance := Importance;
NotificationCenter.CreateOrUpdateChannel(NotificationChannel);
end;</source>

Suivez ces étapes pour envoyer les ‘charges utiles de notification push’ au serveur 'Firebase Cloud Messaging' :

# Tout d'abord, sur l'hôte Windows, construisez et lancez votre application.
# Sur le périphérique Android :
## Ouvrez l'application 'Paramètres' de votre périphérique de test.
## Appuyez sur l'élément 'Apps & notifications'.
## Dans la liste, appuyez sur l'élément correspondant à votre application.
## Appuyez sur l'élément 'Notifications'.
## Vérifiez que vos canaux de notification sont listés.
#Sur l'hôte Windows :
##Envoyez une 'charge utile de notification push' au serveur 'Firebase Cloud Messaging', en définissant le 'token d'enregistrement du périphérique' et 'l'id du canal de notification'.

Selon l'approche utilisée pour envoyer les 'charges utiles de notification push' au serveur 'Firebase Cloud Messaging', définissez la clé appropriée :

*
** [https://firebase.google.com/docs/reference/fcm/rest/v1/projects.messages API HTTP v1] : définissez la clé 'channel_id'.
** [https://firebase.google.com/docs/cloud-messaging/xmpp-server-ref Serveur XMPP] : définissez la clé 'android_channel_id'.
** [https://firebase.google.com/docs/cloud-messaging/http-server-ref Serveur HTTP existant] : définissez la clé 'android_channel_id'.

Encore une fois, sur le périphérique Android :

#Ouvrez l'application 'Paramètres' de votre périphérique de test
#Appuyez sur l'élément 'Apps & notifications'
#Dans la liste, appuyez sur l'élément correspondant à votre application
#Appuyez sur l'élément 'Notifications'
# Vérifiez que le 'canal de notification pour Firebase' n'est pas répertorié comme un 'canal de notification'

==Déclenchement des notifications==

[[lib_fr:System.Notification.TNotification.FireDate|FireDate]] est utilisé pour définir la [[lib_fr:System.TDateTime|date et l'heure]] de déclenchement de la notification.

Concernant l'heure de déclenchement de la notification, il est possible de créer deux types de notifications.

* Les [[#Notifications immédiates|notifications immédiates]]
* Les [[#Notifications planifiées|notifications planifiées]]

===Notifications immédiates===

Par défaut, [[lib_fr:System.Notification.TNotification.FireDate|FireDate]] est défini sur [[lib_fr:System.SysUtils.Now|Now]]. Ainsi, si vous ne changez pas la valeur de [[lib_fr:System.Notification.TNotification.FireDate|FireDate]], la notification est déclenchée immédiatement.

===Notifications planifiées===

Les notifications peuvent être planifiées de façon à se déclencher à tout moment. Définissez [[lib_fr:System.Notification.TNotification.FireDate|FireDate]] sur la [[lib_fr:System.TDateTime|date et l'heure]] auxquelles vous voulez déclencher la notification.

====Déclenchement de notifications à une date et une heure particulières====

Vous pouvez définir qu'une notification sera déclenchée à une date et une heure précises. Par exemple, pour spécifier qu'une notification sera déclenchée le ''16 décembre 2015 à 17:30'', vous devez définir [[lib_fr:System.Notification.TNotification.FireDate|FireDate]] comme suit :

<l s="delphi" />'''{{Delphi}} : '''<source lang="delphi">
MyNotification.FireDate := EncodeDateTime(2015, 12, 16, 17, 30, 00, 00);</source><l e="delphi" />

<l s="cpp" />'''C++ : '''<source lang="cpp">
MyNotification->FireDate = System::Dateutils::EncodeDateTime(2015, 12, 16, 17, 30, 00, 00);</source><l e="cpp" />

Lorsque vous planifiez des notifications pour une date et une heure spécifiques, vous devez garder à l'esprit que si la date et l'heure de <code>FireDate</code> sont passées, la notification est déclenchée immédiatement.

====Déclenchement de notifications après un laps de temps====

Vous pouvez définir qu'une notification sera déclenchée après un laps de temps. Par exemple, pour déclencher la notification dans une minute et trente secondes, vous pouvez procéder comme suit :

<l s="delphi" />'''{{Delphi}} : '''<source lang="delphi">
MyNotification.FireDate := Now + EncodeTime(0, 1, 30, 0);</source><l e="delphi" />

<l s="cpp" />'''C++ : '''<source lang="cpp">
MyNotification->FireDate = Now() + EncodeTime(0, 1, 30, 0);</source><l e="cpp" />

Si une notification est planifiée et que vous avez créé une notification portant le même nom (qu'elle soit planifiée ou non), toute notification précédente ayant été planifiée sous ce nom est écrasée.

==Répétition des notifications==

Vous pouvez utiliser [[lib_fr:System.Notification.TNotification.RepeatInterval|RepeatInterval]] pour planifier des notifications afin qu'elles se répètent après une certaine période de temps. Vous pouvez utiliser l'un des types d'intervalles définis par [[lib_fr:System.Notification.TRepeatInterval|TRepeatInterval]] : <code>None</code>, <code>Second</code>, <code>Minute</code>, <code>Hour</code>, <code>Day</code>, <code>Week</code>, <code>Weekday</code>, <code>Month</code>, <code>Quarter</code>, <code>Year</code> ou <code>Era</code>.

{{Warning| Lorsque vous planifiez une notification de façon à ce qu'elle se répète après une certaine période de temps (<code>RepeatInterval</code>), la notification continue de se répéter jusqu'à la fermeture de l'application. Assurez-vous de bien utiliser [[#Annulation des notifications|l'annulation des notifications]].}}

Par exemple, pour définir une notification de façon à ce qu'elle se répète chaque heure, vous pouvez procéder comme suit :

<l s="delphi" />'''{{Delphi}} : '''<source lang="delphi">
MyNotification.RepeatInterval := TRepeatInterval.Hour;</source><l e="delphi" />

<l s="cpp" />'''C++ : '''<source lang="cpp">
MyNotification->RepeatInterval = TRepeatInterval::Hour;</source><l e="cpp" />

==Son des notifications==

===Activation du son des notifications===

Vous pouvez activer ou désactiver le son des notifications en utilisant [[lib_fr:System.Notification.TNotification.EnableSound|EnableSound]]. Par défaut, <code>EnableSound</code> est définie sur {{True}}.

* Sur '''macOS''' et '''iOS''', le son de la notification n'est pas exécuté même en cas d'activation du son si l'application est au premier plan. macOS et iOS exécutent le son de la notification lorsque l'application est fermée ou à l'arrière-plan.
* Sur '''Windows''', lorsque <code>EnableSound</code> est défini sur <code>True</code>, le son de la notification est exécuté. Vous pouvez désactiver le son en définissant cette propriété sur <code>False</code>.

===Personnalisation des sons de notifications===

Vous pouvez personnaliser le son de vos notifications en définissant [[lib_fr:System.Notification.TNotification.SoundName|SoundName]] sur le son de votre notification.

Pour ajouter un son de notification personnalisé, procédez comme suit :

# Effectuez un glisser-déposer du fichier son sur le nom de votre projet dans la [[Fenêtre Projets|fenêtre Projets]] et confirmez l'ajout du fichier.
# Accédez à {{Menu|Projet > [[Gestionnaire de déploiement|Déploiement]]}} et définissez correctement les chemins distants du fichier pour les différentes plates-formes.
#* '''iOS : '''{{Path|.\}}
# Indiquez le nom du fichier personnalisé, définissez <code>SoundName</code> selon la plate-forme.

<l s="delphi" />'''{{Delphi}} : '''<source lang="delphi">
{$IFDEF IOS}
MyNotification.SoundName := 'nameOfSound.caf';
{$ENDIF}</source><l e="delphi" />

<l s="cpp" />'''C++ : '''<source lang="cpp">
#if defined(_PLAT_IOS)
myNotification->SoundName = "nameOfSound.caf";
#endif</source><l e="cpp" />

{{Note| Selon la documentation iOS, le fichier son doit avoir l'extension de fichier {{Path|aiff}}, {{Path|wav}} ou {{Path|caf}}.}}

Assurez-vous d'ajouter l'unité appropriée à votre projet :

<l s="delphi" />'''{{Delphi}} :''' Ajoutez [[lib_fr:System.IOUtils|System.IOUtils]] dans la clause uses.<source lang="delphi">
System.IOUtils;</source><l e="delphi" />

<l s="cpp" />'''C++ :''' Ajoutez [[lib_fr:System.IOUtils|System.IOUtils.hpp]] dans le fichier d'en-tête {{Path|.h}} de votre projet.<source lang="cpp">
#include <System.IOUtils.hpp></source><l e="cpp" />

Si le périphérique n'est pas capable de trouver le fichier son personnalisé que vous avez défini dans votre projet, iOS exécute le son par défaut. Android quant à lui n'exécute aucun son.

==Actions des notifications==

Cliquer sur les notifications sous '''macOS''', '''iOS''' ou '''Android''' provoque l'affichage au premier plan de l'application ayant envoyé la notification, même si cette application est fermée ou exécutée en arrière-plan.

Aucun comportement particulier n'est attendu lorsque l'utilisateur clique sur la notification sous '''Windows'''.

===Ajout des actions des notifications===

Lorsque l'utilisateur clique sur une notification, des actions peuvent être exécutées. L'événement [[lib_fr:System.Notification.TNotificationCenter.OnReceiveLocalNotification|OnReceiveLocalNotification]] est déclenché lorsque l'utilisateur clique sur une notification. Ecrivez un gestionnaire d'événement pour définir une action.

Le gestionnaire d'événement de <code>OnReceiveLocalNotification</code> reçoit le TNotitication sur lequel l'utilisateur a cliqué dans le paramètre {{Arg|ANotification}}. Utilisez le paramètre {{Arg|ANotification}} pour obtenir des informations supplémentaires sur la notification sur laquelle l'utilisateur a cliqué.

Pour afficher un message selon la notification sur laquelle l'utilisateur a cliqué :

<l s="delphi" />'''{{Delphi}} : '''<source lang="delphi">
if ANotification.Name='ProcessCompleted' then
ShowMessage('The process is completed.');</source><l e="delphi" />

<l s="cpp" />'''C++ : '''<source lang="cpp">
if (ANotification->Name == "ProcessCompleted") {
ShowMessage("The process is completed.");
}</source><l e="cpp" />

===Actions des notifications (macOS et iOS)===

Vous pouvez ajouter un bouton d'action à une alerte afin que l'utilisateur puisse ouvrir l'application en cliquant sur le bouton. Pour obtenir le fonctionnement espéré, l'utilisateur doit définir le style des notifications du projet sur "Alertes". Pour de plus amples informations, découvrez comment définir les [[Utilisation du Centre de notifications macOS#Centre de notifications sur macOS|alertes de notifications sous macOS]] et [[#Alerte de notification|Alertes de notifications sous iOS]].

Pour ajouter un bouton d'action, définissez le champ [[lib_fr:System.Notification.TNotification.HasAction|HasAction]] sur {{True}}. Utilisez le champ [[lib_fr:System.Notification.TNotification.AlertAction|AlertAction]] pour indiquer le texte du bouton.

<l s="delphi" />'''{{Delphi}} : '''<source lang="delphi">
MyNotification.HasAction := True;
MyNotification.AlertAction := 'Open App';</source><l e="delphi" />

<l s="cpp" />'''C++ : '''<source lang="cpp">
MyNotification->HasAction = True;
MyNotification->AlertAction = "Open App";</source><l e="cpp" />

==Envoi de notifications au Centre de notifications==

Lorsque vous avez terminé de configurer les paramètres de votre notification, vous devez l'envoyer au Centre de notifications afin qu'il puisse la traiter.

Pour envoyer des notifications au Centre de notifications, vous pouvez utiliser l'une des méthodes suivantes :

* [[#ScheduleNotification|ScheduleNotification]]
* [[#PresentNotification|PresentNotification]]

===ScheduleNotification===

[[lib_fr:System.Notification.TCustomNotificationCenter.ScheduleNotification|ScheduleNotification]] envoie une notification planifiée au Centre de notifications. Si [[lib_fr:System.Notification.TNotification.FireDate|FireDate]] est défini sur [[lib_fr:System.SysUtils.Now|Now]] ou si <code>FireDate</code> a un TDateTime passé, la notification apparaît immédiatement. Elle est sinon planifiée comme indiqué.

{{Avertissement| Windows ne prend pas en charge <code>ScheduleNotification</code>.}}

<l s="delphi" />'''{{Delphi}} : '''<source lang="delphi">
NotificationCenter1.ScheduleNotification(MyNotification);</source><l e="delphi" />

<l s="cpp" />'''C++ : '''<source lang="cpp">
NotificationCenter1->ScheduleNotification(MyNotification);</source><l e="cpp" />

===PresentNotification===

[[lib_fr:System.Notification.TCustomNotificationCenter.PresentNotification|PresentNotification]] présente immédiatement la notification quelle que soit la valeur de [[lib_fr:System.Notification.TNotification.FireDate|FireDate]].

<l s="delphi" />'''{{Delphi}} : '''<source lang="delphi">
NotificationCenter1.PresentNotification(MyNotification);</source><l e="delphi" />

<l s="cpp" />'''C++ : '''<source lang="cpp">
NotificationCenter1->PresentNotification(MyNotification);</source><l e="cpp" />

==Annulation des notifications==

Vous pouvez annuler des notifications planifiées, des notifications répétées et vous pouvez également retirer des notifications déjà affichées dans le Centre de notifications ou le Tiroir de notifications.

===CancelNotification===

[[lib_fr:System.Notification.TCustomNotificationCenter.CancelNotification|CancelNotification]] est utilisée pour annuler une notification planifiée ou une notification répétée. Pour annuler la notification, vous devez connaître son [[lib_fr:System.Notification.TNotification.Name|nom]].

<l s="delphi" />'''{{Delphi}} : '''<source lang="delphi">
NotificationCenter1.CancelNotification('MyNotificationName');</source><l e="delphi" />

<l s="cpp" />'''C++ : '''<source lang="cpp">
NotificationCenter1->CancelNotification("MyNotificationName");</source><l e="cpp" />

===CancelAll===

[[lib_fr:System.Notification.TCustomNotificationCenter.CancelAll|CancelAll]] annule l'ensemble des notifications :

:
:* Les notifications planifiées ne seront pas déclenchées.
:* Les notifications ayant des intervalles de répétition sont annulées.
:* Les notifications disponibles dans le Centre de notifications ou le Tiroir de notifications de cette application sont supprimées.

<l s="delphi" />'''{{Delphi}} : '''<source lang="delphi">
NotificationCenter1.CancelAll;</source><l e="delphi" />

<l s="cpp" />'''C++ : '''<source lang="cpp">
NotificationCenter1->CancelAll();</source><l e="cpp" />

==Mise à jour des notifications==

Vous pouvez mettre à jour les notifications en attente de déclenchement en utilisant leur nom (<code>Name</code>), qui est l'identificateur unique de la notification. Pour mettre à jour une notification, suivez ces étapes :

# [[#Création de notifications|Créez une instance de TNotification]] ayant le même <code>nom</code> que celle que vous souhaitez mettre à jour.
# Configurez la nouvelle instance avec les paramètres voulus.
# [[#Envoi de notifications au Centre de notifications|Envoyez la notification au Centre de notifications]].

La mise à jour des notifications futures, qu'elles soient planifiées ou qu'elles soient répétitives, supprime les notifications déjà présentes dans le Centre de notifications ou le Tiroir de notifications et écrase les futures notifications.

==Voir aussi==

* [[Utilisation du Centre de notifications macOS|Utilisation du Centre de notifications macOS]]
* [[Tutoriel mobile : Utilisation des notifications (iOS et Android)|Tutoriel mobile : Utilisation des notifications (iOS et Android)]]
* [[Notifications push|Notifications push]]
* [[lib_fr:System.Notification.TNotification|System.Notification.TNotification]]
* [[lib_fr:System.Notification.TNotificationCenter|System.Notification.TNotificationCenter]]

===Exemples de code===

* Exemple [[samp_en:FMX.SendCancelNotification Sample|{{FM}} Send Cancel Notification]]
* Exemple [[samp_en:FMX.Android Notification Service Sample|{{FM}} Android Notification Service]]
* Exemple [[samp_en:FMX.SetResetBadgeNumber Sample|{{FM}} Set Reset Badge Number]]
* [[samp_en:OSX Dock Badges (Delphi)|OSX Dock Badges]] (Delphi)
* [[samp_en:FMX.Notification.Mac (Delphi)|{{FM}} Notification Mac]] (Delphi)
* [[samp_en:FMX.Notification.Mac (C++)|{{FM}} Notification Mac]] (C++)

[[Category:C++]]
[[Category:Delphi]]
[[Category:Multi-périphérique]]
[[Category:AMMigrate]]

Tutoriels

2025-05-28T09:34:20Z

Yukikoi : 1 révision importée : LOC-23438

{{Parent|Accueil}}

Les tutoriels suivants décrivent comment utiliser {{Product}} :

==[[Tutoriels d'introduction|Tutoriels d'introduction]]==

* '''[[Tutoriel : Utilisation de l'EDI|Tutoriel : Utilisation de l'EDI]]''' (création de votre premier projet FireMonkey)

{{f|vcl| * '''[[Tutoriel : Utilisation des bibliothèques de liaison dynamique dans les applications C++Builder|Tutoriel : Utilisation des bibliothèques dynamiques dans les applications C++Builder]]''' }}

==[[Tutoriels mobiles : Développement d'applications mobiles (iOS et Android)|Tutoriels mobiles : Développement d'applications mobiles (iOS et Android)]]==

====Eléments d'interface utilisateur élémentaires pour environnement mobile====

:
:* [[Tutoriel mobile : Définition de votre environnement de développement sur le Mac (iOS)|Tutoriel mobile : Définition de votre environnement de développement sur le Mac (iOS)]]
:* [[Tutoriel mobile : Définition de votre environnement de développement sur un PC Windows (iOS)|Tutoriel mobile : Définition de votre environnement de développement sur un PC Windows (iOS)]]
:* [[Tutoriel mobile : Définition de votre environnement de développement sur un PC Windows (Android)|Tutoriel mobile : Définition de votre environnement de développement sur un PC Windows (Android)]]
:* [[Tutoriel mobile : Création d'une application pour les plates-formes mobiles (iOS et Android)|Tutoriel mobile : Création d'une application pour les plates-formes mobiles (iOS et Android)]]
:* [[Tutoriel mobile : Utilisation d'un composant carnet d'adresses (iOS et Android)|Tutoriel mobile : Utilisation d'un composant Carnet d'adresses (iOS et Android)]]
:* [[Tutoriel mobile : Utilisation d'un composant Bouton avec différents styles (iOS et Android)|Tutoriel mobile : Utilisation d'un composant Bouton avec différents styles (iOS et Android)]]
:* [[Tutoriel mobile : Utilisation d'un composant Calendrier pour sélectionner une date (iOS et Android)|Tutoriel mobile : Utilisation d'un composant Calendrier pour sélectionner une date (iOS et Android)]]
:* [[Tutoriel mobile : Utilisation de composants Zone de liste déroulante pour sélectionner des éléments dans une liste (iOS et Android)|Tutoriel mobile : Utilisation de composants Zone de liste déroulante pour sélectionner des éléments dans une liste (iOS et Android)]]
:* [[Tutoriel mobile : Utilisation d'un composant Carte pour travailler avec des cartes (iOS et Android)|Tutoriel mobile : Utilisation d'un composant Carte pour l'utilisation de cartes (iOS et Android)]]
:* [[Tutoriel mobile : Utilisation d'un composant Vue multiple pour afficher d'autres vues d'informations (iOS et Android)|Tutoriel mobile : Utilisation d'un composant Vue multiple pour afficher d'autres vues d'informations (iOS and Android)]]
:* [[Tutoriel mobile : Utilisation du composant Navigateur Web (iOS et Android)|Tutoriel mobile : Utilisation du composant Navigateur Web (iOS et Android)]]
:* [[Tutoriel mobile : Utilisation des composants Onglet pour afficher des pages (iOS et Android)|Tutoriel mobile : Utilisation des composants Onglet pour afficher des pages (iOS et Android)]]
:* [[Tutoriel mobile : Utilisation des composants Zone de liste pour afficher une vue table (iOS et Android)|Tutoriel mobile : Utilisation des composants Zone de liste pour afficher une vue table (iOS et Android)]]
:* [[Tutoriel mobile : Utilisation de LiveBindings pour remplir une vue liste (iOS et Android)|Tutoriel mobile : Utilisation de LiveBindings pour remplir une vue liste (iOS et Android)]]
:* [[Tutoriel mobile : Utilisation de LiveBindings pour remplir une zone de liste dans les applications mobiles (iOS et Android)|Tutoriel mobile : Utilisation de LiveBindings pour remplir une zone de liste dans les applications mobiles (iOS et Android)]]
:* [[Tutoriel mobile : Utilisation de la disposition pour ajuster différentes tailles de fiches ou orientations (iOS et Android)|Tutoriel mobile : Utilisation de la disposition pour ajuster différentes tailles de fiches ou orientations (iOS et Android)]]
:* [[Aide Expert mobile Android|Aide Expert mobile Android]]
:* [[Aide Expert mobile iOS|Aide Expert mobile iOS]]

====Utilisation des fonctionnalités du périphérique pour environnement mobile====

:
:* [[Tutoriel mobile : Prendre une photo et la partager, et partager du texte (iOS et Android)|Tutoriel mobile : Prendre une photo et la partager, et partager du texte (iOS et Android)]]
:* [[Tutoriel mobile : Utilisation de détecteurs d'emplacement (iOS et Android)|Tutoriel mobile : Utilisation de détecteurs d'emplacement (iOS et Android)]]
:* [[Tutoriel mobile : Utilisation des notifications (iOS et Android)|Tutoriel mobile : Utilisation des notifications (iOS et Android)]]
:* [[Tutoriel mobile : Utilisation du numéroteur téléphonique sur les périphériques mobiles (iOS et Android)|Tutoriel mobile : Utilisation du numéroteur téléphonique sur les périphériques mobiles (iOS et Android)]]

====Utilisation de BaaS (Backend as a Service)====

:
:* [[Tutoriel mobile : Utilisation des notifications distantes (iOS et Android)|Tutoriel mobile : Utilisation des notifications distantes (iOS et Android)]]
:* [[Tutoriel mobile : Utilisation de BaaS pour le stockage backend (iOS et Android)|Tutoriel mobile : Utilisation de BaaS pour le stockage backend (iOS et Android)]]

====Accès à une base de données pour environnement mobile====

:
:* [[Tutoriel mobile : Utilisation de FireDAC et SQLite (iOS et Android)|Tutoriel mobile : Utilisation de FireDAC et SQLite (iOS et Android)]]
:* [[Tutoriel mobile : Utilisation de InterBase ToGo avec FireDAC (iOS et Android)|Tutoriel mobile : Utilisation de InterBase ToGo avec FireDAC (iOS et Android)]]{{f|dbexpress|
:* [[Tutoriel mobile : Utilisation de dbExpress et SQLite (iOS et Android)|Tutoriel mobile : Utilisation de dbExpress et SQLite (iOS et Android)]]
:* [[Tutoriel mobile : Utilisation de InterBase ToGo avec dbExpress (iOS et Android)|Tutoriel mobile : Utilisation de InterBase ToGo avec dbExpress (iOS et Android)]]}} {{f|vcl|
:* [[Tutoriel mobile : Connexion à une base de données d'entreprise depuis un client mobile (iOS et Android)|Tutoriel mobile : Connexion à une base de données d'entreprise depuis un client mobile (iOS et Android)]]}}

====Composants utilisés dans les tutoriels mobiles====

:
:* [[Tutoriels mobiles : Tableau des composants utilisés|Tutoriels mobiles : Tableau des composants utilisés]]

==[[Tutoriels FireMonkey|Tutoriels {{FM}}]]==

* '''[[Tutoriel : Utilisation des dispositions FireMonkey|Tutoriel : Utilisation des dispositions {{FM}}]]'''
* '''[[Tutoriel : Audio-vidéo dans FireMonkey|Tutoriel : Audio-vidéo dans {{FM}}]]'''
* '''[[Tutoriel : Création d'une application 3D FireMonkey|Tutoriel : Création d'une application 3D {{FM}}]]'''
* '''[[Tutoriel : Comment utiliser les caméras dans une application FireMonkey 3D|Tutoriel : Comment utiliser les caméras dans une application 3D {{FM}}]]'''
* '''[[Tutoriel : Importation de modèles 3D (FireMonkey)|Tutoriel : Importation de modèles 3D ({{FM}})]]'''

{{f|vcl|

==Tutoriels VCL==

* [[Tutoriel : Utilisation de TControl.StyleElements dans les applications VCL|Tutoriel : Utilisation de TControl.StyleElements dans les applications VCL]]}}

==[[Tutoriels Bases de données et LiveBindings|Tutoriels Bases de données et LiveBindings]]==

{{#lst:Tutoriels Bases de données et LiveBindings|children}}

==[[Tutoriels Bibliothèque de programmation parallèle|Tutoriels Bibliothèque de programmation parallèle]]==

* [[Tutoriel : Utilisation des tâches de la bibliothèque de programmation parallèle|Tutoriel : Utilisation des tâches de la bibliothèque de programmation parallèle]]
* [[Tutoriel : Utilisation de la boucle For de la bibliothèque de programmation parallèle|Tutoriel : Utilisation de la boucle For de la bibliothèque de programmation parallèle]]
* [[Tutoriel : Utilisation des méthodes Future de la bibliothèque de programmation parallèle|Tutoriel : Utilisation des méthodes Future de la bibliothèque de programmation parallèle]]

==Voir aussi==

* [[Guide de prise en main FireMonkey - Introduction|Guide de prise en main {{FM}} - Introduction]]

{{f|radstudio|* '''[https://www.embarcadero.com/rad-in-action/delphi-labs Tutoriels vidéo : {{Delphi}} Labs, par Paweł Głowacki]'''}}

* [[Comment utiliser l'EDI|Comment utiliser l'EDI]]
* [[Comment créer des fiches et des projets, et écrire le code sous-jacent|Comment créer des fiches et des projets, et écrire le code sous-jacent]]
* [[Création d'une application FireMonkey|Création d'une application {{FM}}]]
* [[Création d'une app iOS|Création d'une app iOS]]

[[Category:Delphi]]
[[Category:C++]]
[[Category:AMMigrate]]

Présentation de l'EDI

2025-05-28T09:34:20Z

Yukikoi : 1 révision importée : LOC-23438

{{Parent|Introduction à RAD Studio}}

Quand vous démarrez {{Variables|Product}}, l'environnement de développement intégré (EDI) s'ouvre et affiche plusieurs outils et menus. L'EDI vous aide à concevoir visuellement des interfaces utilisateur, à définir les propriétés des objets, à voir et gérer votre application de diverses façons.

Cette rubrique d'aide décrit les outils qui sont disponibles dans l'EDI. Sachez que les outils spécifiques qui sont disponibles varient selon l'édition de {{Variables|Product}} que vous utilisez.

==Page d'accueil==

Lorsque vous ouvrez {{Product}}, les sections de la '''[[Page d'accueil|page d'accueil]]''' affichent différents types d'informations utiles et proposent des actions.

La '''page d'accueil''' comporte plusieurs cadres que vous pouvez ajouter, supprimer, repositionner ou redimensionner comme vous le souhaitez pour organiser les sections avec les informations que vous considérez comme les plus utiles pour commencer.

Si vous fermez la '''page d'accueil''', vous pouvez la rouvrir en choisissant {{Menu|Voir > Page d'accueil}}.

[[File:Welcome Page 1.png|850px|link=]]

{{Note| Une balise '''[Administrateur]''' s'affiche au début du libellé de la barre de titre lorsque vous exécutez '''l'EDI''' avec des privilèges élevés.}}

==[[Style EDI|Thème foncé]]==

{{Product}} {{Version}} vous permet de choisir un thème foncé pour l'EDI. Le thème foncé s'applique à un schéma de couleurs complètement différent et fournit une apparence adaptée à une utilisation prolongée ou à un environnement à faible luminosité.

Les options du thème EDI vous permettent de réaliser les actions suivantes :

* Faire correspondre au thème Windows
* Activer le thème foncé
* Activer le thème clair
* Activer le thème Mountain Mist
* Choisir les couleurs prédéfinies pour l'éditeur et pour l'inspecteur d'objets indépendamment du thème de l'EDI sélectionné.
* Choisir la couleur de la barre de titre

Pour accéder aux options relatives aux thèmes de l'EDI, choisissez {{Menu|Outils > Options > Interface utilisateur > [[Style EDI|Style de l'EDI]]}} ou cliquez sur le menu déroulant accessible dans la barre supérieure, à côté de la zone de liste déroulante des dispositions.

[[File:Top Bar Menu.png|link=]]

==Options d'accessibilité==

Avec l'EDI, vous pouvez utiliser les outils MSAA (MS Active Accessibility). Vous pouvez activer les outils d'accessibilité de Windows à partir du menu Démarrer via '''Tous les programmes > Accessoires > Accessibilité'''.

==Dispositions du bureau et option d'auto-enregistrement Bureau du projet==

La disposition du bureau par défaut de l'EDI comporte les outils les plus fréquemment utilisés ({{Menu|Outils > Options > EDI > [[Bureau et disposition|Bureau et Disposition]]}}). Vous pouvez utiliser le menu Voir pour afficher ou masquer certains outils. Vous pouvez aussi personnaliser votre bureau en déplaçant et en supprimant des éléments, et [[Enregistrement des dispositions du bureau|enregistrer les dispositions du bureau]] qui vous conviennent le mieux.

Les paramètres du bureau sont enregistrés dans un fichier <code>.dsk</code>, et l'option '''d'enregistrement automatique du bureau du projet''' (sur {{Menu|Outils > Options > EDI > [[Enregistrement et récupération|Enregistrement et récupération]]}}) permet d'enregistrer un fichier <code>.dsk</code> pour le projet en cours. Le fichier <code>.dsk</code> conserve aussi les points d'arrêt et les points de suivi en cours. Le fichier <code><monprojet>.dsk</code> est enregistré dans votre dossier projet. Voir [[Enregistrement des dispositions du bureau|Enregistrement des dispositions du bureau]].

==Onglets Editeur==

La partie centrale de la fenêtre principale de l'EDI affiche une série d'onglets avec plusieurs fichiers code source et d'autres éléments ouverts. Il s'agit de l'espace de travail central. Les onglets contiennent généralement du code source ou un concepteur de fiches, mais ils peuvent aussi contenir un éditeur spécial ou des panneaux d'information, qui ont tous des couleurs différentes pour que vous puissiez les différencier des onglets normaux de code/concepteur.

[[File:Welcome screen tabs.png|link=|550px]]

Les onglets peuvent être déplacés hors de leur fenêtre ou dupliqués en cliquant dessus avec le bouton droit et en sélectionnant '''Déplacer >''' ou '''Fractionner >''' à gauche, à droite, en haut ou en bas de l'EDI. Pour de plus amples informations, voir [[Split Editor|Fractionnement de l'éditeur]].

Vous pouvez modifier le comportement de l'onglet (comme le bouton Fermer ou la fermeture automatique des onglets) ou l'affichage des couleurs sur la page de l'onglet [[IDE Options|Options de l'EDI]].

==Utilisation d'une fiche==

{{f|webdocs|En général, une fiche représente une fenêtre ou une page HTML dans l'interface utilisateur que vous concevez.|En général, une fiche représente une fenêtre dans l'interface utilisateur que vous concevez.}} Au moment de la conception, une fiche est affichée sur la surface du concepteur. Ajoutez des composants de la '''[[Palette d'outils|Palette d'outils]]''' sur la fiche pour créer votre interface utilisateur.

{{Variables|Product}} propose une bibliothèque enrichie de fiches, comme décrit dans la section suivante. Sélectionnez la fiche la plus adaptée à la conception de votre application, qu'il s'agisse d'une application Web proposant des fonctionnalités de logique métier via le Web ou une application Windows proposant le traitement et l'affichage performant de contenu. Pour naviguer entre le concepteur et '''[[Editeur de code|l'éditeur de code]]''', cliquez sur leur onglet respectif en bas de l'EDI.

Pour accéder aux fiches, choisissez '''Fichier > Nouveau > Autre'''.
{{f|vcl|2=

===Fiches VCL===

Utilisez {{Variables|VCLForms}} pour créer des applications natives utilisant des composants VCL.

Pour créer une application {{Variables|VCLForms}}, choisissez '''Fichier > Nouveau > Autre > [[Windows VCL Application|Application Windows VCL]]'''.

Utilisez ensuite les classes de composants VCL pour créer votre application. Pour parcourir la bibliothèque VCL, voir [[lib_fr:Main Page|Référence VCL]].
}}

==Concepteur de fiches==

Le '''[[Concepteur de fiches|Concepteur de fiches]]''', ou le concepteur, est affiché automatiquement dans le volet central quand vous utilisez une fiche. L'apparence et les fonctionnalités du concepteur dépendent du type de fiche que vous utilisez. {{f|webdocs|Par exemple, si vous utilisez une fiche Web, le concepteur affiche un éditeur de balise HTML.}} Pour accéder au concepteur, cliquez sur l'onglet '''Conception''' en bas de l'EDI.

===Composants visuels===

Les composants visuels apparaissent dans la fiche lors de la conception et sont visibles pour l'utilisateur final à l'exécution. Ce sont les boutons, les libellés, les barres d'outils et les zones de liste.
{{f|vcl|2=

===Aperçu d'une fiche [[File:FormPreview.png]]===

Une icône d'aperçu en bas à droite du concepteur (pour les fiches VCL) présente le positionnement de votre fiche sur l'écran à l'exécution. Vous pouvez ainsi positionner les fiches de votre application les unes en fonction des autres, au fur et à mesure que vous les concevez. Lorsque vous déplacez la fiche dans la fenêtre d'aperçu, les coordonnées x,y du coin supérieur gauche de la fiche sont affichées. Par exemple, "0,0" représente le coin supérieur gauche de l'écran.

===Concepteur HTML===

Utilisez le '''concepteur HTML''' pour visualiser et modifier les fiches Web ou les pages HTML. Ce concepteur comporte un '''Editeur de balise''' pour modifier les balises HTML avec la représentation visuelle de la fiche ou de la page. Vous pouvez aussi utiliser '''l'inspecteur d'objets''' pour modifier les propriétés des éléments visibles de la page HTML et afficher les propriétés de la balise HTML en cours dans '''l'éditeur de balise'''. Une boîte à options située au-dessus de '''l'éditeur de balise''' vous permet d'afficher et de modifier les balises SCRIPT.

Pour créer un nouveau fichier HTML, choisissez {{Menu|Fichier > Nouveau > Autre > Web > Page HTML}.
}}

===Directives de conception===

Si vous créez un composant pour une fiche, vous pouvez enregistrer un type d'objet, puis indiquer différents points sur ses limites, ou proches d'elles, qui constitueront des points "d'alignement". Ces points d'alignement sont des traits verticaux ou horizontaux qui traversent les limites d'un contrôle virtuel.

Quand les points d'alignement sont en place, vous pouvez fournir les informations sur les directives de l'UI de façon à ce que chaque composant respecte les prescriptions s'appliquant, par exemple, à la distance entre les contrôles, aux raccourcis, aux libellés prenant la focalisation, à l'ordre de tabulation, au nombre maximal d'éléments (zones de liste, menus), et ainsi de suite. De cette façon, le '''Concepteur de fiches''' peut assister le développeur de code dans l'adhésion aux directives établies sur l'UI.

Si l'option '''Accrocher à la grille''' est activée (sur {{Menu|Outils > Options > Interface utilisateur > [[Options du Concepteur de fiches|Concepteur de fiches]]}}), ainsi que '''Utiliser les directives du concepteur''', les directives du concepteur sont prioritaires. Cela signifie que si un point de la grille se trouve dans la tolérance du nouvel emplacement et qu'une directive se trouve également dans le voisinage, le contrôle respecte la directive et non la position sur la grille, même si la directive ne coïncide pas avec la position sur la grille. La tolérance d'alignement est déterminée par la taille de la grille. Même si les options '''Accrocher à la grille''' et '''Afficher la grille''' sont désactivées, le Concepteur détermine la tolérance en fonction de la taille de la grille.

==Palette d'outils==

La '''[[Palette d'outils|Palette d'outils]]''', située sur la colonne de droite, contient des éléments qui vous permettent de développer votre application. Les éléments affichés dépendent de la vue en cours. Par exemple, si vous affichez une fiche sur le concepteur, la '''palette d'outils''' affiche les composants appropriés à cette fiche. Double-cliquez sur un contrôle pour l'ajouter à votre fiche. Vous pouvez aussi le faire glisser vers une position désirée de la fiche. Si vous visualisez du code dans '''l'éditeur de code''', la '''palette d'outils''' affiche des segments de code que vous pouvez ajouter à votre application.

===Composants personnalisés===

Outre les composants qui sont installés avec {{Variables|Product}}, vous pouvez ajouter des composants personnalisés ou tiers à '''la palette d'outils''' et les enregistrer dans leur propre catégorie.

===Templates de composants===

Vous pouvez créer des templates composés d'un ou de plusieurs composants. Après avoir organisé les composants sur une fiche, défini leurs propriétés et écrit du code pour eux, vous pouvez les enregistrer sous la forme d'un template de composant. Par la suite, en sélectionnant le template dans '''la palette d'outils''', vous pouvez placer les composants préconfigurés sur une fiche en une seule étape ; toutes les propriétés et tout le code de gestion d'événement associés sont simultanément ajoutés à votre projet. Vous pouvez repositionner les composants indépendamment les uns des autres, réinitialiser leurs propriétés, et créer ou modifier des gestionnaires d'événements comme si vous aviez positionné chaque composant séparément.
{{f|componenttoolbar|2=

==Barre d'outils des composants==

La '''[[Barre d'outils des composants|Barre d'outils des composants]]''' contient toutes les catégories et tous les composants qui apparaissent sur la '''palette d'outils''' régulière (Standard, Accès aux données, et ainsi de suite). Toutefois, la '''barre d'outils des composants''' affiche les catégories de composants sous la forme d'un ensemble d'onglets situé sur la barre d'outils au sommet de la fenêtre de l'EDI, similaire à {{Delphi|7}} {{Version|7}} et {{CBuilder|6}} {{Version|6}}. Cliquez sur un onglet de la barre d'outils des composants pour afficher les icônes des composants de cette catégorie. Cliquez ensuite sur une icône pour sélectionner un composant.

Quand la '''barre d'outils des composants''' est activée, la '''palette d'outils''' est aussi disponible, et vous pouvez utiliser la '''barre d'outils des composants''' ou la '''palette d'outils''' pour ajouter des composants à votre application. Voir [[Activation de la barre d'outils des composants|Activation de la barre d'outils des composants]].

Pour de plus amples informations sur les différentes barres d'outils disponibles dans l'EDI, voir '''[[Barres d'outils|Barres d'outils]]'''.
}}

==Inspecteur d'objets==

'''[[Inspecteur d'objets|L'inspecteur d'objets]]''', situé sur la gauche, vous permet de définir les propriétés de conception et de créer des gestionnaires d'événements pour vos composants. Il fournit la connexion entre l'apparence visuelle de votre application et le code qui lui permet de fonctionner. '''L'inspecteur d'objets''' contient deux onglets : '''Propriétés''' et '''Evénements'''.

Utilisez l'onglet '''Propriétés''' pour modifier les attributs physiques des composants. Selon votre sélection, certaines catégories d'options vous permettent d'entrer une valeur dans une zone de texte, alors que d'autres attendent que vous sélectionniez une valeur dans une liste déroulante. Pour les opérations booléennes, vous passez de True à False, et vice-versa. Après avoir modifié les attributs physiques de vos composants, vous créez des gestionnaires d'événements qui gèrent les composants.

Utilisez l'onglet '''Evénements''' pour spécifier les événements d'un objet spécifique que vous sélectionnez. S'il existe un gestionnaire d'événement, utilisez la liste déroulante pour le sélectionner. Par défaut, certaines options de '''l'inspecteur d'objets''' sont repliées. Pour développer les options, cliquez sur le signe plus (+) en regard de la catégorie.

Certains composants non visuels, comme les fournisseurs de données Borland offrent un accès rapide à des éditeurs comme '''l'éditeur de connexion''' et '''l'éditeur de texte de commande'''. Vous pouvez accéder à ces éditeurs dans la zone '''Verbe du concepteur''' en bas de '''l'inspecteur d'objets'''. Pour ouvrir les éditeurs, placez votre curseur sur le nom de l'éditeur jusqu'à ce que le curseur prenne la forme d'une main et l'éditeur se change en un lien. Vous pouvez aussi cliquer avec le bouton droit sur le composant non visuel et défiler jusqu'à l'éditeur associé et le sélectionner. Sachez que les composants non visuels n'ont pas tous d'éditeur associé. En plus des éditeurs, cette zone peut aussi afficher des hyperliens pour montrer des éditeurs de composants personnalisés, lancer une page web et afficher des boîtes de dialogue.

==Référentiel d'objets==

Pour simplifier le développement, {{Variables|Product}} propose des templates prédéfinis, des fiches et d'autres éléments auxquels vous avez accès et que vous pouvez utiliser dans vos applications.

===Contenu du référentiel d'objets===

Le '''[[Référentiel d'objets|Référentiel d'objets]]''' contient des éléments qui correspondent aux types d'applications que vous pouvez développer. Il contient des templates, des fiches et bien d'autres éléments. Vous pouvez créer des projets tels qu'une bibliothèque de classes, une bibliothèque de contrôles, des applications console et autres en accédant aux templates disponibles.

Pour ouvrir le '''référentiel d'objets''', choisissez '''Fichier > Nouveau > Autre'''. La boîte de dialogue '''Nouveaux éléments''' affiche le contenu du '''référentiel d’objets'''. Vous pouvez aussi modifier ou retirer des objets existants du '''référentiel d'objets''' en cliquant avec le bouton droit dans le '''référentiel d'objets''' afin d'afficher les options d'édition.

===Templates du référentiel d'objets===

Vous pouvez ajouter vos propres objets au '''référentiel d'objets''' en tant que templates que vous réutilisez ou partagez avec d'autres développeurs. La réutilisation d'objets vous permet de concevoir des familles d'applications ayant une interface utilisateur et des fonctionnalités communes, afin de réduire les temps de développement et d'améliorer la qualité.

Vous pouvez ajouter dans le '''référentiel d'objets''' un projet de démarrage, une démo, un template ou tout autre fichier utile et le rendre accessible depuis le menu Nouveau. Choisissez '''Projet > Ajouter au référentiel'''. Sélectionnez votre fichier. Ensuite, lorsque vous sélectionnez la commande '''Fichier > Nouveau''', vous pouvez choisir le fichier que vous venez d'ajouter et en utiliser un nouvel exemplaire.

{{Variables|Product}} vous permet de créer plusieurs bibliothèques de templates personnalisées servant de base à la création de futurs projets. Les bibliothèques de templates vous permettent de définir l'apparence des projets et d'ajouter de nouveaux types de projets dans le '''référentiel d'objets'''.

==Gestionnaire de projets==

Un '''projet''' est constitué de plusieurs fichiers d'application. La '''[[Fenêtre Projets|Fenêtre Projets]]''', située dans la colonne supérieure droite, permet de visualiser et d'organiser les fichiers de votre projet, comme les fiches, les exécutables, les assemblages, les objets et les fichiers bibliothèque. Dans le '''Gestionnaire de projets''', vous pouvez ajouter, retirer et renommer des fichiers en utilisant la barre d'outils ou le menu contextuel. Vous pouvez même appeler la boîte de dialogue Options de projet depuis le menu contextuel du '''Gestionnaire de projets'''.

===Groupes de projets===

Vous pouvez combiner des projets associés pour former un '''groupe de projets'''. Pour ce faire, cliquez avec le bouton droit sur le noeud groupe de projets par défaut ([[File:Project Group.png]]) dans le '''Gestionnaire de projets''' et sélectionnez '''[[Ajouter un nouveau projet|Ajouter un nouveau projet]]''' ou '''Ajouter un projet existant'''. La liaison de plusieurs projets en un groupe de projets vous permet de compiler le groupe de projets entier en une seule fois. Mais vous pouvez aussi compiler tout projet unique en cliquant avec le bouton droit sur un noeud de projet et en sélectionnant une des commandes de compilation ou de construction sur le menu contextuel.

Après la création délibérée d'un groupe de projets, vous êtes invité à enregistrer le fichier <code>.groupproj</code> quand vous quittez l'EDI ou entrez une commande d'enregistrement pour un des projets inclus. Vous pouvez aussi enregistrer explicitement un groupe de projets en utilisant les commandes du menu contextuel.

==Explorateur de données==

'''[[Explorateur de données|L'explorateur de données]]''' permet de parcourir des objets de schéma spécifiques au serveur de base de données, notamment les tables, les champs, les définitions de procédures stockées, les déclencheurs et les index. Les menus contextuels vous permettent de créer et de gérer les connexions aux bases de données. Vous pouvez aussi faire glisser et déposer des données depuis une source de données vers la plupart des fiches pour construire rapidement votre application de base de données.

==Vue Structure==

La '''[[Vue Structure|Vue Structure]]''' présente la hiérarchie du code source ou le langage HTML affiché dans '''l'éditeur de code''', ou les composants affichés sur le concepteur. Si la vue affiche la structure du code source ou le langage HTML, vous pouvez double-cliquer sur un élément pour accéder à sa déclaration ou à son emplacement dans '''l'éditeur de code'''. Si la vue affiche des composants, vous pouvez double-cliquer sur un composant pour le sélectionner sur la fiche.

Si votre code contient des erreurs de syntaxe, elles s'affichent dans le dossier '''Erreurs''' de la vue '''Structure'''. Double-cliquez sur une erreur pour localiser sa source dans '''l'éditeur de code'''.

Vous pouvez contrôler le contenu et l'aspect de la '''vue Structure''' en choisissant {{Menu| Outils > Options > Interface utilisateur > [[Structure|Structure]]}}, puis en modifiant les paramètres.

==[[Smart CodeInsight|Fenêtre de chat IA]]==

La fenêtre de chat IA est une fiche ancrable de l'EDI, qui fonctionne comme n'importe quelle fenêtre de chat LLM. Vous pouvez taper une requête, choisir un moteur et attendre la réponse.

Pour pouvoir utiliser cette fonctionnalité, vous devez toutefois l'activer dans l'option [[Smart CodeInsight Options|Audit de code intelligent]].

==Gestionnaire de l'historique==

Le '''[[Gestionnaire de l'historique|Gestionnaire de l'historique]]''', situé dans le volet central, vous permet de voir et de comparer les versions d'un fichier, y compris les diverses versions sauvegardées, les modifications enregistrées localement et le tampon mémoire des modifications non enregistrées d'un fichier actif. Si le fichier en cours est sous contrôle de version, tous les types des révisions sont disponibles dans le '''gestionnaire de l'historique'''.

'''[[Intégration de Subversion dans l'EDI|L'intégration de Subversion dans l'EDI]]''' est implémentée sur le '''gestionnaire de l'historique''', qui affiche les informations Subversion chaque fois qu'elles sont disponibles dans le système de fichiers.

Le '''gestionnaire de l'historique''' se trouve à droite de l'onglet '''Code''' et contient les pages à onglets suivantes :

* La page '''Contenu''' affiche les versions actuelle et précédente du fichier.
* La page '''Diff''' affiche les différences entre les versions sélectionnées du fichier.
* La page '''Info''' affiche tous les libellés et commentaires associés au fichier actif.

Vous pouvez utiliser la barre d'outils du '''gestionnaire de l'historique''' pour actualiser les informations de révision, rétablir une version sélectionnée à la version la plus actuelle et synchroniser le défilement entre les visualiseurs source de la page '''Contenu''' ou '''Diff''', et '''l'éditeur de code''', et pour la navigation de fenêtre (comme Aller à la différence suivante).

==Editeur de code==

'''[[Editeur de code|L'éditeur de code]]''', situé dans le volet central, propose un moyen pratique de visualiser et de modifier le code source. C'est un éditeur UTF8 complet et personnalisable qui comprend entre autres les sauvegardes automatiques, l'audit de code, la mise en surbrillance syntaxique, de multiples capacités d'annulation, l'aide contextuelle, les templates dynamiques, la saisie semi-automatique de blocs (achèvement de bloc), la recherche de classe, la recherche d'unités et l'importation d'un espace de nommage.

==Débogueur==

Les débogueurs intégrés vous permettent de trouver et de corriger les erreurs d'exécution et de logique dans votre application {{Variables|Product}}. En utilisant les débogueurs, vous pouvez parcourir le code pas à pas, définir des points d'arrêt et de suivi et inspecter ou modifier les valeurs du programme. Quand vous déboguez votre application, les [[Fenêtres de débogage - Index|fenêtres de débogage]] sont disponibles pour vous aider à gérer la session de débogage et vous donnent des informations sur l'état de votre application.

==Voir aussi==

* [[Aperçu et page d'accueil|Aperçu et page d'accueil]]
* [[Référence EDI et utilitaires|Référence EDI et utilitaires]]
* [[Démarrage d'un projet - Présentation|Démarrage d'un projet - Présentation]]
* [[Enregistrement des dispositions du bureau|Enregistrement des dispositions du bureau]]
* [[Concepteur de fiches|Concepteur de fiches]]
* [[Ajout de composants à une fiche|Ajout de composants à une fiche]]
* [[Définition des propriétés et des événements|Définition des propriétés et des événements]]
* [[Editeur de code|Editeur de code]]
* [[Personnalisation de l'éditeur de code|Personnalisation de l'éditeur de code]]
*[[Split Editor|Fractionnement de l'éditeur]]
* [[Débogage des applications - Index|Débogage des applications]]
* [[Utilisation du Gestionnaire de l'historique|Utilisation du Gestionnaire de l'historique]]
* [[Rubriques de l'explorateur de classes Delphi|Rubriques de l'explorateur de classes Delphi]]
* [[Rubriques de l'explorateur de classes C++|Rubriques de l'explorateur de classes C++]]

[[Category:Prise en main]]
[[Category:AMMigrate]]

Prise en charge de ToolsAPI pour l'éditeur de code

2025-05-28T09:34:20Z

Yukikoi : 1 révision importée : LOC-23438

{{Parent|Extension de l'EDI par l'utilisation de l'API Tools}}

A partir de {{Product}} 11.3, les utilisateurs disposent d'un ensemble complet d'outils API (ToolsAPI) pour personnaliser l'éditeur de code (opérations Paint, demande d'informations, obtention d'événements pour l'éditeur de code, etc.).

==Comment les utiliser==

Des plugins très pratiques et intéressants fonctionnent désormais depuis l'éditeur. Nous souhaitons par conséquent fournir une API complète qui stimulera l'innovation et facilitera l'écriture de plugins qui réaliseront des tâches auxquelles nous n'avons même pas pensé.

Ces API permettent aux utilisateurs d'intercepter toutes les étapes du rendu visuel dans l'éditeur (ligne, gouttière, texte). Des événements sont appelés avant et après chaque étape pour que les éléments créés viennent s'ajouter à ce qui existe déjà dans l'EDI ou viennent remplacer des éléments existants (en empêchant l'EDI d'afficher ce qui s'affiche habituellement par défaut).

Vous pouvez obtenir la liste complète des éditeurs, des vues d'édition et établir des correspondances entre eux. Les utilisateurs peuvent lancer des requêtes sur l'état d'un éditeur ou bien lancer des requêtes sur l'état de chaque ligne. Les événements Paint incluent le contexte entier. Utilisez-les pour les opérations de dessin dans l'éditeur ou pour obtenir des informations sur les éditeurs et les éléments qu'ils contiennent, même en dehors de toute opération de dessin.

==Concepts fondamentaux==

Le texte/code est stocké dans le tampon de l'éditeur (IOTAEditView.Buffer fournit un [[lib_fr:ToolsAPI.IOTAEditBuffer|IOTAEditBuffer]]). Une vue ([[lib_fr:ToolsAPI.IOTAEditView|IOTAEditView]]) représente une fenêtre d'affichage sur ce tampon. Elle est utilisée par un contrôle d'éditeur (le contrôle VCL qui implémente l'éditeur). Il n'y a qu'un seul tampon pour le contenu d'un fichier, mais les utilisateurs peuvent utiliser plusieurs vues pour y accéder et le modifier, ce qui entraîne l'ouverture de nombreuses fenêtres d'éditeur du même fichier. Chaque contrôle d'éditeur correspond à une vue, et vice-versa.

===Numéros de ligne de l'éditeur et numéros de ligne logique===

Il ne faut pas confondre les numéros de ligne de l'éditeur et les numéros de ligne logique. La différence est importante lorsque des lignes sont élidées (repliées). Dans l'EDI, le terme <code>élidé</code> désigne du code replié. Un éditeur peut contenir de nombreuses lignes visibles à l'écran, mais au point de pliage, les numéros de ligne de l'éditeur et les numéros de ligne logique divergent, de sorte que le point de pliage se retrouve en dehors de l'écran.

Les lignes logiques sont des numéros de ligne "réels".

Les lignes de l'éditeur sont celles qui sont affichées dans l'éditeur ou qui le seraient si vous faisiez défiler l'éditeur.

Par exemple, dans un fichier comportant dix lignes (lignes logiques), les lignes 4-7 étant repliées/élidées, les lignes logiques vont jusqu'à dix, mais les lignes de l'éditeur vont jusqu'à sept (pour les sections élidées, une ligne est toujours présente). Les lignes visibles correspondent à celles effectivement affichées à l'écran dans l'éditeur. En raison du pliage, ces lignes peuvent être un sous-ensemble des lignes dans le tampon. Par conséquent, les lignes visibles de l'éditeur sont toujours continues, mais les numéros de ligne logique peuvent avoir des intervalles et comporter des sauts aux points de pliage.

Il est possible de convertir un numéro de ligne logique en numéro de ligne de l'éditeur en utilisant l'état d'une ligne. Les deux types de numérotation peuvent être utilisés pour interroger l'état. Vous obtenez ainsi l'état de la ligne logique ou de la ligne de l'éditeur, et pouvez lui demander à quelle ligne logique ou ligne de l'éditeur il correspond.

==Services de l'éditeur de code==

Le point de départ est l'interface [[lib_fr:ToolsAPI.Editor.INTACodeEditorServices280|INTACodeEditorServices]]. Cette interface vous permet de :

* Vous inscrire aux événements de l'éditeur, tels que : souris, défilement, redimensionnement et dessin.
* Rechercher la vue d'un contrôle d'éditeur et le contrôle d'éditeur qui lui est associé. Il n'y a qu'un seul tampon, mais plusieurs vues de ce tampon peuvent exister, et chaque contrôle d'éditeur utilise une seule vue.
* Lister tous les contrôles de l'éditeur et toutes les vues d'édition.
* Obtenir le contrôle d'éditeur supérieur (le dernier avec lequel vous avez interagi).
* Obtenir l'état de l'éditeur pour un contrôle. Vous pouvez obtenir l'état de n'importe quelle ligne à partir de l'état de l'éditeur.
* Obtenir diverses informations concernant l'éditeur.
* Réserver une partie de la gouttière de l'éditeur à l'usage de vos plugins.
* Accéder à [[lib_fr:ToolsAPI.Editor.INTACodeEditorServices280|INTACodeEditorServices]] à partir de <code>BorlandIDEServices</code> comme avec les autres interfaces.
* Invalider (c'est-à-dire forcer le rafraîchissement) des parties d'un éditeur : par ligne logique, pour un rectangle ou l'intégralité de l'éditeur.

{{Note| En général, l'éditeur met en cache et redessine uniquement les lignes récemment affichées dans la vue ou celles affectées par un changement de ligne. La sollicitation excessive du rafraîchissement peut entraîner des problèmes de performance.}}

==Optimiser les opérations de lecture et d'écriture de l'éditeur de code==

===Lecture à partir du tampon de l'éditeur===

Utilisez l'interface <code>IOTAEditReader</code> pour lire depuis le tampon de l'éditeur. Cette API de bas niveau est très performante. Elle permet un accès direct au contenu de l'éditeur. Si vous devez analyser le code par l'intermédiaire de chaînes basées sur des pointeurs, vous pouvez le faire sans allocation ni copie de chaînes.

Pour obtenir le contenu du tampon de l'éditeur pour un ensemble de lignes, appelez <code>GetLineData</code>, en transmettant le numéro de la première ligne, le numéro de la dernière ligne, le rappel et un pointeur arbitraire qui peut représenter n'importe quelle donnée de votre choix, qui sera transmise telle quelle au rappel. Cette méthode est utilisée pour pointer sur une instance d'objet afin de la convertir en méthode orientée objet dans le rappel.

Le rappel obtient le numéro de la ligne, le pointeur inchangé transmis et un pointeur vers les informations de la ligne. Cette structure d'informations contient la longueur de la ligne, le type de fin de ligne (une énumération représentant <code>CRLF</code>, seulement <code>CR</code>, seulement <code>LF</code>, etc.) et un pointeur sur la chaîne ligne.

La chaîne ligne est au format UTF8 sans caractère de fin nul et sans octets de fin de ligne. Il s'agit simplement d'un pointeur direct vers le contenu de la ligne dans la mémoire du tampon de l'éditeur.

{{Attention| N'écrivez pas dans ce pointeur et ne modifiez en aucune façon son contenu. Cela altérerait le tampon de l'éditeur. Utilisez-le uniquement pour lire la mémoire, par exemple pour analyser ou copier une chaîne. Le pointeur n'est pas vivant en dehors du contexte du rappel ; ne stockez pas le pointeur et utilisez-le ultérieurement.}}

L'interface <code>IOTAEditReader</code> vous permet de :

* Obtenir le nombre de lignes dans le tampon via la propriété <code>LinesInBuffer</code>.

* Obtenir les données d'une seule ligne ou d'une série de lignes en utilisant la procédure suivante :

<source lang="delphi">
procedure GetLineData(AFirstLine: Integer; ARange; Integer;
ACallBack: TOTALineDataCallback; AUserData: Pointer);</source>

* L'obtention des données d'une ligne requiert un rappel tel que :

<source lang="delphi">
TOTALineDataCallback = procedure(ALine: Longint; ALineInfo:
POTALineInfo; AUserData: Pointer)</source>

Vous pouvez également effectuer des tâches comme calculer le nombre de lignes sans transférer ni analyser la totalité du tampon (ce qui était obligatoire avec la précédente API), ainsi que calculer la taille du tampon en octets, là encore sans streaming.

===Ecrire à partir du tampon de l'éditeur===

Voici différentes méthodes pour écrire dans le tampon de l'éditeur :

* <code>IOTAEditWriter</code> : une interface qui fournit une API de type flux avec une position, puis permet de copier, d'insérer, de supprimer, etc. des primitives. Cette méthode requiert la rationalisation du texte de l'éditeur pour les opérations à implémenter.
* <code>Insert()</code> : surcharges prenant un UTF8String. Cette méthode est davantage orientée numéros de lignes.

Méthodes plus performantes :

* <code>InsertBlankLine</code> : insère une ligne vide à un numéro de ligne spécifique.
* <code>InsertLine</code> : insère une ligne à un numéro de ligne spécifique. Cette méthode amène un pointeur vers un contenu UTF8 ou UTF8String et insère ce contenu dans la nouvelle ligne.
* <code>DeleteLine</code> : supprime une ligne à un numéro de ligne spécifique.
* <code>ReplaceLine</code> : remplace une ligne à un numéro de ligne spécifique avec un pointeur sur un contenu UTF8 ou UTF8String.

{{Note|D'autres primitives d'écriture sont disponibles via <code>IOTAEditPosition</code>. Ces primitives sont plus proches de la façon dont un humain interagit avec l'éditeur ; leurs performances sont raisonnablement élevées et elles sont une alternative à <code>IOTAEditWriter</code>.}}

==Evénements de l'éditeur de code==

Recensez une instance de l'interface de notification [[lib_fr:ToolsAPI.Editor.INTACodeEditorEvents|INTACodeEditorEvents]] en utilisant [[lib_fr:ToolsAPI.Editor.INTACodeEditorServices280.AddEditorEventsNotifier|AddEditorEventsNotifier]]. Cela vous permet d'être notifié lorsqu'une grande variété d'événements se produisent, notamment des événements en lien avec la souris, les fenêtres, les changements d'état de l'éditeur et le dessin.

===Considérations à prendre en compte pour les performances===

De nombreux événements se produisent pendant que l'utilisateur interagit avec l'éditeur. Pour optimiser les performances, le notificateur ne vous informe que des types d'événements pour lesquels vous avez demandé à recevoir des notifications. Pour ce faire, implémentez {{code|AllowedEvents}}, qui renvoie un ensemble d'événements (souris, fenêtre, etc.) pour lesquels vous souhaitez être averti. Par exemple, pour recevoir des notifications à propos des événements de la souris, {{code|AllowedEvents}} doit renvoyer un ensemble incluant {{code|cevMouseEvents}}. Tous les événements en relation avec la souris (enfoncement du bouton de la souris, déplacement de la souris, relâchement du bouton de la souris) sont ainsi renvoyés. Il n'est pas possible de s'abonner à un événement spécifique, seulement à des types d'événements regroupés.

Si possible, limitez les notifications en ne surveillant que les types d'événements dont vous avez besoin. En effet, une surabondance de notifications peut entraîner des problèmes de performances. De même, assurez-vous que les méthodes qui gèrent les événements sont aussi légères que possible et effectuent un minimum d'opérations. Chaque fois que possible, différez les processus longs (par exemple, en utilisant {{code|TThread.ForceQueue}} pour exécuter une méthode ultérieurement). Un traitement long pendant la gestion des événements engendrera un décalage lors de la saisie, un ralentissement du dessin ou d'autres effets similaires.

Les méthodes d'optimisation suivantes permettent de réduire la sur-notification.

* [[lib_fr:ToolsAPI.Editor.INTACodeEditorEvents.AllowedEvents|AllowedEvents]] : renvoie les événements auxquels le plugin s'intéresse.
* [[lib_fr:ToolsAPI.Editor.INTACodeEditorEvents.AllowedGutterStages|AllowedGutterStages]] et [[lib_fr:ToolsAPI.Editor.INTACodeEditorEvents.AllowedLineStages|AllowedLineStages]] : masques similaires pour les étapes du dessin (gouttière, ligne et texte) durant lesquelles vous souhaitez que votre plugin soit appelé.

Pour éviter un impact sur les performances, utilisez le résultat de ces méthodes pour vous assurer que votre plugin est uniquement appelé pour les événements nécessaires.

===Evénements des fenêtres===

Les API suivantes vous permettent de vérifier si un élément devrait se trouver sur l'écran de l'éditeur. Vous pouvez demander la nouvelle taille de l'éditeur en utilisant les propriétés TWinControl Width et Height de l'éditeur, comme pour n'importe quel composant visuel normal.

* Redimensionnez l'éditeur avec [[lib_fr:ToolsAPI.Editor.INTACodeEditorEvents.EditorResized|EditorResized]].
* Faites défiler l'éditeur avec [[lib_fr:ToolsAPI.Editor.INTACodeEditorEvents.EditorScrolled|EditorScrolled]].

Ces événements sont uniquement appelés lorsque cevWindowEvents est renvoyé dans AllowedEvents.

===Evénements de la souris===

Les événements de la souris permettent aux utilisateurs d'implémenter des éléments interactifs à l'intérieur de l'éditeur. Ils incluent :

*[[lib_fr:ToolsAPI.Editor.INTACodeEditorEvents.EditorMouseDown|EditorMouseDown]]
*[[lib_fr:ToolsAPI.Editor.INTACodeEditorEvents.EditorMouseUp|EditorMouseUp]]
*[[lib_fr:ToolsAPI.Editor.INTACodeEditorEvents.EditorMouseMove|EditorMouseMove]]

Ces événements sont uniquement appelés lorsque cevMouseEvents est renvoyé dans AllowedEvents.

===Evénements de changement d'état===

Les événements de changement d'état se produisent quand des lignes sont élidées ou réaffichées et indiquent sur quelle ligne cela se produit.

*[[lib_fr:ToolsAPI.Editor.INTACodeEditorEvents.EditorElided|EditorElided]]
*[[lib_fr:ToolsAPI.Editor.INTACodeEditorEvents.EditorUnElided|EditorUnElided]]

===Evénements de dessin===

Il existe plusieurs méthodes de dessin : pour dessiner une ligne, le texte de la ligne et la gouttière de l'éditeur. Le dessin est basé sur des lignes. Il suit le modèle interne de l'éditeur, qui ne permet pas de dessiner quelque chose qui n'est pas associé à une ligne, même si c'est possible en dessinant un rectangle dans chaque ligne.

Pour chacun de ces trois éléments (gouttière, ligne, texte), les méthodes :

* Sont appelées plusieurs fois : une par étape du dessin, avant et après cette étape.
** L'étape du dessin inclut le début et la fin (c'est-à-dire avant et après le dessin), l'arrière-plan de la ligne, le balisage général, les paires en surbrillance, la marge droite et les indicateurs de ligne repliée.
* Sont transmises avec le contexte, qui donne accès au rectangle de dessin, au canevas, au numéro de ligne, au numéro de ligne logique, au nom de fichier, au contrôle et à la vue d'édition. Elles permettent également de demander l'état des lignes et de l'éditeur.
* Peuvent empêcher l'EDI de gérer une étape de dessin qu'elle gère normalement par défaut. Si plusieurs plugins sont impliqués dans le dessin, vous ne pouvez pas empêcher les autres plugins d'effectuer le dessin.

====Méthodes Paint====

L'interface [[lib_fr:ToolsAPI.Editor.INTACodeEditorEvents|INTACodeEditorEvents]] inclut les méthodes de dessin suivantes :

*[[lib_fr:ToolsAPI.Editor.INTACodeEditorEvents.BeginPaint|BeginPaint]] et [[lib_fr:ToolsAPI.Editor.INTACodeEditorEvents.EndPaint|EndPaint]] : ces méthodes sont appelées avant et après l'intégralité des opérations Paint dans l'éditeur. '''BeginPaint''' force un rafraîchissement complet du dessin de l'éditeur.
** Ces méthodes sont uniquement appelées lorsque <code>cevBeginEndPaintEvents</code> est renvoyé dans <code>AllowedEvents</code>.
*[[lib_fr:ToolsAPI.Editor.INTACodeEditorEvents.PaintGutter|PaintGutter]] : utilisez cette méthode pour dessiner la gouttière de l'éditeur.
** Cette méthode est uniquement appelée lorsque <code>cevPaintGutterEvents</code> est renvoyé dans <code>AllowedEvents</code>.
*[[lib_fr:ToolsAPI.Editor.INTACodeEditorEvents.PaintLine|PaintLine]] : il s'agit de la méthode générale pour dessiner une ligne. Une utilisation courante de cette méthode consiste à modifier le dessin de l'arrière-plan ou à ajouter un balisage supplémentaire une fois le texte dessiné.
** Cette méthode est uniquement appelée lorsque <code>cevPaintLineEvents</code> est renvoyé dans <code>AllowedEvents</code>.
*[[lib_fr:ToolsAPI.Editor.INTACodeEditorEvents.PaintText|PaintText]] : cette méthode est appelée lorsque le contenu du code (c'est-à-dire le texte) est dessiné dans une ligne de l'éditeur. Appelez-la pour chaque segment de texte logique, par exemple chaque symbole ou commentaire. Les paramètres fournissent également des informations sur le numéro de la colonne dans laquelle le texte est dessiné, sur le texte lui-même, sur la mise en évidence de la syntaxe et indique si le texte est sélectionné. Etant donné que, comme pour toutes les méthodes, cela peut empêcher le dessin de l'EDI, cette méthode peut être utilisée pour modifier le formatage du code de l'EDI.
** Cette méthode est uniquement appelée lorsque <code>cevPaintTextEvents</code> est renvoyé dans <code>AllowedEvents</code>.

====Evénements de recensement et étapes de dessin====

Comme ces méthodes peuvent être utilisées de manière très granulaire (dans de nombreuses étapes de dessin, avant et après le traitement de l'EDI, pour les trois différentes zones de dessin), cela peut avoir un impact sur les performances pendant le dessin. Ce problème peut être réglé en s'abonnant à un sous-ensemble granulaire d'événements , qui correspond aux méthodes qui seront appelées. Implémentez [[lib_fr:ToolsAPI.Editor.INTACodeEditorEvents.AllowedEvents|AllowedEvents]] pour renvoyer les événements à appeler.

Ensuite, ces événements peuvent être appelés pour plusieurs étapes du processus de dessin. Là encore, vous devez spécifier à quelles étapes les appeler pour des raisons d'optimisation. Implémentez [[lib_fr:ToolsAPI.Editor.INTACodeEditorEvents.AllowedGutterStages|AllowedGutterStages]] pour renvoyer les étapes du dessin de la gouttière de l'éditeur pour lesquelles vous voulez être averti et [[lib_fr:ToolsAPI.Editor.INTACodeEditorEvents.AllowedLineStages|AllowedLineStages]] pour les étapes du dessin d'une ligne pour lesquelles vous voulez être averti. PaintText n'implique pas plusieurs étapes.

==Etat de l'éditeur==

L'interface [[lib_fr:ToolsAPI.Editor.INTACodeEditorState|INTACodeEditorState]] permet à l'utilisateur d'obtenir des informations sur les éléments affichés pour un éditeur spécifique, notamment :

* Le rectangle de l'éditeur.
* La taille de la gouttière.
* Le bord gauche où le code est dessiné.
* Le composant de l'éditeur de code (comme un TWinControl) et la vue d'édition utilisée.
* Les lignes inférieure et supérieure visibles.
* Les colonnes droite et gauche visibles (défilement horizontal).
* La largeur (en caractères) de la plus grande ligne visible.
* Conversion d'un point en pixels en position de caractère (index et ligne).
* Conversion de la position d'un caractère (index et ligne) en rectangle de délimitation du caractère.
* Demander si une ligne spécifique est visible.
* Demander des informations sur les lignes élidées.
* Obtenir l'état d'une ligne spécifique.

Pour obtenir l'état de l'éditeur, lancez une requête avec [[lib_fr:ToolsAPI.Editor.INTACodeEditorServices280|INTACodeEditorServices]] ou via le paramètre Context dans les méthodes Paint, qui fournit l'état de l'éditeur et des lignes, ainsi que d'autres informations de contexte de dessin. L'état de l'éditeur est créé lorsqu'il est demandé.

==Etat des lignes==

L'interface [[lib_fr:ToolsAPI.Editor.INTACodeEditorLineState|INTACodeEditorLineState]] permet à l'utilisateur de demander des informations pour une ligne spécifique. Vous pouvez obtenir l'état d'une ligne par l'intermédiaire de l'interface [[lib_fr:ToolsAPI.Editor.INTACodeEditorState|INTACodeEditorState]]. Pour n'importe quelle ligne, vous pouvez demander :

* Le numéro de ligne de l'éditeur et le numéro de ligne logique.
* S'il s'agit d'une ligne élidée : la ligne visible représentant une section élidée de lignes, ainsi que le début et la fin de cette section élidée.
* Divers rectangles : la totalité du rectangle de la ligne sur toute la largeur de l'éditeur, le rectangle de la gouttière, le rectangle de balisage de la gouttière (par exemple, l'endroit où les numéros de ligne et les symboles +/- de pliage sont dessinés), le rectangle de la zone du code, un rectangle qui limite le texte.
* Le texte d'une ligne et le sous-ensemble de texte qui est visible pour la ligne.

INTACodeEditorLineState possède désormais une propriété State, qui vous indique si :

* <code>eleLineHighlight</code> : la ligne est en surbrillance.
* <code>eleErrorLine</code> : la ligne contient une erreur.
* <code>eleExecution</code> : la ligne est en cours d'exécution.
* <code>eleBreakpoint</code> : la ligne contient un point d'arrêt.
* <code>eleInvalidBreakpoint</code> : la ligne contient un point d'arrêt non valide.
* <code>eleDisabledBreakpoint</code> : la ligne contient un point d'arrêt désactivé.
* <code>eleCompiled</code> : la ligne a été compilée et peut contenir un point d'arrêt.

Pour obtenir l'état de la ligne, lancez une requête avec [[lib_fr:ToolsAPI.Editor.INTACodeEditorState|INTACodeEditorState]] pour un éditeur spécifique ou via le paramètre Context dans les méthodes Paint, qui fournit l'état de l'éditeur et des lignes, ainsi que d'autres informations de contexte du dessin. L'état de la ligne est créé lorsqu'il est demandé.

INTACodeEditorLineState possède maintenant une propriété CellState, indexée par colonne, qui vous indique si la cellule spécifique a l'un des états suivants :

* <code>eceSelected</code> : la cellule est actuellement sélectionnée.
* <code>eceHotLink</code> : la cellule contient un lien hypertexte actif.
* <code>eceHotLinkable</code> : la cellule prend en charge les liens hypertexte.
* <code>eceSyncEditBackground</code> : la cellule se trouve dans l'arrière-plan d'un groupe d'édition synchronisé.
* <code>eceSyncEditSearch</code> : la cellule fait partie d'un groupe d'édition synchronisé actuellement recherché.
* <code>eceSyncEditMatch</code> : la cellule fait partie d'un groupe d'édition synchronisé qui contient un élément correspondant.
* <code>eceSearchMatch</code> : la cellule est une correspondance pour une requête de recherche.
* <code>eceExtraMatch</code> : la cellule est une correspondance secondaire pour une requête de recherche.
* <code>eceBraceMatch</code> : la cellule est une accolade correspondante ou un crochet correspondant.
* <code>eceHint</code> : la cellule contient un conseil.
* <code>eceWarning</code> : la cellule contient un message d'avertissement.
* <code>eceError</code> : la cellule contient un message d'erreur.
* <code>eceDisabledCode</code> : la cellule contient du code désactivé.
* <code>eceFoldBox</code> : la cellule correspond à une zone qui permet de replier ou déplier une section de code.

==Menu contextuel de l'éditeur==

Les constantes cEdMenuCat répertoriées ci-dessous définissent les différentes catégories de listes d'actions utilisées pour construire le menu local de l'éditeur. <code>INTAEditorLocalMenu</code> permet d'ajouter le menu local de l'éditeur, et ces constantes peuvent être utilisées pour contrôler l'emplacement où une nouvelle liste d'actions est ajoutée.

Voici la liste des actions dans chaque catégorie de menu :

*<code>cEdMenuCatIdentifier</code> : Chercher la déclaration.
*<code>cEdMenuCatBreakPoint</code> : Activé, Propriétés du point d'arrêt.
*<code>cEdMenuCatDebugDebug</code> : Exécuter jusqu'au curseur.
*<code>cEdMenuCatBase</code> : Ouvrir le fichier source/en-tête, Ouvrir le fichier sous le curseur, Rechercher le symbole sous le curseur, Rechercher une rubrique, Vue tampon suivante, Vue tampon précédente, Modification suivante, Modification précédente, Modification non enregistrée suivante, Modification non enregistrée précédente
*<code>cEdMenuCatModule</code> : Ouvrir le fichier source/en-tête, Voir les messages et Afficher dans l'explorateur.
*<code>cEdMenuCatClipboard</code> : Couper, Copier et Coller.
*<code>cEdMenuCatBookMarks</code> : Tous les éléments Aller à et Basculer le signet.
*<code>cEdMenuCatDebug</code> : Déboguer et Exécuter jusqu'au curseur.
*<code>cEdMenuCatDebug</code> : Voir, Message, Lecture seule, Voir comme fiche.
*<code>cEdMenuCatView</code> : Voir comme fiche.
*<code>cEdMenuCatElide</code> : Plier, Commentaires de documentation, Méthodes, Plus proche, Imbriqué, Régions, Espace de nommage, Types, Déplier, Tous, Plus proche.
*<code>cEdMenuCatVersionControl</code> : Tous les éléments de menu liés aux plugins de contrôle de version.
*<code>cEdMenuCatRefactor</code> : Chercher, Chercher les références, Chercher les références locales, Rechercher le symbole de déclaration, Refactoring.
*<code>cEdMenuCatFormat</code> : Englober, Synchroniser les prototypes.
*<code>cEdMenuCatRepository</code> : Ajouter au référentiel.
*<code>cEdMenuCatLast</code> : Voir les messages, Lecture seule, Options de l'éditeur.

==Options de l'éditeur de code==

L'interface [[lib_fr:ToolsAPI.Editor.INTACodeEditorOptions|INTACodeEditorOptions]] permet aux utilisateurs de demander des informations sur les couleurs, la gouttière visible, les fontes, les tailles, etc.

==Espace de la gouttière de l'éditeur==

La gouttière de l'éditeur est actuellement le meilleur endroit pour dessiner des informations par ligne. RAD Studio l'utilise pour les numéros de ligne, les marqueurs de pliage de ligne, les indications de modification de ligne, les points d'arrêt, les signets, etc. Réservez une partie de la gouttière de l'éditeur, car cela augmentera la largeur de la gouttière pour votre plugin. Pour ce faire, utilisez [[lib_fr:ToolsAPI.Editor.INTACodeEditorServices280.RequestGutterColumn|RequestGutterColumn]], en spécifiant une taille en pixels. Cette partie peut se trouver avant ou après (à gauche ou à droite), là où les points d'arrêt ou les numéros de ligne sont dessinés.

La méthode [[lib_fr:ToolsAPI.Editor.INTACodeEditorState.GetGutterColumnRect|GetGutterColumnRect]] permet aux utilisateurs d'obtenir le rectangle pour une zone recensée spécifique de la gouttière. Ou utilisez la méthode [[lib_fr:ToolsAPI.Editor.INTACodeEditorState.GetGutterColumnRect|GetGutterColumnRect]] pour obtenir le rectangle de la zone recensée dans la gouttière de l'éditeur.

===Autres modifications apportées à ToolsAPI===

* Depuis 11.3, les ToolsAPI suivantes pour le dessin de l'éditeur sont obsolètes :
**<code>INTAEditViewModifier.BeginPaint</code>
**<code>INTAEditViewModifier.EndPaint</code>
**<code>INTAEditViewModifier.PaintLine</code>

Nous recommandons d'utiliser le nouvel ensemble d'API.

==Voir aussi==

* [[Extension de l'EDI par l'utilisation de l'API Tools|Extension de l'EDI par l'utilisation de l'API Tools]]
* [[Création ou extension d'un package pour utiliser l'API Tools|Création ou extension d'un package pour utiliser l'API Tools]]
* [[Accès aux services de l'API Tools|Accès aux services de l'API Tools]]
* [[Utilisation d'interfaces spéciales pour étendre l'EDI|Utilisation d'interfaces spéciales pour étendre l'EDI]]
*[[Utilisation des styles de l'EDI dans des Plugins tierces parties|Utilisation des styles de l'EDI dans des Plugins tierces parties]]

Fichier de débogage RSM

2025-05-28T09:34:19Z

Yukikoi : 1 révision importée : LOC-23438

{{Parent|Types de fichiers - Index}}

Lorsque vous construisez un projet {{Delphi}} pour Windows 32 bits ou Windows 64 bits, et que l'option '''Inclure les symboles de débogage distant''' de {{Menu|Projet > Options > Compilateur {{Delphi}} > [[Liaison (Delphi)|Liaison]]}} est définie sur {{TrueOption}}, {{Product}} génère un fichier de débogage RSM.

Les ''tables de symboles'' contiennent des informations pour le débogueur, telles que le mappage des instructions machine sur les numéros de ligne source ou les noms et types des variables déclarées dans les fichiers source. Lorsque vous déboguez localement des projets {{Delphi}}, {{Product}} n'utilise pas votre fichier de débogage RSM car le compilateur conserve les tables de symboles en mémoire. Toutefois, lorsque vous [[Présentation du débogage distant|déboguez des projets {{Delphi}} à distance]], vous devez générer un fichier de débogage RSM qui contient ces tables de symboles ; sinon, {{Product}} ne s'arrêtera pas au niveau de vos [[Définition et modification de points d'arrêt|points d'arrêt]].

{{Note|Pour le périphérique iOS, macOS, macOS ARM, Linux et Android, le compilateur Delphi génère les informations de débogage dans l'exécutable. Vous n'avez pas besoin d'un fichier de débogage RSM pour ces plates-formes.}}

Le nom du fichier de débogage RSM est :

*{{Path|{{Placeholder|projet}}.rsm}} pour Windows 32 bits et Windows 64 bits.

Lorsque vous construisez votre projet {{Delphi}}, votre fichier de débogage RSM est généré par défaut dans le dossier suivant :

*Dans les [[Packages|Packages]] :
**Pour Windows 32 bits : {{Path|{{PublicDocumentsPath}}\Bpl}}
** Pour les autres plates-formes : {{Path|{{PublicDocumentsPath}}\Bpl\{{Placeholder|plate-forme}}}}

{{Note|Vous n'avez pas besoin d'un fichier de débogage RSM de package pour déboguer les packages.}}

* Pour les autres projets : {{Path|{{Chemin projet}}\{{Placeholder|projet}}\{{Placeholder|plate-forme}}\{{Placeholder|configuration de construction}}}}

{{Note|Le fichier RSM doit se trouver dans le même répertoire que l'application que vous êtes en train de déboguer ou dans le chemin de recherche des symboles de débogage. Sinon, le débogueur ne le trouvera pas. Cela ne s'applique qu'aux plates-formes Win32 (débogage distant) et Win64 (débogage local et distant). Pour changer le répertoire de sortie du package et le répertoire de sortie, sélectionnez {{Menu|Projet > Options > [[Compilateur Delphi|Compilateur Delphi]]}}. Pour changer le chemin de recherche des symboles de débogage, sélectionnez {{Menu|Projet > Options > Débogueur > [[Tables de symboles du débogueur|Tables de symboles]]}}.}}

==Voir aussi==

* [[Présentation du débogage distant|Présentation du débogage distant]]
* [[Définition de l'ordre de recherche dans les tables de symboles de débogage|Définition de l'ordre de recherche dans les tables de symboles de débogage]]

*[[Fichier de débogage DSYM|Fichier de débogage dSYM]]
* [[Fichier de débogage map|Fichier de débogage map]]
*[[TDS Debug File|Fichier de débogage TDS]]

*[[Fichiers de packages créés lors d'une compilation|Fichiers de packages créés lors d'une compilation]]

[[Category:Rﾃｩfﾃｩrence EDI]]
[[Category:XE7]]
[[Category:AMMigrate]]

Fenêtre Projets

2025-05-28T09:34:19Z

Yukikoi : 1 révision importée : LOC-23438

{{Parent|Introduction à RAD Studio}}
{{Parent|Fenêtres d'outils - Index}}

{{Menu|Voir > Fenêtres d'outils > Projets}}

Affiche et organise le contenu du groupe de projets en cours et de tous les projets qu'il contient. Vous pouvez effectuer de nombreuses tâches de gestion de projet importantes, comme l'ajout, la suppression et la compilation de fichiers. Par défaut, la '''fenêtre Projets''' est positionnée dans le coin supérieur droit de l'EDI. Comme de nombreuses fenêtres de l'EDI, cette fenêtre est ancrable.

{{Note|Certaines fonctionnalités décrites ici ne sont disponibles que dans des éditions spécifiques du produit. Par exemple, certaines fonctionnalités de la '''fenêtre Projets''' sont uniquement disponibles pour {{CBuilder}}.}}

==Noeuds et éléments de la fenêtre Projets==

Le contenu du projet en cours est représenté par une structure arborescente dans la '''fenêtre Projets'''. Les divers noeuds et éléments de la structure arborescente sont indiqués par des icônes et des libellés.

{{Tip|Vous pouvez aussi ouvrir des dossiers de ce menu en double-cliquant dessus.}}

Voici une liste partielle des icônes qui apparaissent dans la structure arborescente de la '''fenêtre Projets''' :

*[[Image:ProjGroupNew.png|link=]] [[#Menu contextuel du noeud Groupe de projets|Noeud Groupe de projets]]
*[[Image:Project.png|link=]] [[#Menu contextuel du noeud Projet|Noeud Projet]] (généralement un fichier .exe)
**Noeud [[Image:BuildConfigNode.png|link=]] '''[[#Menu contextuel du noeud Configurations de construction|Configurations de construction]]'''
***[[Image:BuildConfig.png|link=]] Configuration de construction (Debug, Release ou personnalisée)
**Noeud [[Image:Platforms.png|link=]] '''[[#Menu contextuel du noeud Plates-formes cible|Plates-formes cible]]''' (seulement disponible pour les applications multi-périphériques telles qu'une [[Application HD multi-périphérique|application HD multi-périphérique]] ou une application console multi-périphérique)
***[[Image:Android.png|link=]] Plate-forme Android 32 bits (Android)
***[[Image:Android.png|link=]] Plate-forme Android 64 bits (Android64)
***[[Image:IOS.png|link=]] Plate-forme pour Périphérique iOS 64 bits (iOSDevice64)
***[[Image:IOS.png|link=]] Plate-forme pour Simulateur iOS ARM 64 bits (iOSSimARM64)
***[[Image:Linux icon1.png|link=]] Plate-forme Linux 64 bits (Linux64)
***[[Image:OSX.png|link=]] Plate-forme macOS 64 bits (OSX64)
***[[Image:OSX.png|link=]] Plate-forme macOS ARM 64 bits (OSXARM64)
***[[Image:Windows.png|link=]] Plate-forme Windows 32 bits (Win32)
***[[Image:Windows.png|link=]] Plate-forme Windows 64 bits (Win64)

*
**[[Image:ProjOutput.png|link=]] Dossier de sortie (depuis la commande de menu contextuel '''[[#Commandes de menu contextuel communes|Afficher la sortie du projet]]''')
**[[Image:Folder.png|link=]] Dossier (tel que '''Contient''' ou '''Requiert''')
***[[Image:UnitFile.png|link=]] Code source ({{Path|.pas}}, {{Path|.cpp}} ou {{Path|.mm}}) ne contenant pas de fiche.
***[[Image:CodeFile.png|link=]] Code source ({{Path|.pas}} ou {{Path|.cpp}}) contenant une fiche.
***[[File:Resource.png|link=]] Fichier ressource ({{Path|.res}})
***[[Image:DFM.png|link=]] Fichier fiche ({{Path|.dfm}})
***[[Image:TypeLib.png|link=]] Bibliothèque de types ({{Path|.ridl}})
***[[Image:Header.png|link=]] [[Fichier d'en-tête C++|Fichier en-tête]] ({{Path|.h}}) (C++)
***[[Image:BPI.png|link=]] [[Package Import Library File|Bibliothèque d'importation pour un package]] ({{Path|.bpi}}) (C++)

==Barre d'outils de la fenêtre Projets==

Pour activer/désactiver la barre d'outils de la fenêtre Projets, cliquez avec le bouton droit sur la '''fenêtre Projets''' et sélectionnez '''Barre d'outils''' dans le menu contextuel.

{| border="1" frame="hsides" rules="rows"
|-
!'''Elément'''
!'''Description'''
|- valign="top"
|
[[Image:SearchGlass.png|link=|Loupe Chercher]] Zone de recherche
|
Filtre un résultat de recherche relatif à la fenêtre '''Gestionnaire de projets''' en fonction du texte saisi.
Activez la zone de recherche en appuyant sur {{code|'''Ctrl+F'''}} dans la fenêtre '''Gestionnaire de projets'''.
|- valign="top"
|
[[Image:Activate.png|link=]] Activer le projet sélectionné
|
Affiche le projet sélectionné au-dessus des autres projets dans l'EDI pour que vous puissiez le modifier. Vous pouvez aussi double-cliquer sur le projet pour l'activer. Le projet actif est affiché en gras.
|- valign="top"
|

[[Image:AddNewFile.png|link=]] Ajouter un nouveau projet
|
Affiche la boîte de dialogue '''Nouveaux éléments''' afin que vous puissiez ajouter un nouveau projet au groupe de projets en cours.
|- valign="top"
|
[[Image:RemoveSelected.png|link=]] Retirer le fichier ou le projet sélectionné
|
Retire le projet sélectionné du groupe de projets en cours.
|- valign="top"
|
[[Image:Synchronize icon.png|link=|]] Synchroniser la sélection avec l'éditeur
|
Synchronise l'éditeur de code avec la sélection en cours dans l'arborescence du projet. Développe l'arborescence si nécessaire et sélectionne dans l'arborescence le fichier qui est actuellement actif dans l'éditeur (si le fichier existe dans l'arborescence du projet). La commande '''Suivi automatique''' associée, dans le menu contextuel commun, active et désactive la synchronisation permanente.
|- valign="top"
|
[[Image:BuildGroupsIcon.png|link=]] Afficher le volet Groupes de construction
|
Affiche le volet [[Groupes de construction|Groupes de construction]] sous la fenêtre Projets. Utilisez le volet Groupes de construction pour créer des groupes de projets (à l'intérieur d'un groupe de projets) que vous pouvez ensuite construire, compiler, nettoyer ou supprimer en tant que groupe.
|- valign="top"
|
[[Image:SetActiveConfig.png|link=]] Définir les configurations actives
|
Définit la [[Présentation des configurations de construction|configuration de construction]] active pour tous les projets du groupe de projets. Cliquez sur la flèche déroulante pour sélectionner la configuration choisie (les valeurs par défaut sont Debug et Release). La liste déroulante contient seulement les configurations qui existent pour le groupe de projets en cours.
|- valign="top"
|
[[Image:SetActivePlatform.png|link=]] Définir les plates-formes actives
|
Définit la [[Présentation des plates-formes cible|plate-forme cible]] active pour tous les projets du groupe de projets. Cliquez sur la flèche déroulante pour sélectionner la plate-forme choisie. La liste déroulante contient seulement les plates-formes actuellement activées pour le projet.
|- valign="top"
|
Zone de liste des fichiers et des projets
|
Affiche les projets et les fichiers du groupe de projets en cours.
|}

==Commandes de menu contextuel communes==

La '''fenêtre Projets''' dispose de différents menus contextuels, selon l'objet sélectionné (tel que le noeud Groupe de projets, Projet, Fichier ou '''Configurations de construction'''). Toutefois, les menus contextuels partagent plusieurs des commandes de menu communes suivantes. Les commandes communes sont disponibles lorsque vous cliquez avec le bouton droit sur une zone vide de la zone de liste des projets.

{| border="1" frame="hsides" rules="rows"
|-
!'''Elément'''
!'''Description'''
|- valign="top"
|
Afficher le chemin
|
Ajoute un champ supplémentaire ('''Chemin''') à la fenêtre Projets afin d'afficher le chemin d'accès aux fichiers, projets et groupes de projets.
|- valign="top"
|
Suivi automatique
|
Active/désactive la synchronisation entre l'éditeur de code et la fenêtre Projets. Quand cette option est cochée, le fichier actuellement en cours d'édition dans l'éditeur de code détient aussi la focalisation dans la fenêtre Projets. '''Suivi automatique''' active la synchronisation permanente, tandis que la commande associée [[Image:SyncWEditor.png|link=]] '''Synchroniser la sélection avec l'éditeur''' de la barre d'outils effectue une synchronisation unique (même si l'option Suivi automatique est désactivée).
|- valign="top"
|
Repli automatique
|
Replie la structure de l'arborescence du projet dès qu'une opération est achevée.
|- valign="top"
|
Afficher la sortie du projet
|
Ajoute le dossier de [[Image:ProjOutput.png|link=]] '''sortie''' à la fenêtre et liste les fichiers qui font partie de la sortie de construction du projet, tels que les fichiers DCU et EXE. Ce dossier n'est pas un répertoire réel sur le disque, mais vous pouvez voir les emplacements des fichiers de sortie du répertoire réel en déplaçant la souris au-dessus du nom des fichiers à l'intérieur du dossier de '''sortie'''.
Vous pouvez définir vos répertoires de sortie comme suit :
*{{Delphi}} - {{Menu| Outils > Options > Langage > Options Delphi > [[Bibliothèque|Bibliothèque]]}}
**Répertoire de sortie DCP
**Répertoire de sortie HPP
**Répertoire de sortie des packages
*C++ - {{Menu| Outils > Options > Langage > Options C++ > [[Chemins et répertoires (C++)|Chemins et répertoires (C++)]]}}
**Répertoire de sortie BPI/LIB
**Répertoire de sortie des packages
|- valign="top"
|
Rester au-dessus
|
Affiche la '''fenêtre Projets''' au premier plan du bureau, même si d'autres fenêtres sont affichées.
|- valign="top"
|
Ancrable
|
Quand cette option est cochée, la '''fenêtre Projets''' est ancrée (attachée) aux autres fenêtres d'outils, telles que '''l'éditeur de code'''. Décochez cette option pour transformer le '''Gestionnaire de projets''' en fenêtre flottante.
|- valign="top"
|
Barre d'état
|
Affiche le chemin d'accès complet du fichier sélectionné dans la partie inférieure de la '''fenêtre Projets'''. Cette option est activée par défaut.
|- valign="top"
|
Activité de l'audit de code
|
Affiche l'état en cours de l'activité de l'audit de code, indiquée avec une barre de progression en bas de la '''fenêtre Projets'''.
|- valign="top"
|
[[Image:ExpandNodes.png|link=]][[Image:ExpandNodes.png|link=]]Développer
|
Ouvre le ou les noeuds actuellement sélectionnés dans l'arborescence du projet afin de voir le contenu du ou des noeuds.
|- valign="top"
|
[[Image:CollapseNodes.png|link=]] Replier
|
Ferme les noeuds actuellement sélectionnés dans l'arborescence du projet afin de ne voir que les noms des noeuds.
|- valign="top"
|
[[Image:SelectView.png|link=]] Vues
|
Contrôle la vue des fichiers de votre projet ou groupe de projets. Sélectionnez l'un des trois choix possibles :
*'''Répertoire (imbriqué)''' - chaque répertoire est un noeud développable distinct. C'est la valeur par défaut.
*'''Répertoire (plat)''' - les fichiers résident directement sous un noeud de répertoire qui affiche le chemin entier où ils résident.
*'''Liste''' - aucun noeud de répertoire n'est visible.
|- valign="top"
|
[[Image:SortBy.png|link=]] Tri
|
Spécifie l'ordre de tri global à utiliser dans tous les projets du groupe de projets en cours (Trier les projets par) ou dans tous les projets créés ou importés ultérieurement (Ordre de tri par défaut), comme suit :
{| border="1" frame="hsides" rules="rows"
|- valign="top"
|
Trier les projets par
|
Définit l'ordre de tri global de tous les projets du groupe de projets en cours. Trie les éléments listés dans la '''fenêtre Projets''' selon les critères suivants :
*'''Nom''' - ordre alphabétique utilisant les lettres initiales du nom du noeud ou du fichier (pour des fichiers individuels, pas à l'intérieur des noeuds)
*'''Date modifiée''' - les fichiers récemment modifiés sont listés avant les fichiers comportant des dates de modification plus anciennes
*'''Chemin''' - ordre alphabétique utilisant le chemin d'accès complet des fichiers
*'''Type''' - ordre alphabétique utilisant l'extension des fichiers (.pas, .cpp, .res et ainsi de suite)
*'''Trier automatiquement''' - quand cette option est cochée en même temps qu'une autre des options '''Trier les projets par''', ajoute automatiquement de nouveaux éléments dans l'ordre correct indiqué par la sélection '''Trier les projets par'''. '''Trier automatiquement''' est désactivée si vous réorganisez les éléments de la '''fenêtre Projets''' par glisser-déposer.

Le noeud '''Configurations de construction''' reste au sommet du groupe de projets et n'est pas trié. Pour définir l'ordre de tri local d'un projet sélectionné, utilisez la commande de menu contextuel '''Trier par'''. Si l'ordre de tri global est défini (via la barre d'outils), l'ordre de tri local (défini via le menu contextuel) est désactivé.
|- valign="top"
|
Ordre de tri par défaut
|
Définit l'ordre de tri global de tous les projets ouverts par la suite dans l'EDI. Trie les éléments listés dans la '''fenêtre Projets''' selon les critères suivants :
*'''Nom''' - ordre alphabétique utilisant les lettres initiales du nom du noeud ou du fichier (pour des fichiers individuels, pas à l'intérieur des noeuds)
*'''Date modifiée''' - les fichiers récemment modifiés sont listés avant les fichiers comportant des dates de modification plus anciennes
*'''Chemin''' - ordre alphabétique utilisant le chemin d'accès complet des fichiers
*'''Type''' - ordre alphabétique utilisant l'extension des fichiers (.pas, .cpp, .res et ainsi de suite)
*'''Trier automatiquement''' - quand cette option est cochée en même temps qu'une autre des options '''Trier les projets par''', ajoute automatiquement de nouveaux éléments dans l'ordre correct indiqué par la sélection '''Trier les projets par'''. '''Trier automatiquement''' est désactivée si vous réorganisez les éléments de la '''fenêtre Projets''' par glisser-déposer.

Le noeud '''Configurations de construction''' reste au sommet du groupe de projets et n'est pas trié. Pour définir l'ordre de tri local d'un projet sélectionné, utilisez la commande de menu contextuel '''Trier par'''. Si l'ordre de tri global est défini (via la barre d'outils), l'ordre de tri local (défini via le menu contextuel) est désactivé.
|}
|- valign="top"
|
Barre d'outils
|
Affiche ou masque la barre d'outils en haut de la '''fenêtre Projets'''.
|}

==Menu contextuel du noeud Groupe de projets==

Cliquez avec le bouton droit sur un groupe de projets pour afficher les commandes suivantes.

{| border="1" frame="hsides" rules="rows"
|-
!'''Elément'''
!'''Description'''
|- valign="top"
|
Tout compiler
|
Compile tous les projets du groupe de projets en cours qui ont été modifiés depuis la dernière construction, ainsi que tous les fichiers qui en dépendent. Cette option est seulement disponible pour les groupes de projets qui contiennent plusieurs projets.
|- valign="top"
|
Tout construire
|
Reconstruit tous les projets du groupe de projets en cours, qu'ils aient ou non été modifiés. Cette option est seulement disponible pour les groupes de projets qui contiennent plusieurs projets.
|- valign="top"
|
Tout nettoyer
|
Retire les fichiers générés de tous les projets du groupe de projets en cours, tels que les fichiers de code des objets. Cette option est seulement disponible pour les groupes de projets qui contiennent plusieurs projets.
|- valign="top"
|
Ajouter un nouveau projet
|
Affiche la boîte de dialogue '''Nouveaux éléments''', qui vous permet de créer un nouveau projet et de l'ajouter au groupe de projets en cours.
|- valign="top"
|
Ajouter un projet existant
|
Affiche la boîte de dialogue '''Ouvrir un projet''', qui vous permet d'ajouter un projet existant au groupe de projets en cours.
|- valign="top"
|
Enregistrer le groupe de projets
|
Enregistre le fichier projet (<code>.bdsgroup</code>) du groupe de projets. Utilisez cette commande après avoir ajouté, supprimé un projet ou modifié l'ordre des projets dans le groupe.
|- valign="top"
|
Enregistrer le groupe de projets sous
|
Affiche la boîte de dialogue '''Enregistrer sous''', qui permet d'enregistrer le projet sous un nouveau nom et dans un nouvel emplacement.
|- valign="top"
|
Renommer
|
Renomme le fichier projet.
|- valign="top"
|
Ajouter au contrôle de version
|
Ouvre [[Système de contrôle de version|l'expert Système de contrôle de version]] pour que vous puissiez ajouter les fichiers dans le projet sous '''[[Intégration de Subversion dans l'EDI|Subversion]]''' ou '''[[Intégration de Git dans l'EDI|Git]]'''. S'affiche uniquement pour les projets qui ne sont pas sous un système de contrôle de version.
|- valign="top"
|
Subversion
|
Si votre projet est sous contrôle de version par Subversion, les commandes suivantes s'affichent :
*'''Valider''' lance la boîte de dialogue [[Valider (SVN)|Valider (SVN)]], qui vous permet d'enregistrer les modifications dans le référentiel SVN.
**'''Depuis la racine du référentiel''' démarre l'opération de validation au niveau supérieur du référentiel.
**'''Depuis le répertoire du projet''' démarre l'opération de validation au niveau du répertoire du groupe de projets.
**'''Fichiers de ce projet''' valide seulement les fichiers du projet sélectionné, notamment les fichiers source et tous les fichiers associés, tels que les fichiers .dfm et .res. N'inclut pas les fichiers qui existent seulement dans les clauses uses ({{Delphi}}) ou les en-têtes externes (C++).
*'''[[Mettre à jour (SVN)|Mettre à jour]]''' actualise la copie de travail locale en extrayant la version la plus récente du fichier depuis le référentiel SVN. Les messages de statut s'affichent dans la [[Vue Messages|vue Messages]]. La meilleure pratique consiste à toujours mettre à jour votre copie de travail avant de commencer l'édition.
**'''Depuis la racine du référentiel''' démarre l'opération de mise à jour au niveau supérieur du référentiel.
**'''Depuis le répertoire du projet''' démarre l'opération de mise à jour au niveau du répertoire du groupe de projets.
**'''Fichiers de ce projet''' met uniquement à jour les fichiers du projet sélectionné, notamment les fichiers source et tous les fichiers associés, tels que les fichiers .dfm et .res. N'inclut pas les fichiers qui existent seulement dans les clauses uses ({{Delphi}}) ou les en-têtes externes (C++).
*'''Afficher le journal''' lance le '''[[Volet Journal|volet Journal]]''' et affiche les commentaires dans le journal de Subversion, comme suit :
**'''Depuis la racine du référentiel''' affiche le journal en commençant au niveau supérieur du référentiel.
**'''Depuis le répertoire du projet''' affiche le journal en commençant au niveau du répertoire du groupe de projets.
*'''Nettoyer''' nettoie les opérations interrompues et déverrouille la copie de travail sélectionnée depuis le chemin sélectionné, comme suit :
**'''Depuis la racine du référentiel''' démarre l'opération de nettoyage au niveau supérieur du référentiel.
**'''Depuis le répertoire du projet''' démarre l'opération de nettoyage au niveau du répertoire du groupe de projets.
*'''Parcourir le référentiel''' ouvre le [[Navigateur de référentiel|Navigateur de référentiel]] et commence au niveau du répertoire sélectionné, comme suit :
**'''Depuis la racine du référentiel''' ouvre le [[Navigateur de référentiel|Navigateur de référentiel]] au niveau supérieur du référentiel.
**'''Depuis le répertoire du projet''' ouvre le [[Navigateur de référentiel|Navigateur de référentiel]] au niveau du répertoire du projet.
*'''Fusionner''' ouvre la boîte de dialogue [[Fusionner (SVN)|Fusionner (SVN)]] et commence à fusionner une série de révisions que vous sélectionnez, comme suit :
**'''Depuis la racine du référentiel''' ouvre la boîte de dialogue [[Fusionner (SVN)|Fusionner (SVN)]] au niveau supérieur du référentiel.
**'''Depuis le répertoire du projet''' ouvre la boîte de dialogue [[Fusionner (SVN)|Fusionner (SVN)]] au niveau du répertoire du projet.
*'''Déporter''' ouvre la boîte de dialogue [[Déporter (SVN)|Déporter (SVN)]] et commence à mettre à jour la copie de travail du référentiel sur une autre URL, comme suit :
**'''Depuis la racine du référentiel''' ouvre la boîte de dialogue [[Déporter (SVN)|Déporter (SVN)]] au niveau supérieur du référentiel.
|- valign="top"
|
Git
|
Si votre projet est sous contrôle de version par Git, les commandes suivantes s'affichent :
*'''Valider''' lance la boîte de dialogue [[Valider (Git)|Valider (Git)]], qui vous permet d'enregistrer les modifications dans le référentiel Git local.
**'''Depuis la racine du référentiel''' démarre l'opération de validation au niveau supérieur du référentiel.
**'''Depuis le répertoire du projet''' démarre l'opération de validation au niveau du répertoire du groupe de projets.
*'''Pull''' met à jour le référentiel Git local avec les modifications distantes.
**'''Depuis la racine du référentiel''' démarre l'opération de mise à jour au niveau supérieur du référentiel.
**'''Depuis le répertoire du projet''' démarre l'opération de mise à jour au niveau du répertoire du groupe de projets.
*
'''Afficher le journal''' lance le '''[[Volet Journal|volet Journal]]''' et affiche les commentaires dans le journal de Git, comme suit :
**'''Depuis la racine du référentiel''' affiche le journal en commençant au niveau supérieur du référentiel.
**'''Depuis le répertoire du projet''' affiche le journal en commençant au niveau du répertoire du projet.
*'''Push''' envoie les modifications locales au référentiel Git distant.
**'''Depuis la racine du référentiel''' lance l'opération push au niveau supérieur du référentiel.
**'''Depuis le répertoire du projet''' lance l'opération push au niveau du répertoire du groupe de projets.
*'''Nettoyer''' nettoie la copie de travail du référentiel Git local.
**'''Depuis la racine du référentiel''' démarre l'opération de nettoyage au niveau supérieur du référentiel.
**'''Depuis le répertoire du projet''' démarre l'opération de nettoyage au niveau du répertoire du groupe de projets.
|- valign="top"
|
Mercurial
|
Si votre projet est sous contrôle de version par Mercurial, les commandes suivantes s'affichent :
*'''Valider''' lance la boîte de dialogue [[Valider (Mercurial)|Valider (Mercurial)]], qui vous permet d'enregistrer les modifications dans le référentiel Mercurial local.
**'''Depuis la racine du référentiel''' démarre l'opération de validation au niveau supérieur du référentiel.
**'''Depuis le répertoire du projet''' démarre l'opération de validation au niveau du répertoire du groupe de projets.
*'''Afficher le journal''' lance le '''[[Volet Journal|volet Journal]]''' et affiche les commentaires dans le journal de Mercurial , comme suit :
**'''Depuis la racine du référentiel''' affiche le journal en commençant au niveau supérieur du référentiel.
**'''Depuis le répertoire du projet''' affiche le journal en commençant au niveau du répertoire du projet.
|}

Voir aussi :

*'''[[Commentaires récents|Commentaires récents]]'''

==Menu contextuel du noeud Projet==

Cliquez avec le bouton droit sur un fichier projet pour afficher les commandes du menu contextuel.

{| border="1" frame="hsides" rules="rows"
|-
!'''Elément'''
!'''Description'''
|- valign="top"
|
Make (C++) ou Compiler ({{Delphi}})
|
Compile tous les fichiers du projet en cours qui ont été modifiés depuis la dernière construction et tous les fichiers qui en dépendent.
Vous pouvez aussi choisir '''Projet > Compiler <nom du projet>'''.
|- valign="top"
|
Build
|
Reconstruit tous les fichiers de votre projet, qu'ils aient ou non été modifiés.
Vous pouvez aussi choisir '''Projet > Construire <nom du projet>'''.
|- valign="top"
|
Nettoyer
|
Retire les fichiers générés du projet, comme les fichiers de code objet.
|- valign="top"
|
A partir d'ici > Faire un make global depuis ici (C++)
ou
A partir d'ici > Tout compiler depuis ici ({{Delphi}})
|
Compile seulement le projet sélectionné et tous les autres projets listés dessous dans le '''Gestionnaire de projets''' si ces projets ont été modifiés depuis la dernière construction. Cette option est activée uniquement lorsque plusieurs projets sont ouverts.
En revanche, choisissez '''Projet > Compiler tous les projets''' ({{Delphi}}) ou '''Projet > Make de tous les projets''' (C++) pour reconstruire chaque projet qui a été modifié dans le groupe de projets.
|- valign="top"
|
A partir d'ici > Tout construire à partir d'ici
|
Reconstruit seulement le projet sélectionné et tous les autres projets listés dessous dans la fenêtre Projets, qu'ils aient ou non été modifiés. Cette option est activée uniquement lorsque plusieurs projets sont ouverts.
En revanche, choisissez '''Projet > Construire tous les projets''' pour reconstruire tous les projets du groupe de projets.
|- valign="top"
|
A partir d'ici > Tout nettoyer à partir d'ici
|
Retire les fichiers générés (tels que les fichiers de code des objets) du projet, en commençant par le projet sélectionné et en incluant tous les autres projets listés dessous dans la '''fenêtre Projets'''. Cette option est activée uniquement lorsque plusieurs projets sont ouverts.
|- valign="top"
|
Exécuter
|
Compile tout le code source modifié et, si la compilation réussit, exécute votre application, ce qui vous permet d'utiliser et de tester l'application dans le débogueur intégré dans l'EDI.
Egalement disponible sur la [[Barres d'outils|barre d'outils]] de débogage en tant que bouton Exécuter et liste déroulante des exécutables ([[Image:RunButton.png|link=]],''' F9''').
|- valign="top"
|
Exécuter sans débogage
|
Compile tout le code source modifié et, si la compilation réussit, exécute votre application sans invoquer le débogueur construit dans l'EDI.
Egalement disponible sur la [[Barres d'outils|barre d'outils]] en tant que bouton [[Image:RunWithoutDebugging2.png|link=]] ('''Maj+Ctrl+F9''').
|- valign="top"
|
Installer | Désinstaller
|
Uniquement pour les packages (fichiers .bpl). Installe un package de conception et recense le composant associé (si un composant est présent), ou désinstalle le package de conception et annule le recensement du composant (si un composant est présent). Voir aussi [[Installer des packages|Installer des packages]].
|- valign="top"
|
Construire plus tôt
|
Déplace un projet vers le haut de la liste de projets dans un groupe de projets, ce qui modifie l'ordre dans lequel les projets sont compilés.
|- valign="top"
|
Construire plus tard
|
Déplace un projet vers le bas dans la liste des projets d'un groupe de projets.
|- valign="top"
|
TDump
|
(C++ uniquement) Démarre un vidage de fichier à l'aide de '''[[TDUMP.EXE, l'utilitaire de vidage de fichier|TDUMP.exe]]'''.
|- valign="top"
|
Ouvrir dans
|
Vous permet d'ouvrir le fichier dans une '''Nouvelle fenêtre d'édition'''. S'il existe déjà une fenêtre d'édition, elle vous permet de sélectionner la fenêtre dans laquelle ouvrir le fichier.
|- valign="top"
|
Afficher dans l'explorateur
|
Ouvre les fichiers projets dans l'explorateur Windows. Egalement disponible dans le [[#Menu contextuel du noeud Fichier|menu contextuel de niveau fichier]].
|- valign="top"
|
Ajouter au contrôle de version
|
Ouvre la [[Système de contrôle de version|boîte de dialogue du système de contrôle de version]] pour que vous puissiez ajouter les fichiers dans le projet sous '''[[Intégration de Subversion dans l'EDI|Subversion]]''' ou '''[[Intégration de Git dans l'EDI|Git]]'''. S'affiche uniquement pour les projets qui ne sont pas sous un système de contrôle de version.
|- valign="top"
|
Subversion
|
Si le fichier projet de votre projet ('''.dproj''' ou '''.cbproj''') est sous contrôle de version par [[Intégration de Subversion dans l'EDI|Subversion]], les commandes suivantes sont disponibles :
*'''Valider''' lance la boîte de dialogue [[Valider (SVN)|Valider (SVN)]], qui vous permet d'enregistrer les modifications dans le référentiel SVN.
**'''Depuis la racine du référentiel''' démarre l'opération de validation au niveau supérieur du référentiel.
**'''Depuis le répertoire du projet''' démarre l'opération de validation au niveau du répertoire du projet.
**'''Fichiers de ce projet''' valide seulement les fichiers du projet sélectionné, notamment les fichiers source et tous les fichiers associés, tels que les fichiers .dfm et .res. N'inclut pas les fichiers qui existent seulement dans les clauses uses ({{Delphi}}) ou les en-têtes externes (C++).
*'''Mettre à jour''' actualise la copie de travail locale en extrayant la version la plus récente du fichier depuis le référentiel SVN. Les messages de statut s'affichent dans la [[Vue Messages|vue Messages]]. La meilleure pratique consiste à toujours mettre à jour votre copie de travail avant de commencer l'édition.
**'''Depuis la racine du référentiel''' démarre l'opération de mise à jour au niveau supérieur du référentiel.
**'''Depuis le répertoire du projet''' démarre l'opération de mise à jour au niveau du répertoire du projet.
**'''Fichiers de ce projet''' met uniquement à jour les fichiers du projet sélectionné, notamment les fichiers source et tous les fichiers associés, tels que les fichiers .dfm et .res. N'inclut pas les fichiers qui existent seulement dans les clauses uses ({{Delphi}}) ou les en-têtes externes (C++).
*'''Afficher le journal''' lance le '''[[Volet Journal|volet Journal]]''' et affiche les commentaires dans le journal de Subversion, comme suit :
**'''Depuis la racine du référentiel''' affiche le journal en commençant au niveau supérieur du référentiel.
**'''Depuis le répertoire du projet''' affiche le journal en commençant au niveau du répertoire du projet.
*'''Nettoyer''' nettoie les opérations interrompues et déverrouille la copie de travail sélectionnée depuis le chemin sélectionné, comme suit :
**'''Depuis la racine du référentiel''' démarre l'opération de nettoyage au niveau supérieur du référentiel.
**'''Depuis le répertoire du projet''' démarre l'opération de nettoyage au niveau du répertoire du projet.
*'''Parcourir le référentiel''' ouvre le [[Navigateur de référentiel|Navigateur de référentiel]] et commence au niveau du répertoire sélectionné, comme suit :
**'''Depuis la racine du référentiel''' ouvre le [[Navigateur de référentiel|Navigateur de référentiel]] au niveau supérieur du référentiel.
**'''Depuis le répertoire du projet''' ouvre le [[Navigateur de référentiel|Navigateur de référentiel]] au niveau du répertoire du projet.
*'''Fusionner''' ouvre la boîte de dialogue [[Fusionner (SVN)|Fusionner (SVN)]] et commence à fusionner une série de révisions que vous sélectionnez, comme suit :
**'''Depuis la racine du référentiel''' démarre l'opération de fusion au niveau supérieur du référentiel.
**'''Depuis le répertoire du projet''' démarre l'opération de fusion au niveau du répertoire du projet.
* '''Déporter''' ouvre la boîte de dialogue [[Déporter (SVN)|Déporter (SVN)]], comme suit :
**'''Depuis la racine du référentiel''' commence à mettre à jour la copie de travail du référentiel sur une autre URL (au niveau supérieur du référentiel).
|- valign="top"
|
Git
|
Si le fichier projet de votre projet ('''.dproj''' ou '''.cbproj''') est sous contrôle de version par [[Intégration de Git dans l'EDI|Git]], les commandes suivantes sont disponibles :
*'''Valider''' lance la boîte de dialogue [[Valider (SVN)|Valider (SVN)]], qui vous permet d'enregistrer les modifications dans le référentiel Git local.
**'''Depuis la racine du référentiel''' démarre l'opération de validation au niveau supérieur du référentiel.
**'''Depuis le répertoire du projet''' démarre l'opération de validation au niveau du répertoire du groupe de projets.
*'''Pull''' met à jour le référentiel Git local avec les modifications distantes.
**'''Depuis la racine du référentiel''' démarre l'opération de mise à jour au niveau supérieur du référentiel.
**'''Depuis le répertoire du projet''' démarre l'opération de mise à jour au niveau du répertoire du groupe de projets.
*
'''Afficher le journal''' lance le '''[[Volet Journal|volet Journal]]''' et affiche les commentaires dans le journal de Git, comme suit :
**'''Depuis la racine du référentiel''' affiche le journal en commençant au niveau supérieur du référentiel.
**'''Depuis le répertoire du projet''' affiche le journal en commençant au niveau du répertoire du projet.
*'''Push''' envoie les modifications locales au référentiel Git distant.
**'''Depuis la racine du référentiel''' lance l'opération push au niveau supérieur du référentiel.
**'''Depuis le répertoire du projet''' lance l'opération push au niveau du répertoire du groupe de projets.
*'''Nettoyer''' nettoie la copie de travail du référentiel Git local.
**'''Depuis la racine du référentiel''' démarre l'opération de nettoyage au niveau supérieur du référentiel.
**'''Depuis le répertoire du projet''' démarre l'opération de nettoyage au niveau du répertoire du groupe de projets.
|- valign="top"
|
Mercurial
|
Si le fichier projet de votre projet est sous contrôle de version par [[Intégration de Mercurial dans l'EDI|Mercurial]], les commandes suivantes s'affichent :
*'''Valider''' lance la boîte de dialogue [[Valider (Mercurial)|Valider (Mercurial)]], qui vous permet d'enregistrer les modifications dans le référentiel Mercurial local.
**'''Depuis la racine du référentiel''' démarre l'opération de validation au niveau supérieur du référentiel.
**'''Depuis le répertoire du projet''' démarre l'opération de validation au niveau du répertoire du groupe de projets.
*'''Afficher le journal''' lance le '''[[Volet Journal|volet Journal]]''' et affiche les commentaires dans le journal de Mercurial , comme suit :
**'''Depuis la racine du référentiel''' affiche le journal en commençant au niveau supérieur du référentiel.
**'''Depuis le répertoire du projet''' affiche le journal en commençant au niveau du répertoire du projet.
|- valign="top"
|
Ajouter
|
Affiche la boîte de dialogue '''[[Ajouter au projet|Ajouter au projet]]''', qui vous permet d'ajouter des fichiers au projet sélectionné.
|- valign="top"
|
Ajouter nouveau >
|
Ajoute un nouvel élément à votre projet, comme suit :
*'''Unité''' - Ajoute une unité de compilation au projet sélectionné, en attribuant le nom Unit01.cpp à la première unité ajoutée, puis en augmentant le nombre pour chaque nouvelle unité ajoutée. Pour renommer une unité et tous ses composants, cliquez avec le bouton droit sur le nom de l'unité dans la fenêtre Projets, puis sélectionnez '''Renommer'''.
*'''Fiche''' - Ajoute une nouvelle fiche au projet sélectionné et l'affiche dans le '''Concepteur de fiches'''.
*'''Autre''' - Affiche la boîte de dialogue '''Nouveaux éléments''' et liste les catégories d'éléments disponibles, telles que Fichiers {{CBuilder}} ou Documents Web. Cliquez sur une catégorie dans le volet de gauche. Le volet de droite affiche les éléments de cette catégorie que vous pouvez ajouter à votre projet.
*'''Dossier''' (C++ uniquement) - Ouvre la boîte de dialogue '''[[Vue Dossier ou Répertoire|Vue Répertoire]]''', qui vous permet de naviguer jusqu'à un dossier et de l'ajouter au projet sélectionné. Vous souhaiterez probablement ajouter un dossier auquel vous accédez souvent durant le développement d'un programme.
*'''Dossier virtuel''' (C++ uniquement) - Ajoute un dossier virtuel grisé au projet sélectionné. Les dossiers virtuels sont affichés par défaut en dernier dans la structure de l'arborescence. Utilisez le menu contextuel du dossier virtuel afin de gérer le dossier.
*'''Personnaliser''' - Affiche la boîte de dialogue '''[[Personnaliser le menu Nouveau|Personnaliser le menu Nouveau]]''' et vous permet de personnaliser le menu '''Fichier > Nouveau''' dans le produit. Vous pouvez sélectionner des éléments, y compris des séparateurs d'éléments de menu, dans une galerie et les ajouter à votre boîte de dialogue '''Nouveaux éléments'''.
|- valign="top"
|
Retirer un fichier
|
Affiche la boîte de dialogue '''[[Retirer du projet|Retirer du projet]]''', qui vous permet de retirer un fichier du projet sélectionné.
|- valign="top"
|
Retirer le projet
|
Retire le projet actif de son groupe de projets. Le retrait de la cible du groupe de projets en cours affecte le fichier projet du groupe de projets (.grouproj) ; cela ne retire aucun fichier du disque. Par conséquent, retirez d'abord le projet du groupe de projets avant de supprimer sur le disque le fichier correspondant, afin que le produit puisse actualiser en conséquence le fichier projet.
|- valign="top"
|
Enregistrer
|
Stocke les modifications apportées à tous les fichiers du projet ouvert en utilisant leur nom respectif. Si vous tentez d'enregistrer un projet contenant des fichiers de code n'ayant jamais été enregistrés, le produit ouvre la boîte de dialogue '''Enregistrer sous''', pour vous permettre de spécifier de nouveaux fichiers.
|- valign="top"
|
Enregistrer sous...
|
Affiche la boîte de dialogue '''Enregistrer sous''' pour chaque unité de compilation nécessitant une sauvegarde et vous permet d'entrer un nouveau nom pour chaque unité.
|- valign="top"
|
Renommer
|
Met en surbrillance le noeud projet et vous permet d'entrer un nouveau nom ou de modifier le nom existant du projet.
|- valign="top"
|
TDump <nomfichier>
|
Exécute l'outil en ligne de commande [[TDUMP.EXE, l'utilitaire de vidage de fichier|TDUMP.EXE]] sur la sortie du noeud sélectionné. Par exemple, sur un fichier source C++, cette commande vide le fichier .obj, tandis que pour un projet, elle vide le fichier .exe/.bpl/.dll. La sortie de TDump est ensuite ouverte dans l'éditeur de code pour inspection.
|- valign="top"
|
Activer
|
Active le projet en cours.
|- valign="top"
|
Trier par
|
Définit l'ordre de tri local des projets sélectionnés. Trie les éléments listés dans la fenêtre Projets selon les critères suivants :
*'''Nom''' - ordre alphabétique utilisant les lettres initiales du nom du noeud ou du fichier (pour des fichiers individuels, pas à l'intérieur des noeuds).
*'''Date modifiée''' - les fichiers récemment modifiés sont listés avant les fichiers comportant des dates de modification plus anciennes.
*'''Chemin''' - ordre alphabétique utilisant le chemin d'accès complet des fichiers. Activé uniquement quand la vue est définie sur '''Liste'''. Quand la vue est définie sur '''Répertoire (imbriqué)''' ou '''Répertoire (plat)''', les fichiers sont implicitement triés par chemin d'accès car ils sont affichés dans leurs propres noeuds répertoire.
*'''Type''' - ordre alphabétique utilisant l'extension des fichiers (.pas, .cpp, .res et ainsi de suite).
*'''Ordre de construction''' - (C++ uniquement) en utilisant l'ordre de construction défini sur la boîte de dialogue '''Projet > Options > Ordre de construction'''.
*'''Trier automatiquement''' - quand cette option est cochée en même temps qu'une autre des options '''Trier par''', ajoute automatiquement les nouveaux éléments dans l'ordre correct indiqué par la sélection '''Trier par'''. '''Trier automatiquement''' est désactivée si vous réorganisez les éléments de la '''fenêtre Projets''' par glisser-déposer.

L'ordre par défaut dans la fenêtre Projets est l'ordre alphabétique. '''Trier automatiquement''' est désactivée si vous réorganisez les fichiers de la fenêtre Projets par glisser-déposer, car il est supposé que vous ne voulez aucun tri si vous réorganisez les fichiers de cette façon. L'ordre des paramètres de tri sera maintenu dans le fichier .local du projet, et appliqué à chaque rechargement du projet.
Le noeud '''Configurations de construction''' reste au sommet du groupe de projets et n'est pas trié. Pour définir l'ordre de tri local de tous les projets, cliquez sur le bouton [[Image:SortBy.png]] ('''Trier par''') de la barre d'outils de la '''fenêtre Projets'''. Si l'ordre de tri global est défini (via la barre d'outils), l'ordre de tri local (défini via le menu contextuel) est désactivé.
|- valign="top"
|
Voir le source
|
Affiche le code source du projet sélectionné.
|- valign="top"
|
Dépendances
|
Affiche la boîte de dialogue '''Projet > Dépendances''' , qui vous permet de modifier l'ordre de construction des projets dans un groupe de projets. Cette commande est uniquement disponible si le groupe de projets en cours contient plusieurs projets.
|- valign="top"
|
Ordre de construction
|
(C++ uniquement ) Affiche la boîte de dialogue '''[[Ordre de construction|Ordre de construction]]''', qui vous permet de déplacer les fichiers qui doivent être compilés par chaque compilateur (compilateur de ressources, Turbo Assembleur et compilateur C++).
|- valign="top"
|
Support de la modélisation
|
Affiche la boîte de dialogue '''[[Support de la modélisation|Support de la modélisation]]''', qui liste les projets actuellement ouverts. Sélectionnez les projets auxquels vous souhaitez appliquer le support de la modélisation.
|- valign="top"
|
Formater les sources du projet
|
Effectue l'action '''[[Formater les sources du projet|Formater les sources du projet]]'''.
|- valign="top"
|
Options
|
Affiche la boîte de dialogue '''[[Boîte de dialogue Options de projet|Options du projet]]'''.
|}

==Menu contextuel du fichier d'en-tête précompilé C++==

{{Product}} affiche un noeud supplémentaire pour les applications C++ : le noeud du fichier d'en-tête précompilé ('''PCH.h''').

Le fichier '''PCH.h''' est un fichier d'en-tête précompilé généré automatiquement et faisant partie de chaque projet C++ (avec un nom tel que '''Project1PCH1.h'''). Ce fichier PCH.h est utilisé par n'importe lequel des [[Chaînes d'outils C++|compilateurs C++]] si vous cliquez avec le bouton droit sur le noeud '''PCH.h''' et activez l'option '''Utiliser pour la précompilation''' dans le menu contextuel, comme décrit ci-dessous. De plus, les compilateurs C++ de précédente génération ([[BCC32|BCC32]]) créent pour vous un en-tête précompilé en arrière-plan.

{| border="1" frame="hsides" rules="rows"
|-
!'''Elément'''
!'''Description'''
|- valign="top"
|
Préprocesseur
|
Exécute le préprocesseur C++, soit [[CPP32.EXE, le préprocesseur du compilateur C|CPP32.EXE]] soit [[CPP64, le préprocesseur pour Windows 64 bits|CPP64.EXE]], selon la plate-forme cible en cours du projet.
|- valign="top"
|
Ouvrir
|
Ouvre les fichiers sélectionnés dans '''l'éditeur de code'''.
|- valign="top"
|
Retirer du projet
|
Retire du projet les fichiers sélectionnés. Vous êtes invité à enregistrer les modifications effectuées.
|- valign="top"
|
Enregistrer
|
Enregistre les modifications apportées aux fichiers sélectionnés sous leur nom actuel.
|- valign="top"
|
Enregistrer sous
|
Affiche la boîte de dialogue '''Enregistrer sous''', qui permet d'enregistrer les fichiers sélectionnés avec les nouveaux noms et emplacements.
|- valign="top"
|
Renommer
|
Vous permet de renommer le fichier et tous les fichiers secondaires correspondants qui apparaissent comme noeuds enfant dans la '''fenêtre Projets'''.
|- valign="top"
|
Utiliser l'en-tête précompilé
|
Spécifie si ce fichier d'en-tête C++ sera utilisé comme en-tête précompilé pour le projet.
La valeur par défaut de cette option est déterminée par la plate-forme cible du projet, comme suit :
*'''Activée''' uniquement si la plate-forme cible est Windows 64 bits
*:Par défaut, les [[Compilateurs C++ améliorés par Clang|compilateurs C++ améliorés par Clang]] utilisent le fichier '''PCH.h''' affiché dans la fenêtre Projets.
*'''Non activée''' si la plate-forme cible est Windows 32 bits ou macOS32
*:Toutefois, vous pouvez utiliser le fichier '''PCH.h''' affiché dans la fenêtre Projets si vous sélectionnez le fichier dans la fenêtre Projets et activez l'option '''Utiliser pour la précompilation'''.
|}

==Menu contextuel du noeud Configurations de construction==

Le noeud '''Configurations de construction''' affiche le nom de la configuration de construction active en cours, par exemple :

:[[Image:BuildConfigNode.png|link=]] '''Configurations de construction (Debug)'''

Cliquez avec le bouton droit sur le noeud '''Configurations de construction''' ou sur le nom d'une configuration de construction spécifique dans le noeud pour afficher le menu contextuel.

{| border="1" frame="hsides" rules="rows"
|-
!'''Elément'''
!'''Description'''
|- valign="top"
|
Make
|
Compile tous les fichiers du projet en cours qui ont été modifiés depuis la dernière construction, ainsi que les fichiers qui en dépendent. Vous pouvez aussi choisir '''Projet > Compiler [nom du projet]'''.
|- valign="top"
|
Build
|
Reconstruit tous les fichiers de votre projet, qu'ils aient ou non été modifiés. Vous pouvez aussi choisir '''Projet > Construire [nom du projet]'''.
|- valign="top"
|
Nettoyer
|
Retire les fichiers générés du projet, comme les fichiers de code objet.
|- valign="top"
|
Afficher dans l'explorateur
|
Localise le fichier de sortie de la configuration de construction en cours.
|- valign="top"
|
Renommer
|
Vous permet de renommer la configuration de construction sélectionnée.
|- valign="top"
|
Supprimer
|
Affiche la boîte de dialogue '''Confirmer''', qui vous permet de supprimer la configuration sélectionnée.
|- valign="top"
|
Nouvelle configuration
|
Ajoute une configuration enfant, basée sur la configuration sélectionnée, et liste la nouvelle configuration dans la '''fenêtre Projets''' sous le nom de la configuration parent.
|- valign="top"
|
Nouveau jeu d'options
|
Crée un nouveau fichier jeu d'options (extension de fichier <code>.optset</code>) basé sur la configuration sélectionnée et ouvre la boîte de dialogue '''Enregistrer sous''' afin que vous puissiez spécifier le nom et l'emplacement du fichier jeu d'options.
|- valign="top"
|
Appliquer le jeu d'options
|
Affiche la boîte de dialogue Appliquer le jeu d'options, qui vous permet de sélectionner un fichier <code>.optset</code> à appliquer à la configuration de construction sélectionnée. Vous pouvez redéfinir, remplacer ou préserver les valeurs d'options existantes.
|- valign="top"
|
Activer
|
Fait de la configuration de construction sélectionnée la configuration active en cours pour le projet ; apparaît seulement pour les configurations qui ne sont actuellement pas actives. La configuration de construction active est listée en gras.
|- valign="top"
|
Modifier
|
Affiche la boîte de dialogue {{Menu|Projet > Options}} préchargée avec les valeurs définies dans la configuration de construction sélectionnée.
|}

==Menu contextuel du noeud Plates-formes cible==

*Pour ajouter une plate-forme, cliquez avec le bouton droit sur le noeud '''Plates-formes cible''', puis cliquez sur la commande '''Ajouter une plate-forme'''. Par défaut, la plate-forme nouvellement ajoutée devient la plate-forme active du projet. Pour ajouter une plate-forme sans l'activer, désactivez '''Rendre active la plate-forme sélectionnée''' dans la boîte de dialogue Sélectionner une plate-forme.
*Pour afficher les autres commandes de menu contextuel, cliquez avec le bouton droit sur le nom d'une cible multiplate-forme spécifique dans le noeud '''Plates-formes cible'''.
*Pour créer un profil de connexion ou modifier un profil de connexion existant, choisissez '''Outils > Options > Déploiement > [[Gestionnaire de profils de connexion|Gestionnaire de profils de connexion]]'''.
*Pour ajouter un nouveau SDK ou modifier un SDK existant, choisissez '''Outils > Options > Déploiement > [[Gestionnaire de SDK|Gestionnaire de SDK]]'''.

Pour de plus amples informations sur ce noeud, voir '''[[Présentation des plates-formes cible|Présentation des plates-formes cible]]'''.

{| border="1" frame="hsides" rules="rows"
|-
!'''Elément'''
!'''Description'''
|- valign="top"
|
Ajouter une plate-forme
|
Ouvre la boîte de dialogue '''Sélectionner une plate-forme''', dans laquelle vous pouvez sélectionner une plate-forme à ajouter à votre projet. Les choix sont limités par les capacités multi-périphériques du type d'application que vous créez, comme une application console {{f|datasnap| ou un [[Expert Serveur DataSnap|serveur DataSnap]]}}, et par le langage de développement utilisé. Vous avez le choix entre les plates-formes suivantes :
*'''Android 32 bits''' pour les périphériques Android fonctionnant avec un système d'exploitation 32 bits ou 64 bits.
*'''Android 64 bits''' pour les périphériques Android fonctionnant avec un système d'exploitation 64 bits.
*'''Périphérique iOS 64 bits''' pour les périphériques iOS fonctionnant avec un système d'exploitation 64 bits.
*'''Plate-forme pour Simulateur iOS ARM 64 bits''' pour les périphériques iOS ARM fonctionnant avec un système d'exploitation 64 bits.
*'''Linux 64 bits''' pour les ordinateurs Linux Intel fonctionnant avec un système d'exploitation 64 bits.
*'''macOS 64 bits''' pour les ordinateurs macOS Intel fonctionnant avec un système d'exploitation 64 bits.
*'''macOS ARM 64 bits''' pour les ordinateurs macOS ARM fonctionnant avec un système d'exploitation 64 bits.
*'''Windows 32 bits''' pour les ordinateurs Windows Intel fonctionnant avec un système d'exploitation 32 bits ou 64 bits (il s'agit de la valeur par défaut).
*'''Windows 64 bits''' pour les ordinateurs Windows Intel fonctionnant avec un système d'exploitation 64 bits.

{{Note|La commande '''Ajouter une plate-forme''' est seulement disponible quand vous cliquez avec le bouton droit sur le noeud '''Plates-formes cible''' lui-même, et non sur l'une des plates-formes.}}
|- valign="top"
|
Modifier la connexion
|
Ouvre la page [[Gestionnaire de profils de connexion|Gestionnaire de profils de connexion]] de la boîte de dialogue Options des outils et vous permet de modifier le profil de connexion assigné à la plate-forme sélectionnée.
|- valign="top"
|
Rétablir le profil par défaut
|
Assigne le profil de connexion par défaut à la plate-forme sélectionnée.
Cette commande est disponible seulement quand un profil de connexion est actuellement assigné à la plate-forme sélectionnée, et n'est pas le profil de connexion par défaut. Vous pouvez choisir un autre profil de connexion par défaut en sélectionnant '''Outils > Options > Déploiement > [[Gestionnaire de profils de connexion|Gestionnaire de profils de connexion]]'''.
|- valign="top"
|
Retirer un profil
|
Annule l'assignation du profil de connexion actuellement assigné à la plate-forme sélectionnée, ce qui fait qu'aucun profil de connexion n'est plus assigné à la plate-forme.
Cette commande est disponible seulement quand un profil de connexion est actuellement assigné à la plate-forme sélectionnée.
|- valign="top"
|
Retirer la plate-forme
|
Retire la plate-forme sélectionnée du noeud '''Plates-formes cible''' pour le projet en cours. Vous pouvez ajouter de nouveau la plate-forme sélectionnée en cliquant avec le bouton droit sur le noeud '''Plates-formes cible''' et en sélectionnant '''Ajouter une plate-forme'''.
|- valign="top"
|
Propriétés
|
Ouvre la boîte de dialogue [[Propriétés de la plate-forme|Propriétés de la plate-forme]] et vous permet de :
*Associer un SDK à la plate-forme. La zone de liste déroulante est seulement activée pour les plates-formes nécessitant un SDK pour le projet en cours : les applications de la plate-forme macOS, et les applications des plates-formes mobiles pour {{Delphi}} et C++.
*Associer un profil de connexion à la plate-forme. Sélectionnez '''Ajouter nouveau''' dans la zone de liste déroulante pour ouvrir la boîte de dialogue [[Créer un profil de connexion|Créer un profil de connexion]] et créer un nouveau profil de connexion.
|- valign="top"
|
Activer
|
Transforme la plate-forme sélectionnée en plate-forme cible pour le projet.
Cette commande est disponible seulement quand vous cliquez avec le bouton droit sur une plate-forme qui n'est pas actuellement la plate-forme active (c'est-à-dire une plate-forme dont le nom n'apparaît pas en gras).
|- valign="top"
|
Actualiser
|
Met à jour la liste des périphériques et simulateurs disponibles pour la plate-forme cible. Voir '''[[Présentation des plates-formes cible#Utilisation du noeud Cible|Utilisation du noeud Cible]]'''.
{{Note|La commande '''Actualiser''' est disponible seulement quand vous cliquez avec le bouton droit sur le noeud '''Cible''' à l'intérieur d'un noeud de plate-forme cible.}}
|}

==Menu contextuel des dossiers Contient et Requiert==

Les dossiers '''Contient''' et '''Requiert''' apparaissent seulement pour les packages. Pour de plus amples informations, voir [[Création d'un package|Création d'un package]] et [[Packages|Packages ({{Delphi}})]].

===Menu contextuel du dossier Contient===

{| border="1" frame="hsides" rules="rows"
|-
!'''Elément'''
!'''Description'''
|- valign="top"
|
Ajouter
|
Affiche la boîte de dialogue '''[[Ajouter au projet|Ajouter au projet]]''', qui vous permet d'ajouter des fichiers au dossier '''Contient'''.
|- valign="top"
|
Ajouter nouveau
|
Ajoute un nouvel élément au dossier '''Contient''', comme suit :
{|
|-
|
Unité
|
Pour un package {{Delphi}}, cette option ajoute une nouvelle unité {{Delphi}}.
Pour un package C++, vous avez deux options :
*Unité - {{CBuilder}}
*Unité - {{Delphi}}

Ajoute une unité de compilation (une unité ne contenant pas de fiche) au dossier '''Contient''' ; assigne le nom Unit1.pas ({{Delphi}}) ou Unit01.cpp à la première unité ajoutée, puis augmente le nombre pour chaque nouvelle unité ajoutée.
Pour renommer une unité et tous ses composants, cliquez avec le bouton droit sur le nom de l'unité dans la '''fenêtre Projets''', puis sélectionnez '''Renommer'''.
|- valign="top"
|
Fiche
|
Pour un package {{Delphi}}, c'est la seule option permettant d'ajouter une nouvelle fiche.
Pour un package C++, vous avez deux options :
*Fiche - {{CBuilder}}
*Fiche - {{Delphi}}

Ajoute un nouveau fichier d'unité (un fichier contenant une fiche ou un fichier <code>.dfm</code>) au dossier '''Contient''' et affiche la nouvelle fiche dans le '''[[Concepteur de fiches|Concepteur de fiches]]'''. Les numéros d'unités sont augmentés de la même façon qu'avec la commande '''Ajouter une unité'''.
|- valign="top"
|
Autre
|
Affiche la boîte de dialogue '''[[Nouveaux éléments|Nouveaux éléments]]''', qui vous permet de sélectionner un élément du référentiel d'objets à ajouter au dossier '''Contient'''. Cliquez sur une catégorie dans le volet de gauche. Le volet de droite affiche les éléments de cette catégorie que vous pouvez ajouter à votre projet.
|- valign="top"
|
[[Utilisation des dossiers virtuels|Dossier virtuel]]
|
Disponible pour C++ uniquement. Ouvre la zone de saisie '''[[Vue Dossier ou Répertoire|Ajouter un nouveau dossier]]''', qui vous permet de fournir un nom au nouveau dossier virtuel.
Vous pouvez cliquer avec le bouton droit sur le dossier virtuel et utiliser les commandes du menu contextuel pour ajouter une unité existante au dossier virtuel, ajouter de nouvelles unités, fiches, d'autres éléments ou un dossier virtuel imbriqué. Vous pouvez aussi personnaliser le menu '''Fichier > Nouveau'''.
|- valign="top"
|
Personnaliser
|
Affiche la boîte de dialogue '''[[Personnaliser le menu Nouveau|Personnaliser le menu Nouveau]]''', qui vous permet de personnaliser le menu '''Fichier > Nouveau''' dans le produit, et de spécifier un type d'application par défaut. Vous pouvez sélectionner des éléments, y compris des séparateurs d'éléments de menu, dans une galerie et les ajouter à votre boîte de dialogue '''Nouveaux éléments'''.
|}

Le menu '''Projet > Ajouter nouveau''' et le menu '''Fichier > Nouveau''' vous permettent d'ajouter rapidement des modules de données. Procédez comme suit :

*Double-cliquez sur une unité pour l'ouvrir.
*Double-cliquez sur un dossier pour le développer ou le réduire.
*Double-cliquez sur un projet pour l'activer s'il n'est pas le projet actif. S'il s'agit du projet actuellement actif, cette action développe ou réduit le projet.
|- valign="top"
|
Retirer un fichier
|
Ouvre la boîte de dialogue '''[[Retirer du projet|Retirer du projet]]''', qui vous permet de retirer un fichier du dossier '''Contient'''.
|}

===Menu contextuel du dossier Requiert===

{| border="1" frame="hsides" rules="rows"
|-
!'''Elément'''
!'''Description'''
|- valign="top"
|
Ajouter une référence
|
Ouvre la boîte de dialogue '''[[Boîte de dialogue Ajouter, onglet Requiert|Boîte de dialogue Ajouter, onglet Requiert]]''', qui vous permet de rechercher et d'ajouter un package (.bpl) au dossier '''Requiert'''.
|- valign="top"
|
Retirer un fichier
|
Affiche la boîte de dialogue '''[[Retirer du projet|Retirer du projet]]''', qui vous permet de retirer un fichier du projet sélectionné.
|}

==Menu contextuel du noeud Fichier==

Cliquez avec le bouton droit sur un fichier d'un projet pour afficher les commandes du menu contextuel. Les commandes varient selon le type de fichier sélectionné.

{| border="1" frame="hsides" rules="rows"
|-
!'''Elément'''
!'''Description'''
|- valign="top"
|
Build
|
Raccourci qui compile le fichier sélectionné.
|- valign="top"
|
Compiler en assembleur
|
(C++ seulement) Compile le fichier source sélectionné en fichier .ASM et affiche le fichier dans l'éditeur de code.
|- valign="top"
|
Modifier les options locales
|
Pour C++, affiche une boîte de dialogue '''Options du projet''' abrégée, ne contenant que les pages relatives au fichier et au projet en cours.
|- valign="top"
|
Exclure de la construction
|
Pour C++ uniquement. Marque temporairement le fichier sélectionné comme ne faisant pas partie de la construction. Après l'exclusion d'un fichier de la construction, le nom du fichier apparaît estompé dans la fenêtre Projets, et cet élément de menu contextuel est coché. Pour rétablir le fichier dans la construction, cliquez avec le bouton droit sur le fichier dans la fenêtre Projets, puis cliquez sur la coche relative à cette commande dans le menu contextuel.
|- valign="top"
|
Lien par nom seulement
|
Pour C++ uniquement. Pour un fichier objet ou bibliothèque, localise le fichier à l'aide du '''chemin de recherche des bibliothèques''' (défini dans la boîte de dialogue '''Projet > Options > Répertoires et Conditions''').
Pour lier un fichier objet ou bibliothèque explicitement par son chemin de fichier, décochez ce champ. Ainsi, quand le lieur reçoit le nom de chemin entièrement qualifié du fichier objet ou bibliothèque, il ignore le paramètre Chemin de recherche des bibliothèques.
'''Lien par nom seulement''' est l'option par défaut pour les fichiers .lib et .obj ajoutés aux projets 2009 ; cette option est nouvelle pour 2009.
|- valign="top"
|
Ouvrir
|
Ouvre les fichiers sélectionnés dans '''l'éditeur de code'''.
|- valign="top"
|
Préprocesseur
|
Exécute le préprocesseur C++ (Cpp32.exe).
|- valign="top"
|
Renommer
|
Vous permet de renommer le fichier et tous les fichiers secondaires correspondants qui apparaissent comme noeuds enfant dans la '''fenêtre Projets'''.
|- valign="top"
|
Retirer du projet
|
Retire du projet les fichiers sélectionnés. Vous êtes invité à enregistrer les modifications effectuées.
|- valign="top"
|
Enregistrer
|
Enregistre les modifications apportées aux fichiers sélectionnés sous leur nom actuel.
|- valign="top"
|
Enregistrer sous
|
Affiche la boîte de dialogue '''Enregistrer sous''', qui permet d'enregistrer les fichiers sélectionnés avec les nouveaux noms et emplacements.
|- valign="top"
|
Afficher les dépendances
|
Pour C++ uniquement. Affiche la boîte de dialogue '''Projet > Dépendances''', qui vous permet de modifier l'ordre de construction des projets dans un groupe de projets.
|- valign="top"
|
Afficher dans l'explorateur
|
Ouvre l'Explorateur Windows, en affichant le dossier qui contient le fichier sélectionné. Egalement disponible dans le [[#Menu contextuel du noeud Projet|menu contextuel de niveau projet]].
|- valign="top"
|
Ajouter au contrôle de version
|
Ouvre [[Système de contrôle de version|l'expert Système de contrôle de version]] pour que vous puissiez ajouter les fichiers dans le projet sous '''[[Intégration de Subversion dans l'EDI|Subversion]]''' ou '''[[Intégration de Git dans l'EDI|Git]]'''. S'affiche uniquement pour les projets qui ne sont pas sous un système de contrôle de version.
|- valign="top"
|
Subversion
|
Si les fichiers sont sous contrôle de version avec [[Intégration de Subversion dans l'EDI|Subversion]], les commandes suivantes s'affichent :
*'''Valider''' ouvre le volet [[Valider (SVN)|Valider (SVN)]], qui vous permet d'enregistrer les modifications dans le référentiel SVN.
*'''Mettre à jour''' actualise la copie de travail locale en extrayant la version la plus récente du fichier depuis le référentiel SVN. Les messages de statut s'affichent dans la vue [[Vue Messages|Messages]]. La meilleure pratique consiste à toujours mettre à jour votre copie de travail avant de commencer l'édition.
*'''Parcourir le référentiel''' ouvre le [[Navigateur de référentiel|Navigateur de référentiel]], qui affiche la structure arborescente SVN qui contient le fichier que vous modifiez.
*'''Restaurer''' annule les modifications effectuées localement et rétablit une version précédente.
|- valign="top"
|
Git
|
Si les fichiers sont sous contrôle de version par [[Intégration de Git dans l'EDI|Git]], les commandes suivantes s'affichent :
*'''Valider''' ouvre le volet [[Valider (Git)|Valider (Git)]], qui vous permet d'enregistrer les modifications dans votre référentiel local.
*'''Restaurer''' annule toutes les modifications effectuées localement, rétablit une version précédente du fichier et résout tous les états conflictuels.
|- valign="top"
|
Mercurial
|
Si les fichiers sont sous contrôle de version par [[Intégration de Mercurial dans l'EDI|Mercurial]], les commandes suivantes s'affichent :
*'''Valider ''' ouvre le volet [[Valider (Mercurial)|Valider (Mercurial)]], qui vous permet d'enregistrer les modifications dans votre référentiel local.
*'''Restaurer''' annule toutes les modifications effectuées localement et rétablit une version précédente du fichier.
|- valign="top"
|
TDump <nomfichier>.obj
|
Pour C++ uniquement. Envoie le fichier sélectionné à l'utilitaire [[TDUMP.EXE, l'utilitaire de vidage de fichier|TDump]].
|}

==Boîtes de dialogue enfant==

*[[Valider (SVN)|Valider (SVN)]]
*[[Valider (Git)|Valider (Git)]]
*[[Fusionner (SVN)|Fusionner (SVN)]]
*[[Déporter (SVN)|Déporter (SVN)]]
*[[Volet Importer|Volet Importer]]
*[[Navigateur de référentiel|Navigateur de référentiel]]
*[[Volet Journal|Volet Journal]]

==Voir aussi==

*[[Démarrage d'un projet - Présentation|Démarrage d'un projet - Présentation]]
*[[Ajout et suppression de fichiers|Ajout et suppression de fichiers]]
*[[Ajout de composants à une fiche|Ajout de composants à une fiche]]
*[[Définition des options de projet|Définition des options de projet]]
*[[Définition des propriétés, des méthodes et des événements|Définition des propriétés, des méthodes et des événements]]
*[[Options de la cible|Options de la cible]]
*[[Intégration de Subversion dans l'EDI|Intégration de Subversion dans l'EDI]]
**[[Extraire (SVN)|Extraire (SVN)]]
*[[Intégration de Git dans l'EDI|Intégration de Git dans l'EDI]]
**[[Cloner (Git)|Cloner (Git)]]
*[[Intégration de Mercurial dans l'EDI|Intégration de Mercurial dans l'EDI]]
**[[Cloner (Mercurial)|Cloner (Mercurial)]]

[[Category:Rﾃｩfﾃｩrence EDI]]
[[Category:XE5]]
[[Category:AMMigrate]]

Accès aux services de l'API Tools

2025-05-28T09:34:19Z

Yukikoi : 1 révision importée : LOC-23438

{{Parent|Extension de l'EDI par l'utilisation de l'API Tools}}

Pour effectuer des actions, les packages qui étendent l'EDI doivent pouvoir accéder à ses éditeurs, fenêtres, menus, etc. C'est le rôle des interfaces de service.

==Liste des interfaces de service courantes de l'API Tools==

L'API Tools propose de nombreux services, dont des services action pour effectuer des actions sur les fichiers, des services d'édition pour accéder à l'éditeur de code source, des services de débogage pour accéder au débogueur, etc. Le tableau suivant résume quelques-unes des plus importantes interfaces de service :

{| class="wikitable"
|-
! Interface
! Description
|- valign="top"
|
{{Code|INTAServices}}
|
Donne accès aux objets natifs de l'EDI : menu principal, liste d'actions, liste d'images et barres d'outils. Voir [[Utilisation d'objets natifs de l'EDI|Utilisation d'objets natifs de l'EDI]].
|- valign="top"
|
[[lib_fr:ToolsAPI.Editor.INTACodeEditorServices|{{Code|INTACodeEditorServices}}]]
|
Permet aux utilisateurs de s'inscrire aux événements de l'éditeur.
|- valign="top"
|
[[lib_fr:ToolsAPI.WelcomePage.INTAWelcomePageBackgroundService|{{Code|INTAWelcomePageBackgroundService}}]]
|
Interface d'implémentation de l'arrière-plan de la page d'accueil.
|- valign="top"
|
[[lib_fr:ToolsAPI.WelcomePage.INTAWelcomePagePluginService|{{Code|INTAWelcomePagePluginService}}]]
|
Fournit les services du Service de la page d'accueil.
|- valign="top"
|
{{Code|IOTAActionServices}}
|
Effectue les actions de base sur les fichiers : ouverture, fermeture, enregistrement et rechargement d'un fichier.
|- valign="top"
|
{{Code|IOTACodeCompletionServices}}
|
Donne accès à l'achèvement de code, ce qui permet à un expert d'installer un gestionnaire personnalisé d'achèvement de code.
|- valign="top"
|
{{Code|IOTADebuggerServices}}
|
Donne accès au débogueur.
|- valign="top"
|
{{Code|IOTAEditorServices}}
|
Donne accès à l'éditeur de code source et aux tampons internes.
|- valign="top"
|
{{Code|IOTAIDEThemingServices}}
|
Donne accès aux StyleServices de l'EDI, vous permet de vérifier si les thèmes sont activés, vous permet d'enregistrer vos fiches pour qu'elles soient dessinées dans le même style que les fiches intégrées de l'EDI, etc.
|- valign="top"
|
{{Code|IOTAKeyBindingServices}}
|
Permet à un expert de recenser des liaisons de clavier personnalisées.
|- valign="top"
|
{{Code|IOTAKeyboardServices}}
|
Donne accès aux macros et liaisons clavier.
|- valign="top"
|
{{Code|IOTAKeyboardDiagnostics}}
|
Inverse le débogage des frappes au clavier.
|- valign="top"
|
{{Code|IOTAMessageServices}}
|
Donne accès à la vue des messages.
|- valign="top"
|
{{Code|IOTAModuleServices}}
|
Donne accès aux fichiers ouverts.
|- valign="top"
|
{{Code|IOTAPackageServices}}
|
Obtient le nom de tous les packages installés et de leurs composants.
|- valign="top"
|
{{Code|IOTAServices}}
|
Services divers.
|- valign="top"
|
{{Code|IOTASplashScreenServices}}
|
Interface de l'écran d'accueil
|- valign="top"
|
{{Code|IOTAToDoServices}}
|
Donne accès à la liste des tâches, ce qui permet à un expert d'installer un gestionnaire personnalisé de la liste de tâches.
|- valign="top"
|
{{Code|IOTAToolsFilter}}
|
Recense les notificateurs d'outils de filtrage.
|- valign="top"
|
[[Extension de l'EDI par l'utilisation de l'API Tools#Interface IOTAVersionSKUInfoService|{{Code|IOTAVersionSKUInfoService}}]]
|
Permet d'obtenir la liste des plates-formes installées, la SKU, et de savoir si l'EDI actuellement exécutée est une version Trial.
|- valign="top"
|
{{Code|IOTAWizardServices}}
|
Recense ou annule le recensement des experts.
|}

===Images High DPI dans l'API Tools===

Toutes les API qui transmettent des images, comme les services d'écran d'accueil, la boîte de dialogue A propos, IDE Insight et d'autres éléments, prennent en charge des images haute résolution (High DPI).

Chaque interface possède une nouvelle surcharge de méthodes pertinentes qui prennent en charge {{Code|TGraphicArray}}, défini comme un ensemble d'éléments {{Code|TGraphic}}. Vous pouvez ainsi transmettre plusieurs résolutions d'une même icône, qui sont ajoutées à la collection d'images internes et utilisées avec une liste d'images virtuelles.

Bien que ces méthodes prennent en charge un large éventail d'éléments {{Code|TGraphic}}, nous vous recommandons d'utiliser des images PNG.

==Utilisation d'une interface de service==

Pour utiliser une interface de service, transtypez la variable {{Code|BorlandIDEServices}} dans le service souhaité à l'aide de la fonction globale [[lib_fr:System.SysUtils.Supports|Supports]]. Par exemple :
<l s="delphi" />

'''{{Delphi}} :'''<source lang="delphi">
procedure SetKeystrokeDebugging(Debugging: Boolean);
var
Dialog: IOTAKeyboardDiagnostics
begin
if Supports(BorlandIDEServices, IOTAKeyboardDiagnostics, Dialog) then
Dialog.KeyTracing := Debugging;
end;</source><l e="delphi" /><l s="cpp" />

'''C++ :'''<source lang="cpp">
void SetKeystrokeDebugging(bool Debugging)
{
_di_IOTAKeyboardDiagnostics Dialog;
if (BorlandIDEServices->Supports(Dialog))
Dialog->KeyTracing = Debugging;
}</source><l e="cpp" />

Si votre expert a besoin d'utiliser fréquemment un service donné, vous pouvez conserver un pointeur sur ce service comme donnée membre de la classe de votre expert.

==Rubriques==

Les rubriques suivantes décrivent en détail l'utilisation des services d'interfaces de l'API Tools :

* [[Utilisation d'objets natifs de l'EDI|Utilisation d'objets natifs de l'EDI]]
* [[Débogage d'un expert|Débogage d'un expert]]
* [[Numéros de version de l'interface|Numéros de version de l'interface]]

==Voir aussi==

*[[Utilisation des fichiers et des éditeurs|Utilisation des fichiers et des éditeurs]]
*[[Création d'experts fiches et projets|Création d'experts fiche et projet]]
*[[Notification d'un expert des événements de l'EDI|Notification d'un expert des événements de l'EDI]]

[[Category:Guide du développeur Windows]]
[[Category:Delphi]]
[[Category:C++]]

Aide Expert mobile iOS

2025-05-28T09:34:18Z

Yukikoi : 1 révision importée : LOC-23438

{{Parent|Tutoriels}}
{{DISPLAYTITLE:Aide Expert mobile iOS}}

===Bienvenue===

* [[Bienvenue dans l'Aide Expert mobile iOS|Bienvenue dans iOS]]

===Préparation de votre Mac===

* [[Installation de Xcode sur un Mac|Installation de Xcode]]
* [[Installation des outils de ligne de commande Xcode sur un Mac|Installation des outils de ligne de commande]]
*[[Installation de Platform Assistant sur un Mac|Installation de Platform Assistant]]
* [[Exécution de Platform Assistant sur un Mac|Exécution de Platform Assistant]]

===Préparation de votre PC===

* [[Création et test d'un profil de connexion sur le PC de développement|Création d'un profil de connexion]]
* [[Ajout d'un SDK macOS ou iOS|Installation des SDK]]

===Déploiement sur le simulateur iOS===

* [[Création d'une app iOS|Construction de votre première application]]
* [[Exécution de votre application iOS sur le simulateur iOS|Exécution sur le simulateur iOS de votre Mac]]

===Préparation du déploiement sur un périphérique iOS===

* [[Rejoindre le programme Développeur Apple|Souscrire un compte Développeur Apple]]
* [[Acquisition d'un certificat Développeur iOS|Acquisition d'un certificat Développeur]]
* [[Approvisionnement d'une application iOS|Approvisionnement de votre périphérique iOS]]

===Test des apps sur un périphérique iOS===

* [[Exécution de votre application iOS sur un périphérique iOS|Exécution sur votre périphérique connecté]]

===Préparation du déploiement des apps signées===

* [[Déploiement de votre application iOS pour une distribution Ad-hoc|Déploiement pour une distribution Ad-hoc]]
* [[Déploiement de votre application iOS pour soumission à l'App Store|Soumission à l'App Store]]

===Voir aussi===

* [[Aide Expert mobile Android|Aide Expert mobile Android]]

Installation des outils de ligne de commande Xcode sur un Mac

2025-05-28T09:34:18Z

Yukikoi : 1 révision importée : LOC-23438

{{Parent|Développement d'applications MacOS}}
{{Parent|Développement d'applications mobiles iOS}}
{{Parent|Aide Expert mobile iOS}}

Les outils de ligne de commande Xcode sont fournis par Apple sous forme de package autonome pour développer des applications macOS et iOS. Ils offrent un moyen de réaliser des tâches de développement à partir de la ligne de commande en utilisant des commandes de style UNIX sans imposer l'EDI Xcode.

==Vérification de l'installation des outils de ligne de commande Xcode==

Avant d'installer les outils de ligne de commande Xcode, vérifiez s'ils ne sont pas déjà installés sur votre système macOS. Une méthode simple consiste à ouvrir l'application Terminal et à exécuter n'importe quel outil de ligne de commande reconnu, par exemple <code>gcc</code>.

Si les outils de ligne de commande Xcode ne sont pas installés, macOS vous demandera de le faire.

[[File:Xcode command line tools install prompt.png|link=|400px]]

==Vérification de la version des outils de ligne de commande Xcode==

Depuis Xcode 6.1, les outils de ligne de commande Xcode sont fournis avec Xcode. Par conséquent, si vous disposez d'une version récente de Xcode, vous pouvez vérifier la version des outils de ligne de commande Xcode dont vous disposez en procédant comme suit :

# Démarrez Xcode.
# Choisissez {{Menu|Preferences}} dans le menu {{Menu|Xcode}}.
#:[[File:Xcode menu, Preferences.png|link=|300px]]
# Dans la fenêtre '''Emplacements''', vérifiez l'option '''Outils de ligne de commande''', qui indique la version de Xcode avec laquelle les outils de ligne de commande ont été installés.
#:[[File:Xcode Locations window command line version.png|link=]]

Une façon de vérifier la version des outils de ligne de commande Xcode sans exiger Xcode consiste à exécuter la commande suivante dans l'application Terminal :

xcode-select --version

==Installation des outils de ligne de commande Xcode==

Une option consiste à installer Xcode car, depuis la version 6.1, il inclut les outils de ligne de commande Xcode.

En revanche, si vous voulez uniquement les outils de ligne de commande Xcode, vous pouvez installer une version autonome de la façon suivante :

* En exécutant n'importe quel outil de ligne de commande reconnu dans l'application Terminal, par exemple <code>gcc</code>, puis en cliquant sur '''Installer''' dans la fenêtre d'invite.
* Sur le Web :

#Accédez à la page [https://developer.apple.com/download/all/ https://developer.apple.com/download/all/] et identifiez-vous.
#Recherchez la version des outils de ligne de commande que vous voulez télécharger.
#Cliquez sur le bouton '''Afficher les détails''' et téléchargez le fichier <code>.dmg</code>.

==Rubrique suivante==

* [[Installation de Platform Assistant sur un Mac|Installation de Platform Assistant]]

==Voir aussi==

* [[Travailler avec un Mac et un PC|Travailler avec un Mac et un PC]]
* [[Installation de Xcode sur un Mac|Installation de Xcode sur un Mac]]
* [[Prérequis de plate-forme FireMonkey|Prérequis de plate-forme FireMonkey]]

[[Category:IOS]]
[[Category:OS X]]
[[Category:XE4]]
[[Category:AMMigrate]]

Extension de l'EDI par l'utilisation de l'API Tools

2025-05-28T09:34:18Z

Yukikoi : 1 révision importée : LOC-23438

{{Parent|Guide du concepteur de composants VCL - Index}}

Vous pouvez étendre et personnaliser l'EDI de {{Product}} avec vos propres éléments de menu, boutons de barres d'outils, experts de création de fiches dynamiques, et de nombreux autres éléments en utilisant l'API Tools.

L'API Tools est un ensemble d'une centaine d'interfaces qui interagissent et contrôlent l'EDI, y compris le menu principal, les barres d'outils, les listes principales d'actions et d'images, les tampons internes de l'éditeur de code source, les liaisons et les macros clavier, les fiches et leurs composants dans le Concepteur de fiches, le débogueur et le processus en cours de débogage, l'achèvement de code, la vue des messages et la liste de tâches.

Pour étendre l'EDI avec de nouvelles fonctionnalités à l'aide de l'API Tools :

# [[#Création ou extension d'un package en vue d'étendre l'EDI|Créez un package et configurez-le pour étendre l'EDI]]. Vous pouvez également utiliser un package existant.
# [[#Implémentation de la logique de votre extension d'EDI|Implémentez la logique de votre extension d'EDI]].
# [[#Installation de votre package d'extension dans l'EDI|Installez votre extension sur l'EDI]].

==Création ou extension d'un package en vue d'étendre l'EDI==

Pour étendre l'EDI à l'aide de l'API Tools, vous devez d'abord [[Création ou extension d'un package pour utiliser l'API Tools|créer ou étendre un package pour qu'il puisse utiliser l'API Tools]].

Lorsque vous disposez d'un package, vous pouvez implémenter votre code en [[Utilisation des modules de données|utilisant un module de données]]. [[Création et modification de modules de données standard|Ajoutez un module de données]] à votre package, [[Définition de l'affinité de framework pour un module de données|modifiez son affinité de framework]] pour la VCL, puis utilisez ses événements [[lib_fr:System.Classes.TDataModule.OnCreate|OnCreate]] et [[lib_fr:System.Classes.TDataModule.OnDestroy|OnDestroy]] pour définir le code qui crée et détruit votre extension de l'EDI.

Vous pouvez également définir votre extension dans une unité de votre package ou dans le fichier de code source principal de votre package.

==Implémentation de la logique de votre extension de l'EDI==

Le code de votre package peut [[Accès aux services de l'API Tools|utiliser les services fournis par l'API Tools]]. Chaque service est une interface qui présente un ensemble de fonctions associées. Les divers services donnent accès à [[Editeur de code|l'éditeur de code]], au [[Concepteur de fiches|Concepteur de fiches]], au débogueur, etc.

En outre, vous pouvez [[Utilisation d'interfaces spéciales pour étendre l'EDI|utiliser des interfaces spéciales]] pour implémenter certaines fonctionnalités, telles que les experts, notificateurs, créateurs, modules, éditeurs et autres.

Toutes les interfaces de l'API Tools sont déclarées dans les unités qui sont disponibles dans {{Path|{{InstallPath}}\source\ToolsAPI}}. Vous pouvez contrôler le contenu de ces unités pour découvrir de nouvelles façons d'étendre l'EDI. La [[lib_fr:Main Page|documentation de référence de la bibliothèque]] ne fournit généralement pas de documentation de référence de l'API Tools. Cependant, il existe une documentation de référence pour l'unité [[lib_fr:PlatformAPI|PlatformAPI]] de l'API Tools.

===Différences entre les interfaces native et ouverte de l'API Tools===

Les interfaces appartiennent à deux catégories de base : Vous pouvez les distinguer par le préfixe utilisé dans le nom de type :

* L'architecture NTA (Native Tools API, API outils natifs) procure un accès direct à des objets réels de l'EDI, par exemple l'objet [[lib_fr:Vcl.Menus.TMainMenu|TMainMenu]] de l'EDI. Lorsqu'il a recours à ces interfaces, l'expert doit utiliser les packages de {{Product}}, cela signifie également que l'expert est lié à une version spécifique de l'EDI. L'expert peut se trouver dans un package de conception ou dans une DLL utilisant des packages d'exécution.
* L'architecture OTA (Open Tools API) ne nécessite pas de packages et accède à l'EDI uniquement via des interfaces. En théorie, vous pouvez concevoir un expert dans tout langage prenant en charge les interfaces de style COM, dans la mesure où vous pouvez aussi utiliser les conventions d'appel de {{Delphi}} et les types {{Delphi}} comme AnsiString. Les interfaces OTA ne procurent pas un accès complet à l'EDI, mais presque toutes les fonctionnalités de l'API Tools sont accessibles via des interfaces OTA. Si un expert n'utilise que des interfaces OTA, il est possible d'écrire une DLL qui ne dépend pas d'une version spécifique de l'EDI.

===Conventions à suivre lors de l'extension de l'EDI===

L'API Tools vous permet d'étendre l'EDI de nombreuses façons. Lorsque vous étendez l'EDI, assurez-vous que vos extensions s'intègrent parfaitement dans l'EDI et n'empiètent pas sur ses fonctionnalités principales.

Voici quelques conventions que vous devez suivre lorsque vous étendez l'EDI :

* Si vous [[Ajout d'un élément au menu principal de l'EDI|fournissez des éléments de menu]] pour ouvrir des outils externes, ajoutez-les au menu '''Outils'''.
* Si vous fournissez des éléments de menu pour ouvrir des ressources d'aide :
** Si vous fournissez une seule entrée de menu Aide, placez-la dans {{Menu|Help > Third-Party Help}} qui affiche le nom de votre produit.
** Si vous fournissez plusieurs éléments du menu Aide (par exemple, une entrée pour l'aide hors ligne et une entrée pour l'aide en ligne), placez une entrée de menu dans {{Menu|Help > Third-Party Help}} qui affiche le nom de votre produit, puis incluez vos éléments de menu Aide en tant qu'éléments enfant de menu de cette entrée de menu Aide.

: Voir :

<l s="delphi" />

:
:* Exemple de code [[Samp:Third-Party Help Menu Item (Delphi)|Third-Party Help Menu Item ({{Delphi}}) (EN)]]

<l e="delphi" />
<l s="cpp" />

:
:* Exemple de code [[Samp:Third-Party Help Menu Item (C++)|Third-Party Help Menu Item (C++) (EN)]]

<l e="cpp" />

===Les extensions de l'EDI doivent prendre en charge les grandes adresses mémoire===

L'EDI est [https://msdn.microsoft.com/en-us/library/windows/desktop/ee418798%28v=vs.85%29.aspx#specifying_large-address-aware_when_building orienté grandes adresses (EN)], ce qui lui permet d'utiliser jusqu'à 4 Go de mémoire. Pour cette raison, les extensions de l'EDI doivent également être en mesure de gérer les grandes adresses mémoire.

La plupart des extensions de l'EDI doivent prendre en charge les grandes adresses mémoire. La liste suivante contient des conseils de détection de problèmes dans votre extension d'EDI :

* Ne transtypez pas les [[Pointeurs et types pointeur (Delphi)|pointeurs]] en [[lib_fr:System.Integer|Integer]], transtypez-les en [[lib_fr:System.NativeInt|NativeInt]] à la place.
* Ne déclarez pas les handles en tant qu'Integer, utilisez [[lib_fr:System.THandle|THandle]] à la place.
* Lorsque vous utilisez la [https://msdn.microsoft.com/en-us/library/windows/desktop/ms644950%28v=vs.85%29.aspx fonction Windows SendMessage (EN)], ne transtypez pas les paramètres en Integer, utilisez à la place les [https://msdn.microsoft.com/en-us/library/windows/desktop/aa383751%28v=vs.85%29.aspx types de données Windows (EN)] LPARAM et WPARAM.

==Installation de votre package d'extension dans l'EDI==

Pour utiliser votre package une fois qu'il est prêt, vous devez [[Compilation de packages|le compiler]] et [[Installation de packages de composants|le charger dans l'EDI]].

==Interface IOTAVersionSKUInfoService==

Cette interface vous permet d'obtenir la liste des plates-formes installées, la SKU, et de savoir si l'EDI actuellement exécutée est une version Trial.

<code> property SKU: Integer read GetSKU; </code>

<code> property IsProductTrial: Boolean read GetIsProductTrial; </code>

<code> property Platforms: TArray<TPlatformIds> read GetPlatforms; </code>

Les identificateurs de SKU sont documentés dans le fichier ToolsAPI.pas dans lequel l'interface est définie.

Vous pouvez utiliser <code>PlatformAPI.PlatformIDToName</code> pour convertir les ID de plate-forme en nom lisible à l'oeil nu. Les ID sont documentés dans System.Classes.

La liste des personnalités installées peut être demandée à [[Accès aux services de l'API Tools|ToolsAPI]] via l'interface IOTAPersonalityServices.

==Rubriques==

* [[Création ou extension d'un package pour utiliser l'API Tools|Création ou extension d'un package pour utiliser l'API Tools]]
* [[Accès aux services de l'API Tools|Accès aux services de l'API Tools]]
* [[Utilisation d'interfaces spéciales pour étendre l'EDI|Utilisation d'interfaces spéciales pour étendre l'EDI]]
* [[Utilisation des styles de l'EDI dans des Plugins tierces parties|Utilisation des styles de l'EDI dans des Plugins tierces parties]]
* [[Prise en charge de ToolsAPI pour l'éditeur de code|Prise en charge de ToolsAPI pour l'éditeur de code]]

==Voir aussi==

* [[Utilisation des packages et des composants - Index|Utilisation des packages et des composants]]
* [[Accessibilité des composants au moment de la conception|Accessibilité des composants au moment de la conception]]

[[Category:Guide du développeur Windows]]
[[Category:Index des rubriques]]
[[Category:Delphi]]
[[Category:C++]]

Routines intrinsèques de Delphi

2025-05-28T09:34:18Z

Yukikoi : 1 révision importée : LOC-23438

{{Parent|Catégories de l'API - Index}}
Cette rubrique liste les routines intrinsèques de Delphi uniquement, exposées par l'unité <code>System</code>. Ces routines intrinsèques sont réellement gérées par le compilateur, au lieu de la bibliothèque d'exécution. Le tableau spécifie également quel compilateur prend en charge chaque fonction

{| border="1" frame="hsides" rules="rows"
|-
! ''' Routine '''
! ''' Description '''
! [[DCC32.EXE, le compilateur en ligne de commande Delphi|DCC32]]
! [[DCC64.EXE, le compilateur en ligne de commande Delphi 64 bits|DCC64]]
![[DCCOSX64.EXE, le compilateur Delphi pour macOS 64 bits|DCCOSX64]]
! [[DCCAARM.EXE, le compilateur Delphi pour Android|DCCAARM]]
! [[DCCIOSARM64.EXE, le compilateur Delphi pour le périphérique iOS 64 bits|DCCIOSARM64]]
![[DCCLINUX64.EXE, le compilateur Delphi pour Linux|DCCLINUX64]]
![[DCCAARM64.EXE, le compilateur Delphi pour Android 64 bits|DCCAARM64]]
![[DCCOSXARM64.EXE, le compilateur Delphi pour le périphérique macOS 64 bits|DCCOSXARM64]]
![[DCCIOSSIMARM64.EXE, le compilateur Delphi pour le simulateur iOS 64 bits ARM|DCCIOSSIMARM64]]
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.Abs|System.Abs]]
| style="text-align: left; vertical-align: top;" |
Renvoie une valeur absolue.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.Addr|System.Addr]]
| style="text-align: left; vertical-align: top;" |
Renvoie un pointeur sur un objet spécifié.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.Append|System.Append]]
| style="text-align: left; vertical-align: top;" |
Prépare un fichier existant pour l'ajout de texte.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.Assert|System.Assert]]
| style="text-align: left; vertical-align: top;" |
Teste si une expression booléenne vaut true.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.Assign|System.Assign]]
| style="text-align: left; vertical-align: top;" |
Associe le nom d'un fichier externe à une variable fichier.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.Assigned|System.Assigned]]
| style="text-align: left; vertical-align: top;" |
Teste un pointeur nil (non assigné) ou une variable procédurale.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.AssignFile|System.AssignFile]]
| style="text-align: left; vertical-align: top;" |
Associe le nom d'un fichier externe à une variable fichier.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.AtomicCmpExchange|System.AtomicCmpExchange]]
| style="text-align: left; vertical-align: top;" |
AtomicCmpExchange est utilisé pour comparer et échanger des valeurs en mémoire.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.AtomicDecrement|System.AtomicDecrement]]
| style="text-align: left; vertical-align: top;" |
AtomicDecrement est utilisé pour décrémenter les valeurs en mémoire.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.AtomicExchange|System.AtomicExchange]]
| style="text-align: left; vertical-align: top;" |
AtomicExchange est utilisé pour échanger les valeurs en mémoire.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.AtomicIncrement|System.AtomicIncrement]]
| style="text-align: left; vertical-align: top;" |
AtomicDecrement est utilisé pour incrémenter les valeurs en mémoire.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.BlockRead|System.BlockRead]]
| style="text-align: left; vertical-align: top;" |
Lit un ou plusieurs enregistrements d'un fichier ouvert et les place dans une variable.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.BlockWrite|System.BlockWrite]]
| style="text-align: left; vertical-align: top;" |
Ecrit un ou plusieurs enregistrements d'une variable mémoire dans un fichier ouvert.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.Break|System.Break]]
| style="text-align: left; vertical-align: top;" |
Provoque l'interruption d'une boucle for, while ou repeat.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.BuiltInArcTan|System.BuiltInArcTan]]
| style="text-align: left; vertical-align: top;" |
Calcule l'arc-tangente de la valeur donnée.
|{{V}}
|
|
|
|
|
|
|
|
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.BuiltInArcTan2|System.BuiltInArcTan2]]
| style="text-align: left; vertical-align: top;" |
Calcule l'angle et le quadrant d'arc-tangente de la valeur donnée.
|{{V}}
|
|
|
|
|
|
|
|
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.BuiltInCos|System.BuiltInCos]]
| style="text-align: left; vertical-align: top;" |
Calcule le cosinus d'un angle.
|{{V}}
|
|
|
|
|
|
|
|
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.BuiltInLn|System.BuiltInLn]]
| style="text-align: left; vertical-align: top;" |
Calcule le logarithme naturel d'une expression réelle.
|{{V}}
|
|
|
|
|
|
|
|
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.BuiltInLnXPlus1|System.BuiltInLnXPlus1]]
| style="text-align: left; vertical-align: top;" |
Calcule le logarithme naturel de (X+1).
|{{V}}
|
|
|
|
|
|
|
|
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.BuiltInLog10|System.BuiltInLog10]]
| style="text-align: left; vertical-align: top;" |
Calcule le logarithme en base 10.
|{{V}}
|
|
|
|
|
|
|
|
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.BuiltInLog2|System.BuiltInLog2]]
| style="text-align: left; vertical-align: top;" |
Calcule le logarithme en base 2.
|{{V}}
|
|
|
|
|
|
|
|
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.BuiltInSin|System.BuiltInSin]]
| style="text-align: left; vertical-align: top;" |
Calcule le sinus de l'angle.
|{{V}}
|
|
|
|
|
|
|
|
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.BuiltInSqrt|System.BuiltInSqrt]]
| style="text-align: left; vertical-align: top;" |
Calcule la racine carrée de X.
|{{V}}
|
|
|
|
|
|
|
|
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.BuiltInTan|System.BuiltInTan]]
| style="text-align: left; vertical-align: top;" |
Calcule la tangente de X.
|{{V}}
|
|
|
|
|
|
|
|
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.Chr|System.Chr]]
| style="text-align: left; vertical-align: top;" |
Renvoie le caractère correspondant à une valeur ASCII.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.Close|System.Close]]
| style="text-align: left; vertical-align: top;" |
Ferme l'association entre une variable fichier et un fichier externe.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.CloseFile|System.CloseFile]]
| style="text-align: left; vertical-align: top;" |
Ferme l'association entre une variable fichier et un fichier disque externe.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.Concat|System.Concat]]
| style="text-align: left; vertical-align: top;" |
Concatène deux chaînes ou plus.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.Continue|System.Continue]]
| style="text-align: left; vertical-align: top;" |
Provoque le passage du contrôle de l'exécution à l'itération suivante dans une instruction for, while ou repeat.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.Copy|System.Copy]]
| style="text-align: left; vertical-align: top;" |
Renvoie une sous-chaîne d'une chaîne ou un segment d'un tableau dynamique.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.Dec|System.Dec]]
| style="text-align: left; vertical-align: top;" |
Décrémente une variable de 1 ou de N.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.Default|System.Default]]
| style="text-align: left; vertical-align: top;" |
Renvoie la représentation zéro de l'identificateur de type <code>T</code>.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.Delete|System.Delete]]
| style="text-align: left; vertical-align: top;" |
Retire une sous-chaîne d'une chaîne.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.Dispose|System.Dispose]]
| style="text-align: left; vertical-align: top;" |
Libère la mémoire allouée à une variable dynamique.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.Eof|System.Eof]]
| style="text-align: left; vertical-align: top;" |
Détermine si la position en cours du pointeur se trouve en fin de fichier.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.Eoln|System.Eoln]]
| style="text-align: left; vertical-align: top;" |
Détermine si le pointeur de fichier se trouve en fin de ligne.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.Erase|System.Erase]]
| style="text-align: left; vertical-align: top;" |
Supprime un fichier externe.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.Exclude|System.Exclude]]
| style="text-align: left; vertical-align: top;" |
Retire un élément d'un ensemble {{Delphi}}.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.Exit|System.Exit]]
| style="text-align: left; vertical-align: top;" |
Quitte la procédure en cours.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.Fail|System.Fail]]
| style="text-align: left; vertical-align: top;" |
Annule la construction d'un objet (modèle d'objet Turbo Pascal).
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.FilePos|System.FilePos]]
| style="text-align: left; vertical-align: top;" |
Renvoie la position en cours dans un fichier.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.FileSize|System.FileSize]]
| style="text-align: left; vertical-align: top;" |
Renvoie le nombre d'enregistrements d'un fichier.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.FillChar|System.FillChar]]
| style="text-align: left; vertical-align: top;" |
Remplit des octets contigus avec une valeur spécifiée.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.Finalize|System.Finalize]]
| style="text-align: left; vertical-align: top;" |
Désinitialise une variable allouée dynamiquement.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.Flush|System.Flush]]
| style="text-align: left; vertical-align: top;" |
Efface le tampon associé à un fichier texte ouvert en sortie.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.FreeMem|System.FreeMem]]
| style="text-align: left; vertical-align: top;" |
FreeMem libère un bloc de mémoire.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.GetDir|System.GetDir]]
| style="text-align: left; vertical-align: top;" |
Renvoie le répertoire en cours.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.GetMem|System.GetMem]]
| style="text-align: left; vertical-align: top;" |
GetMem alloue un bloc de mémoire.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.GetTypeKind|System.GetTypeKind]]
| style="text-align: left; vertical-align: top;" |
Renvoie les informations de type à l'exécution (RTTI) d'un type donné.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.Halt|System.Halt]]
| style="text-align: left; vertical-align: top;" |
Initie la terminaison anormale d'un programme.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.HasWeakRef|System.HasWeakRef]]
| style="text-align: left; vertical-align: top;" |
Renvoie '''True''' si le type '''T''' est de type '''WEAKREF'''.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.Hi|System.Hi]]
| style="text-align: left; vertical-align: top;" |
Renvoie l'octet de poids fort de X comme valeur non signée.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.High|System.High]]
| style="text-align: left; vertical-align: top;" |
Renvoie la plus grande valeur dans l'étendue d'un argument.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.Inc|System.Inc]]
| style="text-align: left; vertical-align: top;" |
Incrémente une valeur ordinale (X) de 1 ou de N.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.Include|System.Include]]
| style="text-align: left; vertical-align: top;" |
Ajoute un élément à un ensemble {{Delphi}}.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.Initialize|System.Initialize]]
| style="text-align: left; vertical-align: top;" |
Initialise une variable allouée dynamiquement.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.Insert|System.Insert]]
| style="text-align: left; vertical-align: top;" |
Insère une sous-chaîne dans une chaîne commençant au point spécifié.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.IsConstValue|System.IsConstValue]]
| style="text-align: left; vertical-align: top;" |
Renvoie le type de données booléen d'une <code>valeur</code>.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.IsManagedType|System.IsManagedType]]
| style="text-align: left; vertical-align: top;" |
Renvoie true si <code>T</code> est une <code>interface</code>, une <code>chaîne</code>, un <code>tableau dynamique</code> ou un enregistrement contenant ces éléments. Une classe contenant un type géré renvoie false.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.Length|System.Length]]
| style="text-align: left; vertical-align: top;" |
Renvoie le nombre de caractères d'une chaîne ou d'éléments d'un tableau.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.Lo|System.Lo]]
| style="text-align: left; vertical-align: top;" |
Renvoie l'octet de poids faible de l'argument X.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.Low|System.Low]]
| style="text-align: left; vertical-align: top;" |
Renvoie la valeur la moins élevée d'une étendue.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.MemoryBarrier|System.MemoryBarrier]]
| style="text-align: left; vertical-align: top;" |
Applique une contrainte de classement sur les opérations en mémoire.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.MulDivInt64|System.MulDivInt64]]
| style="text-align: left; vertical-align: top;" |
Renvoie la valeur de cette expression : {{Code|Int64((Int128(AValue) * Int128(AMul)) div Int128(ADiv))}}.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.New|System.New]]
| style="text-align: left; vertical-align: top;" |
Crée une nouvelle variable dynamique et initialise P de telle façon qu'il pointe dessus.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.Odd|System.Odd]]
| style="text-align: left; vertical-align: top;" |
Renvoie true si l'argument est un nombre impair.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.Ord|System.Ord]]
| style="text-align: left; vertical-align: top;" |
Renvoie la valeur ordinale d’une expression de type ordinal.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.Pi|System.Pi]]
| style="text-align: left; vertical-align: top;" |
Renvoie 3.1415926535897932385
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.Pred|System.Pred]]
| style="text-align: left; vertical-align: top;" |
Renvoie le prédécesseur de l'argument.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.Ptr|System.Ptr]]
| style="text-align: left; vertical-align: top;" |
Convertit l'adresse spécifiée en pointeur.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.Read|System.Read]]
| style="text-align: left; vertical-align: top;" |
Read lit les données d'un fichier.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.Readln|System.Readln]]
| style="text-align: left; vertical-align: top;" |
Lit une ligne de texte dans un fichier.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.ReallocMem|System.ReallocMem]]
| style="text-align: left; vertical-align: top;" |
ReallocMem réalloue un bloc de mémoire.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.Rename|System.Rename]]
| style="text-align: left; vertical-align: top;" |
Renomme un fichier externe.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.Reset|System.Reset]]
| style="text-align: left; vertical-align: top;" |
Ouvre un fichier existant.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.ReturnAddress|System.ReturnAddress]]
| style="text-align: left; vertical-align: top;" |
Renvoie l'adresse de retour de la fonction actuellement exécutée.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.Rewrite|System.Rewrite]]
| style="text-align: left; vertical-align: top;" |
Crée puis ouvre un nouveau fichier.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.Round|System.Round]]
| style="text-align: left; vertical-align: top;" |
Renvoie la valeur de X arrondie au plus proche entier.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.RunError|System.RunError]]
| style="text-align: left; vertical-align: top;" |
Interrompt l'exécution et génère une erreur d'exécution.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.Seek|System.Seek]]
| style="text-align: left; vertical-align: top;" |
Déplace la position en cours dans un fichier vers le composant spécifié.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.SeekEof|System.SeekEof]]
| style="text-align: left; vertical-align: top;" |
Renvoie le statut de fin de fichier, en ignorant les espaces.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.SeekEoln|System.SeekEoln]]
| style="text-align: left; vertical-align: top;" |
Renvoie l'état de fin de ligne d'un fichier, en ignorant les espaces.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.SetLength|System.SetLength]]
| style="text-align: left; vertical-align: top;" |
Définit la longueur d'une variable chaîne ou tableau dynamique.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.SetString|System.SetString]]
| style="text-align: left; vertical-align: top;" |
Définit le contenu et la longueur de la chaîne donnée.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.SetTextBuf|System.SetTextBuf]]
| style="text-align: left; vertical-align: top;" |
Assigne un tampon d'E/S à un fichier texte.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.SizeOf|System.SizeOf]]
| style="text-align: left; vertical-align: top;" |
Renvoie le nombre d'octets occupés par une variable ou un type.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.Slice|System.Slice]]
| style="text-align: left; vertical-align: top;" |
Renvoie une sous-section d'un tableau.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.Sqr|System.Sqr]]
| style="text-align: left; vertical-align: top;" |
Renvoie le carré d'un nombre.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.Str|System.Str]]
| style="text-align: left; vertical-align: top;" |
Formate une chaîne et la renvoie dans une variable.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.Succ|System.Succ]]
| style="text-align: left; vertical-align: top;" |
Renvoie le successeur de l'argument.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.Swap|System.Swap]]
| style="text-align: left; vertical-align: top;" |
Inverse les octets de poids fort avec les octets de poids faible d'un entier ou d'un mot.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.Trunc|System.Trunc]]
| style="text-align: left; vertical-align: top;" |
Tronque un nombre réel en entier.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.Truncate|System.Truncate]]
| style="text-align: left; vertical-align: top;" |
Supprime tous les enregistrements situés après la position en cours dans le fichier.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.TypeHandle|System.TypeHandle]]
| style="text-align: left; vertical-align: top;" |
Renvoie les informations de type à l'exécution (RTTI) d'un type donné.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.TypeInfo|System.TypeInfo]]
| style="text-align: left; vertical-align: top;" |
Renvoie les informations de type à l'exécution (RTTI) d'un type donné.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.TypeOf|System.TypeOf]]
| style="text-align: left; vertical-align: top;" |
Routine désapprouvée.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.Val|System.Val]]
| style="text-align: left; vertical-align: top;" |
Convertit une chaîne en sa représentation numérique.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.VarArrayRedim|System.VarArrayRedim]]
| style="text-align: left; vertical-align: top;" |
Redimensionne un tableau de Variants.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.VarCast|System.VarCast]]
| style="text-align: left; vertical-align: top;" |
Convertit un variant dans le type spécifié.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.VarClear|System.VarClear]]
| style="text-align: left; vertical-align: top;" |
Vide un Variant afin qu'il soit non assigné.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.VarCopy|System.VarCopy]]
| style="text-align: left; vertical-align: top;" |
Copie un Variant dans un autre Variant.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.Write|System.Write]]
| style="text-align: left; vertical-align: top;" |
Ecrit dans un fichier typé ou dans un fichier texte.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|-
| style="text-align: left; vertical-align: top;" |
[[lib_fr:System.Writeln|System.Writeln]]
| style="text-align: left; vertical-align: top;" |
Ecrit dans un fichier texte et ajoute un marqueur de fin de ligne.
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|{{V}}
|}

==Voir aussi==

*[[Catégories de l'API - Index|Catégories de l'API - Index]]

[[Category:Référence RAD Studio]]
[[Category:Référence RTL]]
[[Category:AMMigrate]]

Fichier unité compilé Delphi (*.dcu)

2025-05-28T09:34:17Z

Yukikoi : 1 révision importée : LOC-23438

{{Parent|Types de fichiers - Index}}

Lorsque vous construisez un projet {{Delphi}}, {{Product}} génère un fichier unité compilé (DCU) {{Delphi}} pour chaque [[Unité|unité]] de votre projet. Vous n'avez pas besoin d'ouvrir ces fichiers binaires ou de les distribuer avec votre projet.

Un fichier unité compilé {{Delphi}} est un fichier de sortie intermédiaire du compilateur, produit à partir du code source de chaque unité de votre projet. Les fichiers unité compilés {{Delphi}} permettent une compilation et une liaison rapides.

Vous pouvez lier un projet {{Delphi}} à des fichiers unité compilés {{Delphi}} pour toute [[Plates-formes cible supportées|plate-forme cible sprise en charge]].

Lorsque vous construisez votre projet {{Delphi}}, vos fichiers unité compilés {{Delphi}} sont générés par défaut dans {{Path|{{Chemin projet}}\{{Placeholder|projet}}\{{Placeholder|plate-forme}}\{{Placeholder|configuration de construction}}}} avec {{Path|{{Placeholder|unité}}.dcu}} comme nom de fichier.

{{Note|Le fichier DCU doit se trouver dans le même répertoire que le fichier DLL que vous êtes en train de déboguer ou dans le chemin de recherche des symboles de débogage. Sinon, le débogueur ne trouvera pas les symboles de débogage. Cela ne s'applique qu'aux plates-formes Win32 et Win64. Pour changer le répertoire de sortie du DCU, sélectionnez {{Menu|Projet > Options > [[Compilateur Delphi|Compilateur Delphi]]}}. Pour changer le chemin de recherche des symboles de débogage, sélectionnez {{Menu|Projet > Options > Débogueur > [[Tables de symboles du débogueur|Tables de symboles]]}}.}}

==Voir aussi==

* [[Fichier package compilé Delphi|Fichier package compilé Delphi (*.dcp)]]
* [[Fichiers de packages créés lors d'une compilation|Fichiers de packages créés lors d'une compilation]]

[[Category:Référence EDI]]
[[Category:XE7]]
[[Category:AMMigrate]]

Fichier package compilé Delphi (*.dcp)

2025-05-28T09:34:17Z

Yukikoi : 1 révision importée : LOC-23438

Bloc d'environnement du débogueur

2025-05-28T09:34:16Z

Yukikoi : 1 révision importée : LOC-23438

{{Parent|Débogueur}}

{{Menu|Projet > Options > Débogueur > Bloc d'environnement}} 
{{Menu|Exécuter > Paramètres > Débogueur > Bloc d'environnement}}

Dans cette page, vous pouvez indiquer les variables d'environnement qui sont transmises à votre application lorsque vous la déboguez.

{{Attention| Cette fonctionnalité est uniquement prise en charge pour les applications Win32.}}

{| border="1" frame="hsides" rules="rows"
|-
! '''Options'''
! '''Description'''
|- valign="top"
|
Cible, Appliquer, Enregistrer
|
Voir [[Options de la cible|Options de la cible]].
|- valign="top"
|
Eléments communs
|
Voir [[Eléments communs des pages Options de projet|Eléments communs des pages Options de projet]].
|}

{| border="1" frame="hsides" rules="rows"
|-
! '''Elément'''
! '''Description'''
|- valign="top"
|
Variables système
|
Enumère toutes les variables d'environnement définies au niveau du système ainsi que leurs valeurs. Vous ne pouvez pas supprimer une variable système existante mais vous pouvez la remplacer.
|- valign="top"
|
Ajouter redéfinition système
|
Affiche la boîte de dialogue de '''[[Redéfinir la variable système/Nouvelle variable utilisateur/Modifier la variable utilisateur|redéfinition de la variable système]]''', dans laquelle vous pouvez modifier une variable système afin de créer une redéfinition de l'utilisateur. Ce bouton est désactivé tant que vous n'avez pas sélectionné une variable dans la liste '''Variables système'''.
|- valign="top"
|
Redéfinitions utilisateur
|
Liste toutes les redéfinitions effectuées par l'utilisateur avec leurs valeurs. Jusqu'à ce que vous les supprimiez, les redéfinitions utilisateur ont priorité sur les variables système existantes.
|- valign="top"
|
Nouvelle
|
Affiche la boîte de dialogue '''[[Redéfinir la variable système/Nouvelle variable utilisateur/Modifier la variable utilisateur|Nouvelle variable utilisateur]]''', dans laquelle vous pouvez créer une nouvelle redéfinition utilisateur d'une variable système. Entrez le nom de la variable système et la nouvelle valeur que vous voulez affecter.
|- valign="top"
|
Modifier
|
Affiche la boîte de dialogue de '''[[Redéfinir la variable système/Nouvelle variable utilisateur/Modifier la variable utilisateur|modification de variable utilisateur]]''', dans laquelle vous pouvez modifier la redéfinition utilisateur actuellement sélectionnée dans la liste '''Redéfinitions utilisateur'''.
|- valign="top"
|
Supprimer
|
Supprime la redéfinition utilisateur sélectionnée dans la liste '''Redéfinitions utilisateur'''.
|- valign="top"
|
Inclure les variables système
|
Transmet les variables d'environnement du système à l'application que vous êtes en train de déboguer. Si elle n'est pas cochée, seules les redéfinitions utilisateur sont transmises à votre application.
|}

==Voir aussi==

* [[Présentation du débogage|Présentation du débogage]]
* [[Débogueur|Débogueur]]
* [[Tables de symboles du débogueur|Tables de symboles du débogueur]]
* [[Variables d'environnement|Variables d'environnement]]

[[Category:Référence RAD Studio]]
[[Category:AMMigrate]]

Création d'une app Android

2025-05-28T09:34:16Z

Yukikoi : 1 révision importée : LOC-23438

{{Parent|Développement d'applications mobiles Android}}

__TOC__
Cette page décrit comment développer des applications multi-périphériques ciblant la plate-forme Android. Voir '''[[Développement d'applications mobiles Android|Développement d'applications mobiles Android]]''' pour les rubriques qui ne sont pas spécifiques à la phase de développement, telles que la configuration de votre PC et des périphériques Android pour travailler avec {{Variables|Product}}.

'''Pour créer une app multi-périphérique qui supporte Android :'''

{{Menu|Fichier > Nouveau > [[Application multi-périphérique|Application multi-périphérique]] - {{Delphi}}}} 

Puis sélectionnez un type d'application multi-périphérique dans l'expert [[Application multi-périphérique|Application multi-périphérique]].

==Restrictions relatives aux composants pour les apps {{FM}} Android==

Lors de la conception de votre app Android dans {{Variables|Product}}, vous pouvez seulement utiliser les composants qui sont pris en charge sur les périphériques Android. Lorsque Android est la [[Présentation des plates-formes cible|plate-forme cible active]] de votre projet, [[Palette d'outils#Les composants non pris en charge sont grisés|les composants non pris en charge sont grisés]] sur la '''palette d'outils'''.

==Sélecteur de style==

Dans la partie supérieure du '''[[Concepteur de fiches|Concepteur de fiches]]''' multi-périphériques réside le sélecteur de style :
[[File:StylesFormDes.png]]

Le menu déroulant du sélecteur de style liste tous les styles que vous pouvez appliquer à la vue '''maître'''.

Sélectionnez le style '''Android''' à partir du sélecteur de style pour voir toutes les propriétés des composants en fonction de la plate-forme cible.

==Sélecteur de vue==

Dans la partie supérieure du '''[[Concepteur de fiches|Concepteur de fiches]]''' multi-périphérique réside le sélecteur de vue :
[[Image:ViewsFormDes.png]]

Le menu déroulant du sélecteur de vue affiche toutes les vues disponibles pour les différentes plates-formes telles que iOS, Android, Windows et macOS.

Utilisez la fiche '''maître''' pour la conception générale de votre application. Vous pouvez ensuite [[Ajout de vues à votre projet multi-périphérique|ajouter de nouvelles vues]] à votre projet afin de personnaliser votre application pour un type de périphérique spécifique. Vous pouvez même créer de nouvelles vues personnalisées ; voir [[Ajout d'une vue personnalisée au sélecteur de vue|Ajout d'une vue personnalisée au sélecteur de vue]]. Voici les vues prédéfinies du périphérique Android :

* Téléphone Android 3.5 pouces
* Téléphone Android 4 pouces
* Téléphone Android 5 pouces
* Tablette Android 7 pouces
* Tablette Android 10 pouces
* Google Glass

{{Note|Pour de plus amples informations sur la résolution des vues prédéfinies, voir [[Ajout d'une vue personnalisée au sélecteur de vue#Spécifications d'affichage pour les vues disponibles|Spécifications d'affichage]].}}

{{Note|Sélectionnez la plate-forme cible '''Android''' pour voir tous les composants disponibles pour '''Android''', sinon ils apparaissent grisés.}}

[[Ajout de vues à votre projet multi-périphérique|Ajoutez de nouvelles vues]] à votre projet afin de personnaliser votre application pour un type de périphérique Android spécifique. Toutes les vues héritent des composants et des propriétés de la vue '''maître'''. Pour de plus amples informations, voir [[Concepteur de fiches|Concepteur de fiches]].

Si vous souhaitez personnaliser certains aspects de votre application pour tous les périphériques '''Android''', vous pouvez le faire en utilisant la fiche '''maître''', à condition de ne pas vouloir les propager au reste des plates-formes. Sinon, utilisez [[Editeur de code|l'éditeur de code]], par exemple :

<source lang="Delphi">
// You will see the changes applied at run-time.
{$IFDEF ANDROID}
SpeedButton1.StyleLookup := priortoolbutton;
{$ENDIF}</source>

Pour de plus amples informations :

*[[Tutoriel mobile : Utilisation de la disposition pour ajuster différentes tailles de fiches ou orientations (iOS et Android)|Tutoriel mobile : Utilisation de la disposition pour ajuster différentes tailles de fiches ou orientations (iOS et Android)]]
*: (Montre comment utiliser la fiche '''maître''' pour différents facteurs de forme (comme le téléphone ou la tablette) sans qu'il soit nécessaire de recourir à une vue différente pour chaque facteur de forme.)

==Utilisation des frameworks dans les applications Android==

==={{FM}}===

Le [[Introduction à la bibliothèque FireMonkey|framework {{FM}}]] convient tout particulièrement à la plate-forme cible '''Android''', et il [[Prérequis de plate-forme FireMonkey|supporte également d'autres plates-formes cible]].
{{f|vcl|

===VCL (indisponible pour Android)===

La VCL (Visual Component Library) est seulement disponible sur Windows (32 bits et 64 bits). }}

===RTL===

Certaines unités de la bibliothèque runtime (RTL) qui fournissent des fonctionnalités de base sont communes à chaque plate-forme cible prise en charge (notamment Android), telles que '''System.pas''' ou '''System.SysUtils.pas'''.

Un certain nombre d'unités RTL sont spécifiques à Android (voir [[#Android API et bibliothèques Java|Android API et bibliothèques Java]]). Ces unités sont préfixées avec la [[Noms de portées d'unités|portée d'unité]] '''Androidapi'''.

Voir aussi '''[[RTL C pour Android|RTL C pour Android]]'''.

===API Android et bibliothèques Java===

La RTL contient un certain nombre d'unités qui fournissent des interfaces {{Delphi}} à l'API native d'Android. Ces unités sont préfixées avec la portée '''Androidapi''' et sont typiquement situées dans le répertoire <code>source\rtl\android\</code> de l'installation de {{Variables|Product}}. Le framework {{FM}} s'appuie sur certaines de ces unités. Vous pouvez également les utiliser directement si vous le souhaitez.

Vous pouvez également utiliser les parties de l'API Android qui ne sont pas mappées par la RTL, ou utiliser vos propres bibliothèques Java dans votre projet :

*[[Utilisation de bibliothèques Java dans vos apps Android RAD Studio|Utilisation de bibliothèques Java dans vos apps Android {{Product}}]]
** [[Utilisation d'un ensemble personnalisé de bibliothèques Java dans vos apps Android RAD Studio|Utilisation d'un ensemble personnalisé de bibliothèques Java dans vos apps Android {{Product}}]]
** [[Utilisation des bibliothèques Java RAD Studio intégrées pour Android|Utilisation des bibliothèques Java {{Product}} intégrées pour Android]]

==Les noms de la bibliothèque Android Core ne peuvent pas être utilisés en tant que noms d'app==

Vous ne pouvez pas assigner un nom à votre projet si le nom entre en conflit avec le nom d'un fichier objet partagé de la bibliothèque core, comme <libNAME>.so.

Par exemple, vous ne pouvez pas utiliser les noms suivants comme noms de projet :

*<code>c</code> (conflit avec libc.so)
*<code>m</code> (conflit avec libm.so)
*<code>z</code> (conflit avec libz.so)
*<code>ssl</code> (conflit avec libssl.so)
*<code>ui</code> (conflit avec libui.so)
*<code>gui</code> (conflit avec libgui.so)
*<code>camera_client</code> (conflit avec camera_client.so)

Et ainsi de suite.

==Recommandations d'alignement pour les barres d'outils mobiles et les autres composants {{FM}}==

Pour garantir un comportement et une apparence identiques à la barre d'outils de votre app sur les plates-formes iOS et Android, vous devez définir des propriétés d'alignement spécifiques dans [[Inspecteur d'objets|l'inspecteur d'objets]], comme suit :

* Définissez la propriété '''Align''' pour tous les contrôles qui sont des enfants d'un '''[[lib_fr:FMX.StdCtrls.TToolBar|TToolbar]]'''. Par exemple, les valeurs suivantes sont les valeurs de la propriété '''Align''' :
*: (Left, Right, Center, Contents)
* Pour maintenir un espace entre les contrôles, ou un espace entre les bordures gauche et droite des barres d'outils, définissez les propriétés suivantes :
**[[lib_fr:FMX.Controls.TControl.Margins|Margins]] : (left, right)
**[[lib_fr:FMX.Controls.TControl.Padding|Padding]] : (left, right)
*: Par exemple, supposons que vous avez une barre d'outils avec un TLabel enfant comme titre, et deux turboboutons alignés à gauche avec un espace entre chaque bouton :
*:# Sur le [[lib_fr:FMX.StdCtrls.TToolBar|TToolbar]], définissez :
*:#* Align = Top
*:# Sur le [[lib_fr:FMX.StdCtrls.TLabel|TLabel]] enfant, définissez :
*:#* Align = Contents
*:# Placez le TLabel [[Mettre en arrière-plan|en arrière-plan en utilisant le menu contextuel]].
*:# Sur les deux [[lib_fr:FMX.StdCtrls.TSpeedButton|TSpeedButtons]] enfant, définissez :
*:#* Align = Left, Right, Center, Contents, VertCenter
*:#*: Pour les descriptions de ces propriétés, voir [[lib_fr:FMX.Types.TAlignLayout|FMX.Types.TAlignLayout]].
*:#* Margins Left = 5

* Pour formater un contrôle segmenté (TSpeedButtons stylisés avec un nom de groupe partagé) afin qu'il soit centré sur la barre d'outils :
*# Ajoutez un contrôle [[lib_fr:FMX.Layouts.TLayout|TLayout]] au TToolBar.
*# Définissez '''TLayout.Align''' sur '''Center'''.
*# Ajoutez des boutons au TLayout et définissez les propriétés d'alignement et les marges pour chaque bouton (c'est-à-dire, Align = Left, Margins = Left, Margins = Right, etc.).
*#* A titre d'exemple, voir '''[[Tutoriel mobile : Utilisation d'un composant Bouton avec différents styles (iOS et Android)|Tutoriel mobile : Utilisation d'un composant Bouton avec différents styles (iOS et Android)]]'''.
* Pour utiliser TLabel, vous devez définir TLabel.AutoSize = False, ainsi que la propriété Align.
** Pour centrer le libellé sur une barre d'outils ayant déjà des boutons, vous devez définir TLabel.Align = Contents et sélectionner '''[[Mettre en arrière-plan|Mettre en arrière-plan]]''' sur le menu contextuel.

Des règles d'alignement similaires se rapportent à d'autres contrôles. Par exemple, supposons que vous avez ajouté un [[lib_fr:FMX.StdCtrls.TSwitch|TSwitch]] à un élément [[lib_fr:FMX.ListBox.TListBox|ListBox]]. Pour que le composant TSwitch soit aligné à droite et centré verticalement, définissez les propriétés suivantes pour TSwitch :

* Align= Right
* Margins Right = 5

==Utilisation de fontes personnalisées dans les applications Android==

Vous pouvez utiliser des fontes personnalisées dans vos apps Android. Vous pouvez par exemple les utiliser comme icônes dans vos applications mobiles. Par rapport aux fichiers d'images raster, les fontes True Type présentent l'avantage d'être légères et basées sur des vecteurs. Elles peuvent donc être facilement mises à l'échelle pour des résolutions élevées. Vous pouvez installer vos propres fontes personnalisées dans la bibliothèque de fontes de votre système de développement. Ces fontes personnalisées seront ensuite disponibles dans l'EDI et sélectionnables durant la conception.

Toutefois, quand vous déployez l'app sur un périphérique cible à ce stade, les fontes de l'app sont rendues en utilisant seulement les fontes disponibles sur le périphérique. Vous devez ajouter la fonte à votre projet en utilisant le [[Gestionnaire de déploiement|Gestionnaire de déploiement]] pour que les fontes que vous voyez dans l'EDI lors de la conception soient copiées sur le périphérique.

Voici les étapes de base pour incorporer une fonte personnalisée dans votre app Android :

# Installez la fonte personnalisée sur votre système Windows.
#* Pour des instructions, voir '''Aide et support Windows''' sur votre système.
#* Par exemple, cliquez avec le bouton droit sur le fichier de fontes, puis cliquez sur '''Installer'''.
# Ajoutez le fichier de fontes au répertoire racine de votre projet.
# Dans [[Inspecteur d'objets|l'inspecteur d'objets]], assignez la fonte à la propriété '''Text Settings/Font''' pour les contrôles qui utilisent la fonte.
# Ajoutez le fichier de fontes à votre projet dans le [[Gestionnaire de déploiement|Gestionnaire de déploiement]].

Vous trouverez des instructions complètes et des fichiers à télécharger pour créer un projet mobile utilisant une fonte installée personnalisée ([https://github.com/fortawesome Font Awesome]) à cet emplacement :

*[https://blogs.embarcadero.com/true-type-font-iconography-for-android-and-ios-apps/ https://blogs.embarcadero.com/true-type-font-iconography-for-android-and-ios-apps/]

Pour savoir si une fonte sera disponible à l'exécution sur un périphérique mobile spécifique, vous devez vérifier si la fonte utilisée à la conception est prise en charge sur vos périphériques cible :

* Fontes sur Android : [http://developer.android.com/design/style/typography.html http://developer.android.com/design/style/typography.html (EN)]

==Définition des permissions d'utilisation requises pour vos applications Android==

Certaines permissions Android de base sont prédéfinies pour toutes les apps {{FM}} Android.
Vous devez vérifier que des permissions d'accès spécifiques sont activées pour votre périphérique Android sur la page [[Permissions d'utilisation|Permissions d'utilisation]]''' dans Projet > Options.'''

Par exemple :

* Pour utiliser la caméra du périphérique Android, assurez-vous que les permissions suivantes sont activées :
**'''Appareil photo'''
**'''Lire/écrire le stockage externe'''
* Pour utiliser la localisation GPS sur un périphérique Android, assurez-vous qu'une ou plusieurs permissions '''d'accès aux emplacements''' sont activées :
**'''Accéder à un emplacement approximatif '''
**'''Accéder à un emplacement précis'''
**'''Accéder à des commandes supplémentaires d'emplacement'''
* Pour enregistrer du son sur un périphérique Android, assurez-vous que la permission suivante est activée :
**'''Enregistrer du son'''

==Utilisation du bouton Précédent du périphérique Android==

Pour que votre application gère l'appui sur la touche '''Précédent''' par les utilisateurs sur leur périphérique Android, ajoutez un [[Evénements|gestionnaire d'événement]] à votre fiche pour [[lib_fr:FMX.Forms.TForm.OnKeyUp|OnKeyUp]], et utilisez le code suivant dans votre gestionnaire d'événement :
<l s="delphi" />

<source lang="delphi">
if Key = vkHardwareBack then
begin
// Do whatever you want to do here
Key := 0; // Set Key = 0 if you want to prevent the default action
end;</source><l e="delphi" />

{{Tip|Le [[Modèles d'applications multi-périphériques|modèle mobile]] '''Onglets avec navigation''' implémente ce gestionnaire d'événement.}}

==Exécution de votre application en mode plein écran==

Par défaut, les applications Android affichent la barre d'état/de titre Android.

Si vous voulez que votre application s'exécute en mode plein écran et masque la barre d'état/de titre Android, sélectionnez '''Projet > Options > [[Informations de version#Informations de version Android|Informations de version]]''' et remplacez la valeur de la clé '''theme''' par '''No TitleBar'''.

Pour plus d'informations, voir [[Informations de version|Informations de version]].

==Paramètres relatifs au clavier virtuel dans les contrôles TEdit et TMemo==

Sur les plates-formes mobiles qui prennent en charge les [[lib_fr:FMX.VirtualKeyboard.IFMXVirtualKeyboardService|claviers virtuels]], le clavier virtuel s'affiche automatiquement dès qu'un contrôle TEdit ou TMemo apparaît.

Pour permettre à l'utilisateur de masquer le clavier virtuel en cliquant sur la touche '''Entrée''', définissez [[lib_fr:FMX.Edit.TCustomEdit.KillFocusByReturn|KillFocusByReturn]] <code>= True</code>.

==Utilisation des icônes et des images avec des résolutions multiples==

* Sur Android, les résolutions suivantes sont prises en charge :
*: 1x, 1.5x, 2x, 3x (Petit, Normal, Large, Extra large)
* Sur iOS, les résolutions suivantes sont prises en charge :
*: 1x et 2x (non Retina et Retina)

Les résolutions multiples peuvent être prises en charge en créant un [[lib_fr:FMX.Objects.TImage.MultiResBitmap|MultiResBitmap]] à l'aide de [[Editeur MultiResBitmap|l'éditeur MultiResBitmap]].
Pour de plus amples informations, voir '''[[Utilisation de bitmaps multi-résolutions|Utilisation de bitmaps multi-résolution]]'''.

*[[lib_fr:FMX.MultiResBitmap|MultiResBitmap]] supporte les résolutions suivantes sur Android : 1x, 1.5x, 2.5x
*: (iOS supporte 1x et 2x)

==Chargement et déploiement des fichiers==

Lorsque vous déployez votre application pour la plate-forme cible '''Android''', si vous envisagez de fournir des fichiers en même temps que votre application pour les charger à l'exécution, vous devez d'abord décider s'ils seront sur la mémoire interne du périphérique ou sur une mémoire externe (comme une carte SD). Une fois votre décision prise, utilisez le '''[[Gestionnaire de déploiement|Gestionnaire de déploiement]]''' pour placer ces fichiers dans le dossier <code>assets\internal</code> (interne) ou <code>assets</code> (externe) lors du déploiement.

:[[Image:AddDBforAndroidAssets.png]]

Utilisez le code suivant pour localiser ces fichiers à l'exécution :
<l s="delphi" />

<source lang="delphi">
TPath.Combine(TPath.GetDocumentsPath, 'filename') { Internal }
TPath.Combine(TPath.GetPublicPath, 'filename') { External }</source><l e="delphi" />

Dans cet exemple, <code>filename</code> est le nom de votre fichier, comme 'dbdemos.gdb' dans l'écran ci-dessus. L'enregistrement [[lib_fr:System.IOUtils.TPath|TPath]] est déclaré dans l'unité '''System.IOUtils'''. Vous devez donc ajouter '''System.IOUtils''' à la clause uses.

Si vous spécifiez <code>'assets\internal'</code> dans la colonne <code>'Chemin distant'</code> d'une entrée donnée dans la fenêtre ancrable <code>'Gestionnaire de déploiement'</code>, le fichier local correspondant sera stocké sous la forme <code>'assets/internal/<REMOTE-FILE-NAME>'</code> dans le fichier APK généré.

Pendant le déploiement de l'application, le chemin <code>'.\assets\internal\<REMOTE-FILE-NAME>'</code> est enregistré dans le fichier <code>'<PROJECT-ROOT-DIR-PATH>\Android64\Debug\<PROJECT-NAME>\assets\deployinfo\deployedassets.txt'</code>. L'unité <code>'FMX.StartUpCopy'</code> peut donc l'utiliser, lors du démarrage de l'application, pour détecter tous les fichiers destinés à être copiés dans le <code>'stockage interne de l'application'</code>.

Le tableau suivant contient un exemple de l'unité <code>'FMX.StartUpCopy'</code> en action :

{| class="wikitable"
|-
| '''Fichiers sur le périphérique Windows'''
|<PROJECT-ROOT-DIR-PATH>\Android64\Debug\VideoPlayerTest\assets\internal\Kayaking.mp4
<PROJECT-ROOT-DIR-PATH>\Android64\Debug\VideoPlayerTest\assets\internal\Ocean.mp4
|-
| '''Fichiers sur le périphérique Android'''
|/data/user/0/com.embarcadero.VideoPlayerTest/files/Kayaking.mp4
/data/user/0/com.embarcadero.VideoPlayerTest/files/Ocean.mp4
[[File:Device explorer.png|900px|link=]]
|-
| '''Retour de la fonction TPath.GetDocumentsPath'''
|/data/user/0/com.embarcadero.VideoPlayerTest/files
|}

Quand vous copiez un fichier d'actifs dans le <code>'stockage interne de l'application'</code>, ce fichier est accessible via un chemin absolu, car les fichiers d'actifs sont initialement uniquement accessibles via des méthodes de la classe native <code>'AssetManager'</code>.

Un autre avantage réside dans le contournement du fichier d'actifs original. Observez que certaines API natives sont conçues pour fonctionner sur des fichiers non spécifiques à l'application et peuvent par conséquent signaler de façon incorrecte les fichiers du <code>'stockage interne de l'application'</code> comme inaccessibles ou absents.

==Création d'applications pour Google Glass==

Le '''[[Concepteur de fiches|Concepteur de fiches]]''' fournit une [[Concepteur de fiches#Sélecteur de vue|vue]] '''Google Glass''', ce qui vous permet de créer des apps pour Google Glass :

: [[Image:GoogleGlassDesignTimeDevice.png]]

Si vous créez une app pour Google Glass, utilisez le style Google Glass personnalisé fourni par {{Product}} :

{{Path|{{StylesPath}}\Android\GoogleGlass.fsf}}

Le style Google Glass est optimisé pour l'interface utilisateur et la résolution de Google Glass.

Pour les étapes suivantes de l'utilisation du style Google Glass dans vos apps {{FM}}, voir '''[[Utilisation des styles FireMonkey natifs et personnalisés#Ajout d'un style personnalisé à votre application mobile|Ajout d'un style personnalisé à votre application mobile]]'''.

Pour obtenir des informations générales à propos du développement d'applications pour Google Glass avec {{Product}}, voir '''[[Premières étapes avec Google Glass|Premières étapes avec Google Glass]]'''.

==Création d'applications pour les montres intelligentes Android==

Le '''[[Concepteur de fiches|Concepteur de fiches]]''' fournit deux [[Concepteur de fiches#Sélecteur de vue|vues]]différentes pour les montres intelligentes Android : la '''Sony SmartWatch 3''' et la '''Motorola Moto 360'''. Les deux vues couvrent les formes typiques des montres intelligentes Android. Par conséquent, vous pouvez définir la conception la plus adaptée selon la montre intelligente sur laquelle l'application s'exécute. Vous pouvez également créer vos propres vues personnalisées pour d'autres périphériques, y compris des montres intelligentes Android additionnelles.

: [[Image:SmartWatchesDesignTimeDevice.png|500px]]

La fenêtre '''[[Aperçu multi-périphérique|Aperçu multi-périphérique]]''' fournit une vue à la conception de l'aspect de votre application sur quatre différentes montres intelligentes Android outre une gamme large d'autres périphériques.

: [[Image:SmartWatchesMultiDevicePreview.png|500px]]

Si vous créez une app pour une montre intelligente Android, {{Product}} fournit le style Android Wear, qui est optimisé pour l'interface utilisateur et différentes résolutions des montres intelligentes Android.

Le style Android Wear est disponible dans {{Path|{{StylesPath}}\Android\Androidwear.fsf}}.

Pour des informations générales sur le développement des applications pour les montres intelligentes Android en utilisant {{Product}}, voir '''[http://delphi.org/2014/09/hello-moto-360-from-delphi-xe7/ Creating an Android Smart Watch App with {{Product}} (EN)]'''.

==Implémentation de fonctionnalités propres à Android==

Les rubriques suivantes décrivent comment implémenter des fonctionnalités propres à Android dans vos applications :
{{f|androidservices|

* [[Création de services Android|Création de services Android]] }}
*[[Utilisation du service de facturation Google Play In-app Billing|Utilisation du service de facturation Google Play In-app Billing]]
*[[Utilisation du service AdMob|Utilisation du service AdMob]]
* [[Utilisation d'images 9-patch dans Android|Utilisation d'images 9-patch]]

Des informations supplémentaires sur d'autres fonctionnalités agnostiques à la plate-forme sont disponibles dans le '''[[Guide des applications FireMonkey|Guide d'applications FireMonkey]]'''.

==Voir aussi==

* [[Règles de dénomination des projets et fichiers multi-périphériques|Règles pour nommer des projets et des fichiers multi-périphériques]]
* [[Migration du code Delphi en mobile depuis le bureau|Migration du code {{Delphi}} en mobile depuis le bureau]]
* [[Modèles d'applications multi-périphériques|Modèles d'applications multi-périphériques]]
*[[Tutoriels mobiles : Développement d'applications mobiles (iOS et Android)|Tutoriels mobiles : Développement d'applications mobiles (iOS et Android)]]
** [[Tutoriel mobile : Création d'une application pour les plates-formes mobiles (iOS et Android)|Tutoriel mobile : Création d'une application pour les plates-formes mobiles (iOS et Android)]]
*[[Configuration de votre système pour détecter votre périphérique Android|Configuration de votre système pour détecter votre périphérique Android]]
* [[Création d'un composant FireMonkey (Delphi)|Création d'un composant FireMonkey ({{Delphi}})]]
*[[Conception d'applications FireMonkey|Conception d'applications FireMonkey]]
*[[Création d'une app iOS|Création d'une app iOS]]

===Exemples===

* Exemple [[samp_en:FMX.DeviceInfo Sample|{{FM}} Device Info]]

[[Category:Multi-périphérique]]
[[Category:Delphi]]
[[Category:FMX]]
[[Category:XE5]]
[[Category:AMMigrate]]

BDE

2025-05-28T09:34:15Z

Yukikoi : 1 révision importée : LOC-23438

{{Parent|Déploiement des applications BDE}}

{{Warning| Le '''moteur de base de données Borland (BDE, Borland Database Engine)''' est '''obsolète'''. Le BDE ne sera donc pas amélioré. Par exemple, le BDE ne prendra jamais en charge Unicode. Vous ne devriez pas entreprendre de nouveaux développements avec le BDE. Prévoyez plutôt de migrer vos applications de bases de données existantes du BDE vers [[FireDAC|FireDAC]].}}

Vous pouvez utiliser le moteur de bases de données Borland (BDE) pour que les composants de données standard {{Delphi}} aient accès aux bases de données. Consultez le document BDEDEPLOY pour obtenir les restrictions et les droits spécifiques sur la redistribution du BDE (voir C:\Program Files\Common Files\Borland Shared\BDE).

Il est important d’utiliser un programme certifié pour déployer les fichiers BDE car :

* Une installation incorrecte du BDE ou des sous-ensembles BDE peut empêcher le fonctionnement d’autres applications utilisant le BDE. Ces applications sont des produits {{Company}}, mais également des programmes tiers utilisant le BDE.
* Sous Windows 32 bits 95/NT ou plus, les informations de configuration BDE sont stockées dans les registres Windows et non pas dans des fichiers .ini, comme c'était le cas avec Windows 16 bits. La création ou la suppression de ces entrées lors de l'installation ou de la désinstallation est une tâche complexe.

Il est possible de n’installer que la partie du BDE nécessaire à une application. Si, par exemple, une application n’utilise que des tables Paradox, il est seulement nécessaire d’installer la partie du BDE indispensable pour l’accès aux tables Paradox. Cela réduit l’espace disque nécessaire à une application. Les programmes d'installation certifiés, comme InstallAware Express, sont capables d'effectuer une installation partielle du BDE. Veillez à conserver en l'état les fichiers système BDE inutilisés par l’application déployée mais nécessaires à d’autres programmes déjà installés.

==Voir aussi==

* [[Présentation de BDE|Présentation de BDE]]
* [[Utilisation du BDE|Utilisation du BDE]]
* [[Composants dbExpress|Composants dbExpress]]

[[Category:Guide du développeur Windows]]
[[Category:C++]]
[[Category:Delphi]]

Aide Expert mobile Android

2025-05-28T09:34:15Z

2025-05-28T09:34:12Z

Yukikoi : LOC-23438