RAD Studio - Contributions [fr]

Fichier manifest d'application Android (AndroidManifest.xml)

2022-08-23T05:26:05Z

Fabiola.Arias : Added the {{Note|}} template

{{Parent|Types de fichiers - Index}}

Lorsque vous construisez un projet pour la plate-forme cible [[Développement d'applications mobiles Android|Android]], {{Product}} génère un fichier manifest d'application Android. Ce fichier est nécessaire pour générer le bundle de votre application.

Les fichiers manifest d'application Android fournissent des informations à propos de votre application. Son contenu est généré à partir des informations des pages suivantes de la [[Boîte de dialogue Options de projet|configuration de votre projet]] :

* '''[[Options de l'application|Application]]'''
* '''[[Permissions d'utilisation|Permissions d'utilisation]]'''
* '''[[Informations de version|Informations de version]]'''

Lorsque vous construisez votre projet, votre fichier manifest d'application Android est généré par défaut sous {{Path|AndroidManifest.xml}}, dans le dossier suivant :

* Dans les [[Packages|Packages]] :
*: {{Note| Fichier manifeste d'application Android pour les [[Packages|Packages]].}}
** Pour {{Delphi}} : {{Path|{{PublicDocumentsPath}}\Bpl\{{Placeholder|plate-forme}}}}
** Pour C++
*** {{Path|{{PublicDocumentsPath}}\Bpl\{{Placeholder|plate-forme}}\{{Placeholder|configuration de construction}}}}
*** {{Path|{{PublicDocumentsPath}}\DCP\{{Placeholder|plate-forme}}\{{Placeholder|configuration de construction}}}}
* Dans les autres projets : {{Path|{{ProjectsPath}}\{{Placeholder|projet}}\{{Placeholder|plate-forme}}\{{Placeholder|configuration de construction}}}}

Pour changer de répertoire de sortie :

* Dans {{Delphi}} : utilisez l'option '''Répertoire de sortie des packages''' de {{Menu|Projet > Options > [[Compilateur Delphi|Compilateur {{Delphi}}]]}}.
* Dans C++ : utilisez l'option '''Sortie BPI/LIB''' de {{Menu|Projet > Options > [[C++ (options partagées)|C++ (options partagées)]]}}.

==Voir aussi==

* [[Préparation d'une application Android pour son déploiement#Personnalisation de votre fichier AndroidManifest.xml|Personnalisation de votre fichier AndroidManifest.xml]]

* [[Fichier des informations d'application Apple (*.info.plist)|Fichier des informations d'application Apple (*.info.plist)]]
* [[Fichier des droits d'application Apple (*.entitlements)|Fichier des droits d'application Apple (*.entitlements)]]
* [[Fichier des règles de ressources d'application Apple|Fichier des règles de ressources d'application Apple (ResourceRules.plist)]]

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

* [http://developer.android.com/guide/topics/manifest/manifest-intro.html AndroidManifest.xml] (documentation Android)

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

[[en:Android Application Manifest File (AndroidManifest.xml)]]
[[de:Anwendungsmanifestdatei für Android (AndroidManifest.xml)]]
[[ja:Android アプリケーションのマニフェストファイル（AndroidManifest.xml）]]

Création de templates dynamiques

2021-09-25T02:31:41Z

Fabiola.Arias : Added the {{Note|}} template

{{Parent|Comment modifier le code dans l'éditeur de code}}

Lorsque vous travaillez dans '''[[Editeur de code|l'éditeur de code]]''', vous pouvez ajouter vos constructions de code favorites au '''Gestionnaire de templates''' et créer une bibliothèque des templates que vous utilisez le plus souvent.

==Pour ajouter un template dynamique==

===Démarrer un template de code dans l'éditeur de code===

Dans '''l'éditeur de code''', effectuez l'une des actions suivantes :

* Choisissez '''Fichier > Nouveau > Autre > Autres fichiers''' et sélectionnez l'icône '''Template de code'''.
* Choisissez '''Voir > Templates''', puis cliquez sur le bouton '''Nouveau''' dans la fenêtre '''[[Fenêtre Templates|Templates]]''', située à la position de la palette d'outils, dans le coin inférieur droit de l'EDI.

Vous pouvez aussi sélectionner du code dans l'éditeur avant de cliquer sur le bouton '''Nouveau''' ; le code sélectionné est placé à l'intérieur des crochets [] du champ <code><![CDATA[]]></code>.

Voici le code XML que l'EDI affiche quand vous démarrez un template dynamique :

<source lang="xml">
<?xml version="1.0" encoding="utf-8" ?>
<codetemplate xmlns="http://schemas.borland.com/Delphi/2005/codetemplates"
version="1.0.0">
<template '''name="|"''' invoke="manual">
<description>

</description>
<author>

</author>
<code language=""><![CDATA[]]>
</code>
</template>
</codetemplate>
</source>

Quand vous ouvrez pour la première fois le squelette du template dynamique, le champ '''name=" "''' apparaît en surbrillance, et le curseur est situé entre les deux guillemets ('''name="|"''').

{{Note| Vous pouvez utiliser la '''[[Palette d'outils|palette d'outils]]''' pour ouvrir le squelette XML d'un template dynamique dans [[Editeur de code|l'éditeur de code]]. Entrez ''template'' dans le champ de recherche de la palette d'outils, et appuyez sur '''Entrée''' ou double-cliquez sur '''Template de code'''.}}

===Fournir les valeurs d'attributs dans le XML===

Remplissez maintenant les champs du template ; vous pouvez ajouter des champs spécifiques qui sont nécessaires à votre template.

# Commencez par assigner un nom à votre template. Les champs '''template name''' et '''code language''' du template sont obligatoires.
# Dans le champ '''invoke''', spécifiez la façon dont ce template sera invoqué :
#:
#:* manual - invoqué par l'appui sur la touche TAB
#:* auto - invoqué par l'appui sur la touche ESPACE ou TAB
#:* none - invoqué en utilisant CTRL+J, CTRL+ESPACE, ou la fenêtre Templates
# Remplissez la description, l'auteur et les attributs de langage de code ('''language="{{Delphi}}"''' ou '''language="C"''').

===Définir les points de saut===

Les '''points de saut''' sont des espaces réservés navigables et facultatifs pour les champs d'entrée. Si vous voulez que votre template contienne ces espaces réservés, vous devez alors définir un '''point''' pour chaque champ d'entrée dans le template. Quand quelqu'un utilise le template, il peut sauter d'un point à un autre en utilisant la touche '''Tab''' ou la barre '''Espace'''.

'''Pour définir des points de saut dans votre template :'''

# Positionnez le curseur (les points de saut sont typiquement les premiers éléments définis dans un template dynamique, et doivent donc être situés avant le champ '''<description>''').
# Double-cliquez sur le template '''point''', qui est disponible dans la fenêtre [[Fenêtre Templates|Templates]] quand vous créez un template dynamique.

:Le '''template point''' est affiché à la position du curseur dans l'éditeur de code :

[[Image:PointTemplateLive.png]]

Chaque '''point''' a trois valeurs d'attributs :

* '''PointName''' définit le nom du point de saut.
* '''PointText''' définit le texte descriptif affiché dans la fenêtre Templates. Dans l'éditeur de code, le point de saut affiche de façon erronée PointName, mais le XML réel du point est correct.
* '''PointHint''' définit le conseil contextuel du point.

qui sont définis en tant que points de saut dans ce template. Pour chaque point, ces valeurs d'attributs définissent
le nom, le texte (la description affichée dans la fenêtre Templates) et un conseil (qui s'affiche quand la souris passe au-dessus d'un template dans la fenêtre Templates.

===Entrer le code et enregistrer le template===

# Tapez le code de votre template, à l'intérieur des crochets imbriqués ([ ]) dans la balise <code><![CDATA[]]></code>.
#:Par exemple, voici le XML du template point lui-même. point.xml contient trois points (PointName, PointText, PointHint) et vous pouvez voir la représentation du code du template point dans <code><![CDATA[]]></code> :
#:
#:

<source lang="xml">
<?xml version="1.0" encoding="utf-8" ?>
<codetemplate xmlns="http://schemas.borland.com/Delphi/2005/codetemplates"
version="1.0.0">
<template name="point" invoke="manual">
<description>
Create a point in code templates
</description>
<author>
Embarcadero
</author>
<point name="PointName">
<text>
PointName
</text>
<hint>
Name of the point
</hint>
</point>
<point name="PointText">
<text>
PointText
</text>
<hint>
Text for the point
</hint>
</point>
<point name="PointHint">
<text>
PointHint
</text>
<hint>
Text for the point's hint
</hint>
</point>
<code language="XML" delimiter="|"><![CDATA['''<point name="|PointName|">
|*|<text>
|*||*||PointName|
|*|</text>
|*|<hint>
|*||*||PointHint|
|*|</hint>
</point>|end|''']]>
</code>
</template>
</codetemplate>
</source>

:2. Choisissez la commande '''Enregistrer''' dans le menu '''Fichier''' de '''l'éditeur de code''' (ou utilisez la combinaison de touches <code>CTRL + S</code>). Votre nouveau template apparaît désormais dans l'arborescence de la fenêtre '''[[Fenêtre Templates|Templates]]'''.
:Les templates sont enregistrés par défaut dans le répertoire {{Path|{{CodeTemplatesPath}}}}. Ils doivent être enregistrés dans ce répertoire afin d'apparaître dans la liste Templates de l'EDI.

Pour de plus amples informations sur les '''templates dynamiques''', notamment les liens vers des procédures plus détaillées et des démos, voir [http://delphi.wikia.com/wiki/Live_Templates_Technical_Info http://delphi.wikia.com/wiki/Live_Templates_Technical_Info]

==Voir aussi==

* [[Templates dynamiques|Templates dynamiques]]
*[[Utilisation des templates dynamiques|Utilisation des templates dynamiques]]
*[[Personnalisation de l'éditeur de code|Personnalisation de l'éditeur de code]]
* [[Fenêtre Templates|Fenêtre Templates]]
* [http://delphi.wikia.com/wiki/Live_Templates_Technical_Info http://delphi.wikia.com/wiki/Live_Templates_Technical_Info]

{{DEFAULTSORT:Creation de templates dynamiques}}
[[Category:Utilisation de RAD Studio]]
[[Category:AMMigrate]]

[[en:Creating Live Templates]]
[[de:Erstellen von Live-Vorlagen]]
[[ja:ライブテンプレートを作成する]]

Utilisation de la synchronisation des modifications

2021-09-25T00:18:03Z

Fabiola.Arias : Added the {{Note|}} template

{{Parent|Procédures de refactoring - Index}}

'''Nouvelle vidéo 2010 !''' [http://www.youtube.com/watch?v=CoeSsbtJUHY Vidéo : Synchronisation des modifications dans {{Product}} 2010, par Mike Rozlog]

La fonctionnalité de synchronisation des modifications vous permet de modifier simultanément des identificateurs identiques dans le code sélectionné. Par exemple, dans une procédure qui contient trois occurrences de label1, vous pouvez modifier seulement la première occurrence et toutes les autres occurrences changeront automatiquement.

'''Pour utiliser la synchronisation des modifications :'''

# Dans '''l'éditeur de code''', sélectionnez un bloc de code contenant des identificateurs identiques.
# Cliquez sur l'icône '''Mode Synchronisation des modifications'''[[Image:SyncEdit.jpg|Icône Synchronisation des modifications]] qui apparaît dans la gouttière de gauche, ou appuyez sur <code>Maj+Ctrl+J</code>.
#:Le premier identificateur identique est en surbrillance et les autres sont soulignés. Le curseur se trouve sur le premier identificateur. Si le code contient plusieurs ensembles d'identificateurs identiques, vous pouvez appuyer sur <code>Tab</code> pour passer d'un identificateur à l'autre dans la sélection.
# Commencez à modifier le premier identificateur. Vos modifications sont automatiquement appliquées aux autres identificateurs. Par défaut, l'identificateur est remplacé. Pour changer l'identificateur sans le remplacer, utilisez les touches fléchées avant de commencer la saisie.
# Une fois les identificateurs modifiés, vous pouvez quitter le mode de synchronisation des modifications en cliquant sur l'icône '''Mode Synchronisation des modifications''' ou en appuyant sur la touche <code>Echap</code>.

{{Note| La fonction de synchronisation des modifications détermine les identificateurs identiques par correspondance des chaînes de texte ; elle n'analyse pas les identificateurs. Par exemple, elle ne fait pas la différence entre deux identificateurs de même nom mais de types et de portées différents. Par conséquent, elle convient aux petites sections de code, par exemple une seule méthode ou une page de texte. Pour modifier des sections de code plus importantes, pensez à utiliser le refactoring (voir [[Refactoring des applications - Index|Refactoring des applications]]).}}

== Voir aussi ==
* [http://www.youtube.com/watch?v=CoeSsbtJUHY Vidéo : Synchronisation des modifications dans {{Product}} 2010, par Mike Rozlog]

[[Category:Utilisation de {{Product}}]]
[[Category:AMMigrate]]

[[en:Using Sync Edit]]
[[de:Sync-Bearbeitungsmodus verwenden]]
[[ja:同期編集を使用する]]

Utilisation de la pile de signets

2021-09-24T23:38:12Z

Fabiola.Arias : Added the {{Note|}} template

{{Parent|Comment modifier le code dans l'éditeur de code}}

La '''pile de signets''' est une méthode de navigation à travers votre code source. Elle permet de se déplacer dans un chemin prédéfini.

{{Note| Cette documentation se rapporte à la fonction '''Pile de signets'''. Pour la fonction '''Basculer les signets''', voir [[Utilisation des signets|Utilisation des signets]].}}

La pile de signets est une fonctionnalité uniquement disponible par clavier qui vous permet d'ajouter [[Editeur de code#Empiler les signets|des signets]] à votre code dans l'ordre de la pile. Vous pouvez ensuite naviguer en arrière en accédant au dernier signet de la pile qui correspond donc au dernier signet ajouté.

Les fonctionnalités de la pile de signets sont les suivantes :

{| class="wikitable"
|- style="vertical-align: top;"
! Description
! Raccourci
! Remarques
|-
| Déposer un signet de pile
| {{Key|Ctrl+K & Ctrl+G}}
| Définit un signet à l'emplacement en cours du curseur.
|-
| Sélectionner et récupérer un signet de pile
| {{Key|Ctrl+Q & Ctrl+G}}
| Déplace le curseur sur le dernier signet de la pile et retire le signet.
|-
| Permuter un signet de pile
| {{Key|Ctrl+Alt+Q & Ctrl+Alt+G}}
| Permute le dernier signet placé et l'emplacement du curseur.
|}

==Déposer des signets==

# Placez le curseur là où vous voulez déposer un signet.
# Appuyez sur le raccourci clavier {{Key|Ctrl+K & Ctrl+G}}.
#: La marque [[File:BookmarkStack.png|30px]] est placée à l'emplacement du curseur.

==Sélectionner des signets==

# Placez le curseur où vous le souhaitez dans l'éditeur de code.
# Appuyez sur le raccourci clavier {{Key|Ctrl+Q & Ctrl+G}}.
#: L'éditeur de code déplace le curseur à l'emplacement du dernier signet déposé et retire ce signet.

==Permuter des signets==

# Placez le curseur où vous le souhaitez dans l'éditeur de code.
# Appuyez sur le raccourci clavier {{Key|Ctrl+Alt+Q & Ctrl+Alt+G}}.
#: L'éditeur de code permute l'emplacement en cours du curseur avec celui du dernier signet déposé :
#:* Un signet est déposé à l'emplacement en cours du curseur.
#:* L'éditeur de code déplace le curseur à l'emplacement du dernier signet déposé et retire ce signet.

==Voir aussi==

* [[Utilisation des signets|Utilisation des signets]]
* [[Editeur de code#Signets|Signets (Editeur de code)]]

[[Category:Utilisation de RAD Studio]]
[[Category:Berlin]]

[[en:Using the Bookmark Stack]]
[[de:Verwenden des Positionsmarkenstapels]]
[[ja:ブックマークスタックの利用]]

Utilisation des signets

2021-09-24T16:58:46Z

Fabiola.Arias : Added the {{Tip|}} and the {{Note|}} templates

{{Parent|Comment modifier le code dans l'éditeur de code}}

{{Note| Ces signets font référence à [[Editeur de code#Basculer les signets|Basculer les signets]]. Pour voir un autre type de signet, consultez [[Editeur de code#Empiler les signets|Empiler les signets]].}}

Vous pouvez marquer un emplacement dans votre code avec un signet et y accéder directement depuis n'importe où dans le fichier. Vous pouvez définir jusqu'à dix signets. Les signets sont préservés lorsque vous enregistrez le fichier, et ils sont disponibles lorsque vous ouvrez à nouveau le fichier dans '''l'éditeur de code'''.

'''Pour définir un signet :'''

# Dans '''l'éditeur de code''', cliquez avec le bouton droit sur la ligne de code dans laquelle vous voulez définir un signet. Le menu contextuel de '''l'éditeur de code''' s'affiche.
# Choisissez '''Basculer les signets > Signet n''', où ''n'' est un numéro de signet compris entre 0 et 9.

:
::Une icône de signet est affichée dans la gouttière gauche de '''l'éditeur de code'''. Par exemple, [[File:Bookmark0.jpg|l'icône Signet]] est le signet n°1, alors que [[File:Bookmark9.jpg|l'icône Signet]] est le signet n°9.

{{Tip| Pour définir un signet avec les touches de raccourci, appuyez sur <code>Ctrl+Maj</code> et tapez un chiffre de 0 à 9.}}

'''Pour accéder à un signet :'''

# Dans '''l'éditeur de code''', cliquez avec le bouton droit pour afficher le menu contextuel.
# Choisissez '''Aller au signet > Signet n''', où ''n'' est un numéro de signet compris entre 0 et 9.

{{Tip| Pour accéder à un signet avec les touches de raccourci, appuyez sur <code>Ctrl</code> et tapez le numéro du signet. Par exemple, <code>Ctrl+1</code> ira sur la ligne de code définie par le signet 1. }}

'''Pour retirer un signet :'''

# Dans '''l'éditeur de code''', cliquez avec le bouton droit pour afficher le menu contextuel.
# Choisissez '''Basculer les signets > Signet n''', où ''n'' représente le numéro du signet à retirer.

:
::L'icône de signet est retirée de la gouttière gauche de '''l'éditeur de code'''.

{{Tip| Pour retirer tous les signets d'un fichier, choisissez = </nowiki>"#598527"> '''Effacer les signets'''. }}

==Voir aussi==

* [[Editeur de code#Basculer les signets|Basculer les signets]]
* [[Editeur de code#Empiler les signets|Empiler les signets]]
* [[Utilisation de la pile de signets|Utilisation de la pile de signets]]

[[Category:Utilisation de RAD Studio]]
[[Category:AMMigrate]]

[[en:Using Bookmarks]]
[[de:Positionsmarken verwenden]]
[[ja:しおりを使用する]]

Enregistrement des dispositions du bureau

2021-09-01T03:16:27Z

Fabiola.Arias : Added the {{Note|}} template

{{Parent|Comment utiliser l'EDI}}

Pour basculer entre les dispositions de bureau, choisissez une disposition dans la liste déroulante située sur la barre d'outils '''Bureau'''.

Cette procédure décrit comment enregistrer votre disposition de bureau en cours afin que votre propre disposition soit disponible à partir du sous-menu ''''Voir > Bureaux ''' et de la barre d'outils.

{{Note| La disposition de bureau en cours est un des éléments enregistrés dans un fichier .dsk quand vous définissez l'option d'auto-enregistrement '''Bureau du projet''' sur = </nowiki>"#598527"> '''Outils > Options > [[Options d'environnement|Options d'environnement]]'''. A la prochaine ouverture du projet, le bureau enregistré et les autres paramètres sont restaurés, notamment les points d'arrêt, les points de suivi et les fichiers ouverts. En mode multi-écrans, {{Product}} stocke également des informations concernant l'écran utilisé pour afficher la fenêtre principale de l'EDI.
}}

'''Pour enregistrer une disposition de bureau'''

# Choisissez '''Voir > Bureaux > [[Enregistrer le bureau|Enregistrer le bureau]]'''.
# Entrez le nom que vous souhaitez pour le bureau.
# Cliquez sur '''OK'''.

'''Pour définir une disposition de bureau de débogage'''

# Choisissez '''Voir > Bureaux > [[Sélectionner le bureau de débogage|Définir le bureau de débogage]]'''.
# Dans la liste déroulante, sélectionnez la disposition que vous voulez utiliser en tant que disposition de bureau durant le débogage.
# Cliquez sur '''OK'''.

==Voir aussi==

*[[Définition des options de projet|Définition des options de projet]]
*[[Présentation du débogage|Présentation du débogage]]
*[[Barre d'outils Bureau|Barre d'outils Bureau]]
*[[Bureaux|Commande Voir les bureaux]]
* [[Options d'environnement|Options d'environnement]]

[[Category:Utilisation de RAD Studio]]
[[Category:AMMigrate]]

[[en:Saving Desktop Layouts]]
[[de:Desktop-Layouts speichern]]
[[ja:デスクトップレイアウトを保存する]]

Enregistrement d'une macro de touches

2021-08-31T07:07:47Z

Fabiola.Arias : Added the {{Note|}} template

{{Parent|Comment modifier le code dans l'éditeur de code}}

Lors de l'édition du code, vous pouvez enregistrer une série de séquences de touches sous forme de macro. Une fois enregistrée, la macro peut être réutilisée pour répéter des séquences de touches lors de la session de l'EDI en cours. Vous disposez d'une seule macro à la fois, donc elle remplace la macro existante lorsque vous en enregistrez une autre.

'''Pour enregistrer une macro'''

# Dans '''l'éditeur de code''', lancez l'enregistrement en cliquant sur le bouton Enregistrer une macro [[File:MacroRecord.png|Enregistrer une macro]] dans le bas de la fenêtre de code (ou appuyez sur <code>Ctrl+Maj+R</code>).
# Entrez les frappes de touches que vous souhaitez enregistrer.
# Après avoir tapé la séquence de touches, cliquez sur le bouton Arrêter l'enregistrement de macro [[File:MacroStop.png|Arrêter l'enregistrement de macro]] (ou appuyez sur <code>Ctrl+Maj+R</code> à nouveau).
# Pour enregistrer une autre macro, répétez les étapes précédentes.

{{Note| L'enregistrement d'une macro remplace la macro précédemment enregistrée.}}

La macro est à présent disponible lors de la session d'IDE en cours.

'''Pour exécuter une macro'''

# Dans '''l'éditeur de macro''', positionnez le curseur à l'endroit où vous souhaitez lancer la macro.
# Faites l'une des actions suivantes :
#* Cliquez sur le bouton Rejouer la macro [[File:MacroPlayback.png|Rejouer la macro]] dans le coin gauche inférieur de la fenêtre. Si le bouton s'affiche en grisé, aucune macro n'est disponible.
#* Alternativement, appuyez sur <code>Ctrl+Maj+P</code>.

==Voir aussi==

* [[Raccourcis clavier par défaut]]

[[Category:Utilisation de {{Product}}]]
[[Category:AMMigrate]]

[[en:Recording a Keystroke Macro]]
[[de:Tastatur-Makro aufzeichnen]]
[[ja:キー入力マクロを記録する]]

Création de bibliothèques de templates

2021-08-31T04:33:10Z

Fabiola.Arias : Added the {{Note|}} template

{{Parent|Comment modifier le code dans l'éditeur de code}}

Les bibliothèques de templates sont des templates de projet personnalisés qui spécifient à quoi doit ressembler un projet et ce qu'il doit contenir. Lorsque vous créez une bibliothèque de templates personnalisée, elle est placée dans la boîte de dialogue '''[[Nouveaux éléments|Nouveaux éléments]]''' où elle est accessible pour la création d'un projet avec '''Fichier > Nouveau'''.

Vous pouvez créer des projets de bibliothèque de templates à partir de rien ou utiliser des projets préalablement créés par vous ou par d'autres développeurs comme base des bibliothèques de templates. Pour utiliser un projet existant, créez simplement un fichier XML avec l'extension <code>.bdstemplatelib</code> qui décrit le projet et est utilisé pour créer la bibliothèque de templates utilisant ce projet.

{{Note| Lors de la création d'un projet à utiliser avec une bibliothèque de templates, le projet doit être situé dans un sous-répertoire ne contenant pas d'autres projets. En outre, tous les fichiers du projet doivent résider dans le sous-répertoire ou ses sous-répertoires enfant.}}

==Pour créer une bibliothèque de templates==

# Créez un nouveau projet ou ouvrez un projet existant qui représentera la base de la bibliothèque de templates personnalisée.Apportez des modifications au projet afin de le personnaliser pour la bibliothèque de templates.
# Enregistrez et fermez le projet.
# Choisissez '''Fichier > Nouveau > Autre > Documents Web''' et double-cliquez sur l'icône '''Fichier XML'''.
# Remplacez le contenu par défaut du nouveau fichier XML par le contenu exemple suivant :

<source lang="xml">
<TemplateLibrary Version="1.0" id="">
<Name></Name>
<Description></Description>
<Items>
<Item id="" Creator="">
<Name>Name of template library here </Name>
<Description>Custom Project Template</Description>
<Author></Author>
<Icon>MyTemplate\MyTemplateIcon.ico</Icon>
<ProjectFile>MyTemplate.dproj</ProjectFile>
<DefaultProjectName>MyTemplate</DefaultProjectName>
<FilePath>MyTemplate</FilePath>
<Identities>RadStudio</Identities>
</Item>
</Items>
</TemplateLibrary>
</source>

:
{{Notes|
::* L'attribut <code>id<nowiki> = </nowiki>""</code> de l'élément <code><TemplateLibrary></code> doit être unique afin d'éviter des conflits avec d'autres bibliothèques de templates. Il est conseillé d'inclure votre nom ou le nom de votre société dans <code>l'id</code>.
::* Pour les projets {{CBuilder}}, changez l'extension dans l'élément {{Code|{{Placeholder|ProjectFile}}}} par {{Code|cbproj}}.
::* L'attribut <code>Creator<nowiki> = </nowiki>""</code> de l'élément <code><Item></code> spécifie la page de la boîte de dialogue '''Nouveaux éléments''' qui affiche l'icône de cette bibliothèque de templates. Vous pouvez placer l'icône du projet sur une page spécifique au type de projet créé. }}
::Voici les valeurs possibles de l'attribut <code>Creator=""</code> :

{| border="1" frame="hsides" rules="rows"
|-
! '''Type de projet'''
! '''Valeur de l'attribut Creator de l'élément'''
|-
| style="text-align: left; vertical-align: top;" | Projets C++
| style="text-align: left; vertical-align: top;" |Creator="CBuilderProjectRepositoryCreator"
|-
| style="text-align: left; vertical-align: top;" | Projets {{Delphi}}
| style="text-align: left; vertical-align: top;" |Creator="DelphiProjectRepositoryCreator"
|}

<ol start="5"><li>
Enregistrez le fichier xml <code>.bdstemplatelib</code> dans un répertoire au-dessus du répertoire projet.
{{Note| L'élément <code><FilePath></code> du fichier <code>.bdstemplatelib</code> indique l'emplacement du répertoire projet relativement à l'emplacement du fichier <code>.bdstemplatelib</code>.}}</li>
<li>Modifiez le contenu du XML <code>.bdstemplatelib</code> de façon à le personnaliser pour votre propre bibliothèque de templates :

<ul><li>Ajoutez le nom de la bibliothèque de templates, la description et la valeur de l'attribut <code>Creator</code>.</li>
<li>Modifiez le nom du projet, les informations de chemin du projet, le chemin de l'icône et le nom du fichier. Vous pouvez facultativement ajouter votre nom comme auteur.</li>
<li>
Spécifiez le chemin relatif au fichier XML <code>.bdstemplatelib</code> dans la valeur <code><FilePath></code>. Par exemple, si votre projet réside dans <code>C:\MyProjects\TemplateLibraries\MyTemplate</code> et que vous placez le fichier XML dans <code>C:\MyProjects\TemplateLibraries</code>, la valeur <code><FilePath></code> dans le fichier XML est <code><FilePath>TemplateLibraries\MyTemplate</FilePath></code>.
</li>
</ul>
</li>
<li>Choisissez '''Outils > Bibliothèques de templates''' pour ouvrir la boîte de dialogue '''[[Bibliothèques de templates|Bibliothèques de templates]]'''.
</li>
<li>Cliquez sur le bouton '''Ajouter''', naviguez jusqu'au fichier XML <code>.bdstemplatelib</code> nouvellement créé, sélectionnez-le et cliquez sur '''Ouvrir'''. La nouvelle bibliothèque de templates est ajoutée à la liste de la boîte de dialogue '''Bibliothèques de templates'''. Elle est également ajoutée dans la page spécifiée de la boîte de dialogue '''Nouveaux fichiers'''. Cliquez sur '''OK''' pour fermer la boîte de dialogue '''Bibliothèques de templates'''.</li>
</ol>

Afin d'utiliser cette bibliothèque de templates pour la création d'un nouveau projet, choisissez '''Fichier > Nouveau > Autre''' et sélectionnez votre bibliothèque de templates dans la boîte de dialogue '''Nouveaux fichiers'''.

===Exemple===

<source lang="xml">
<TemplateLibrary Version="1.0" id="CompanyNameDelphiVCLProject">
<Name>DelphiVCLProject</Name>
<Description>Simple Delphi VCL Project</Description>
<Items>
<Item id="DelphiVCLProject" Creator="DelphiProjectRepositoryCreator">
<Name>Delphi VCL Project</Name>
<Description>A simple Delphi VCL project.</Description>
<Author>John Doe</Author>
<ProjectFile>DelphiVCLProject.dproj</ProjectFile>
<DefaultProjectName>DelphiVCLProject</DefaultProjectName>
<FilePath>DelphiVCL</FilePath>
<Identities>RadStudio</Identities>
</Item>
</Items>
</TemplateLibrary>
</source>

Si vous avez plusieurs projets associés, vous pouvez utiliser un fichier bibliothèque de templates <code>.bdstemplatelib</code> unique pour lister tous les projets.

==Pour combiner plusieurs projets dans un seul fichier bibliothèque de templates==

# Placez tous les dossiers projet au même niveau dans le même sous-dossier projet.
# Créez le fichier bibliothèque de templates <code>.bdstemplatelib</code> au niveau situé au-dessus du dossier contenant tous les projets.
# Ajoutez le contenu pour le premier projet, comme décrit ci-dessus.
# Ajoutez un <code><Item></Item></code> supplémentaire à l'élément <code><Items></Items></code> pour chaque projet du groupe, donnant à chaque <code><Item></Item></code> un attribut <code>id="</code> unique.

===Exemple===

<source lang="xml">
<TemplateLibrary Version="1.0" id="Embarcadero">
<Name>MultipleProjectsTemplate</Name>
<Description>Template with multiple projects.</Description>
<Items>
<Item id="DelphiVCLProject" Creator="DelphiProjectRepositoryCreator">
<Name>Delphi VCL Project</Name>
<Description>A simple Delphi VCL project.</Description>
<Author>John Doe</Author>
<ProjectFile>DelphiVCLProject.dproj</ProjectFile>
<DefaultProjectName>DelphiVCLProject1</DefaultProjectName>
<FilePath>DelphiVCL</FilePath>
<Identities>RadStudio</Identities>
</Item>
<Item id="CppVCLProject" Creator="CBuilderProjectRepositoryCreator">
<Name>C++ VCL Project</Name>
<Description>A simple C++ VCL project.</Description>
<Author>John Doe</Author>
<ProjectFile>CPPVCLProject.cbproj</ProjectFile>
<DefaultProjectName>CPPVCLProject2</DefaultProjectName>
<FilePath>CPPVCL</FilePath>
<Identities>RadStudio</Identities>
</Item>
</Items>
</TemplateLibrary>
</source>

==Voir aussi==

* [[Présentation des bibliothèques de templates|Présentation des bibliothèques de templates]]
* [[Bibliothèques de templates|Bibliothèques de templates]]

{{DEFAULTSORT:Creation de bibliotheques de templates}}
[[Category:Utilisation de RAD Studio]]
[[Category:AMMigrate]]

[[en:Creating Template Libraries]]
[[de:Vorlagenbibliotheken erstellen]]
[[ja:テンプレートライブラリを作成する]]

Modèle:Notes

2021-08-31T04:23:12Z

Fabiola.Arias :

<div style="
background-color: #def2f8;
border-left: 10px solid #0f628a;
color: black;
font-size: 1em;
font-style: italic;
padding: 1em;
margin: 1em 0;
white-space: normal;
word-wrap: break-word;">'''Remarques:''' {{{1}}}</div>

Présentation de l'EDI - Index (tutoriel de l'EDI)

2021-08-23T23:37:44Z

Fabiola.Arias : Added the {{Note|}} template

{{Parent|Tutoriel : Utilisation de l'EDI}}

{{Note| Pour obtenir une vue globale des éléments de l'EDI, voir aussi la rubrique d'aide au nom similaire '''[[Présentation de l'EDI|Présentation de l'EDI]]'''.}}

==Rubriques==

* [[Aperçu et page d'accueil|Aperçu et page d'accueil]]
* [[Barres d'outils (tutoriel de l'EDI)|Barres d'outils]]
*[[Outils - Index (tutoriel de l'EDI)|Outils]]
** [[Options d'accessibilité (tutoriel de l'EDI)|Options d'accessibilité]]
** [[Concepteur de fiches (tutoriel de l'EDI)|Concepteur de fiches]]
** [[Palette d'outils (tutoriel de l'EDI)|Palette d'outils]]
** [[Inspecteur d'objets (tutoriel de l'EDI)|Inspecteur d'objets]]
** [[Gestionnaire de projets (tutoriel de l'EDI)|Gestionnaire de projets]]
** [[Navigateur de fichiers (tutoriel de l'EDI)|Navigateur de fichiers]]
** [[Vue Structure (tutoriel de l'EDI)|Vue Structure]]
**[[L'éditeur de code - Index (tutoriel de l'EDI)|L'éditeur de code]]
*** [[Navigation dans le code (tutoriel de l'EDI)|Navigation dans le code]]
*** [[Formatage du code source (tutoriel de l'EDI)|Formatage du code source]]
*** [[Pliage du code (tutoriel de l'EDI)|Pliage du code]]
*** [[Barres de modification (tutoriel de l'EDI)|Barres de modification]]
*** [[Commentaires de bloc (tutoriel de l'EDI)|Commentaires de bloc]]
*** [[Templates dynamiques (tutoriel de l'EDI)|Templates dynamiques]]
*** [[Synchronisation des modifications (tutoriel de l'EDI)|Synchronisation des modifications]]
*** [[Audit de code (tutoriel de l'EDI)|Audit de code]]
*** [[Refactoring (tutoriel de l'EDI)|Refactoring]]
*** [[Macros clavier (tutoriel de l'EDI)|Macros clavier]]
*** [[Listes A faire (tutoriel de l'EDI)|Listes A faire]]
* [[Gestionnaire de l'historique (tutoriel de l'EDI)|Gestionnaire de l'historique]]
* [[Intégration de Subversion dans l'EDI (tutoriel de l'EDI)|Intégration de Subversion dans l'EDI]]
* [[Explorateur de données (tutoriel de l'EDI)|Explorateur de données]]
* [[Référentiel d'objets (tutoriel de l'EDI)|Référentiel d'objets]]
* [[IDE Insight (tutoriel de l'EDI)|IDE Insight]]

==Voir aussi==

* [[Visites guidées de RAD Studio|Visites guidées de RAD Studio]] {{f|radstudio|
* '''[[Présentation de l'EDI|Présentation de l'EDI]]''' dans [[Introduction à {{Variables|Product}}|Introduction à {{Variables|Product}}]]}}

{{DEFAULTSORT:Presentation de l'EDI - Index (tutoriel de l'EDI)}}
[[Category:Delphi]]
[[Category:C++]]
[[Category:AMMigrate]]

[[en:Tour of the IDE Index (IDE Tutorial)]]
[[de:Ein erster Blick auf die IDE - Index (IDE-Tutorial)]]
[[ja:IDE の概要（IDE チュートリアル）：インデックス]]

Contrôles Windows natifs de FireMonkey

2021-06-09T21:08:59Z

Fabiola.Arias : Added the {{Note|}} template

{{Parent|Contrôles natifs de FireMonkey}}

Cette rubrique décrit les '''contrôles Windows natifs''' de {{FM}}.

==Présentation des contrôles Windows natifs de {{FM}}==

{{FM}} fournit une présentation native pour certains composants visuels.

* Définissez la propriété [[lib_fr:FMX.Controls.Presentation.TPresentedControl.ControlType|ControlType]] sur {{Const|Styled}} pour avoir la présentation {{FM}} standard du contrôle. {{Const|Styled}} est la valeur par défaut de [[lib_fr:FMX.Controls.Presentation.TPresentedControl.ControlType|ControlType]].
* Définissez la propriété [[lib_fr:FMX.Controls.Presentation.TPresentedControl.ControlType|ControlType]] sur {{Const|Platform}} pour avoir le style natif de ce contrôle.

==Contrôles Windows natifs de {{FM}} disponibles==

La liste suivante contient tous les contrôles prenant en charge la présentation native :

* [[lib_fr:FMX.Edit.TEdit|TEdit]]
* [[lib_fr:FMX.Memo.TMemo|TMemo]]
* [[lib_fr:FMX.ScrollBox.TPresentedScrollBox|TPresentedScrollBox]]
* [[lib_fr:FMX.ScrollBox.TPresentedVertScrollBox|TPresentedVertScrollBox]]
* [[lib_fr:FMX.ScrollBox.TPresentedHorzScrollBox|TPresentedHorzScrollBox]]
* [[lib_fr:FMX.ScrollBox.TPresentedFramedScrollBox|TPresentedFramedScrollBox]]
* [[lib_fr:FMX.ScrollBox.TPresentedFramedVertScrollBox|TPresentedFramedVertScrollBox]]

==Changements visuels des contrôles Windows natifs==

Lorsque la propriété [[lib_fr:FMX.Controls.Presentation.TPresentedControl.ControlType|ControlType]] d'un composant visuel est définie sur {{Const|Platform}}, la présentation de ce contrôle dans le [[Concepteur de fiches|Concepteur de fiches]] change pour indiquer qu'il s'agit d'un contrôle natif et une icône représentant un petit téléphone apparaît dans l'angle inférieur droit.
Les images suivantes montrent l'apparence des contrôles Windows natifs avec la propriété [[lib_fr:FMX.Controls.Presentation.TPresentedControl.ControlType|ControlType]] définie sur {{Const|Styled}} et {{Const|Platform}}, à la conception et à l'exécution :

{| class="wikitable"
|-
! rowspan="2" |Contrôle
! colspan="2" |A la conception
! colspan="2" |A l'exécution
|-
! {{Const|Styled}}
! {{Const|Platform}}
! {{Const|Styled}}
! {{Const|Platform}}
|-
|
[[lib_fr:FMX.Edit.TEdit|TEdit]]
|
[[File:TEditStyled DT win.png|200px]]
|
[[File:TEditPlatform DT win.png|200px]]
|
[[File:TEditStyled RT win.png|200px]]
|
[[File:TEditPlatform RT win.png|200px]]
|-
|
[[lib_fr:FMX.Memo.TMemo|TMemo]]
|
[[File:TMemo Styled DT win.png|200px]]
|
[[File:TMemo Platform DT win.png|200px]]
|
[[File:TMemo Styled RT win.png|200px]]
|
[[File:TMemo Platform RT win.png|200px]]
|-
|
[[lib_fr:FMX.ScrollBox.TPresentedScrollBox|TPresentedScrollBox]]
|
[[File:TPresentedScrollBox Styled DT.png|200px]]
|
[[File:TPresentedScrollBox Platform DT.png|200px]]
|
[[File:TPresentedScrollBox Styled RT win.png|200px]]
|
[[File:TPresentedScrollBox Platform RT win.png|200px]]
|}

==Ajout de contrôles Windows natifs à votre application==

Pour ajouter des contrôles Windows natifs à votre application :

# Déposez sur la fiche un composant prenant en charge la présentation native ([[#Contrôles Windows natifs de FireMonkey disponibles|listes des contrôles pris en charge]]).
# Dans [[Inspecteur d'objets|l'inspecteur d'objets]], sous '''Propriétés''', définissez la propriété [[lib_fr:FMX.Controls.Presentation.TPresentedControl.ControlType|ControlType]] sur {{Const|Platform}}. A la conception, la présentation du composant change (voir [[#Changements visuels des contrôles Windows natifs|Changements visuels des contrôles Windows natifs]]).
# Exécutez votre application.

Sinon, vous pouvez changer la valeur de [[lib_fr:FMX.Controls.Presentation.TPresentedControl.ControlType|ControlType]] à l'exécution. Pour sélectionner la présentation native pour un contrôle [[lib_fr:FMX.Edit.TEdit|TEdit]], ajoutez le code suivant à votre application :

<l s="delphi" />'''{{Delphi}} :'''
<source lang="Delphi">
Edit1.ControlType := TPresentedControl.TControlType.Platform;
</source><l e="delphi" />

<l s="cpp" />'''C++ :'''
<source lang="cpp">
Edit1->ControlType = TPresentedControl::TControlType::Platform;
</source><l e="cpp" />

==Combinaison de contrôles Windows natifs et de contrôles non natifs==

Il n'est pas recommandé de combiner des contrôles non natifs avec des contrôles natifs, car ces derniers ne prennent pas en charge l'ordre Z de la fiche : un contrôle natif est toujours placé au-dessus des autres contrôles sur votre fiche. Toutefois, il existe des contrôles non natifs que vous pouvez combiner avec des contrôles natifs, car ils prennent en charge l'ordre Z des contrôles natifs.

La liste suivante contient tous les contrôles ayant la propriété [[lib_fr:FMX.Controls.Presentation.TPresentedControl.ControlType|ControlType]] et pouvant donc être combinés avec des contrôles natifs :

* [[lib_fr:FMX.MultiView.TMultiView.ControlType|TMultiView]]
* [[lib_fr:FMX.StdCtrls.TButton|TButton]]
* [[lib_fr:FMX.StdCtrls.TSpeedButton|TSpeedButton]]
* [[lib_fr:FMX.Colors.TColorButton|TColorButton]]
* [[lib_fr:FMX.StdCtrls.TCornerButton|TCornerButton]]
* [[lib_fr:FMX.ExtCtrls.TPopupBox|TPopupBox]]
* '''TMagnifierGlass'''
* [[lib_fr:FMX.StdCtrls.TPanel|TPanel]]
* [[lib_fr:FMX.StdCtrls.TLabel|TLabel]]
* [[lib_fr:FMX.StdCtrls.TCheckBox|TCheckBox]]
* [[lib_fr:FMX.StdCtrls.TRadioButton|TRadioButton]]
* [[lib_fr:FMX.StdCtrls.TGroupBox|TGroupBox]]
* [[lib_fr:FMX.StdCtrls.TStatusBar|TStatusBar]]
* [[lib_fr:FMX.StdCtrls.TToolBar|TToolBar]]
* [[lib_fr:FMX.StdCtrls.TProgressBar|TProgressBar]]
* [[lib_fr:FMX.StdCtrls.TTrackBar|TTrackBar]]
* [[lib_fr:FMX.ListView.TListView|TListView]]

La liste suivante contient tous les contrôles n'ayant pas la propriété [[lib_fr:FMX.Controls.Presentation.TPresentedControl.ControlType|ControlType]] mais pouvant également être combinés avec des contrôles natifs :

* [[lib_fr:FMX.WebBrowser.TWebBrowser|TWebBrowser]]
* [[lib_fr:FMX.Media.TMediaPlayer|TMediaPlayer]]

==Avantages des contrôles Windows natifs==

Certains contrôles prennent en charge une fonctionnalité supplémentaire lorsque vous les utilisez comme contrôles natifs :

===TMemo et TEdit===

*'''Eléments supplémentaires du menu contextuel :'''
** Annuler : annule la dernière action.
** Ordre de lecture de droite à gauche : change l'ordre de lecture et justifie le texte sur le côté droit du contrôle. Voir [https://www.microsoft.com/resources/documentation/windows/xp/all/proddocs/en-us/lang_right_to_left.mspx?mfr=true la documentation Microsoft - To set right-to-left reading order (EN)] pour plus d'informations.
** Afficher les caractères de contrôle Unicode : affiche les [[Wikipedia:Unicode control characters|caractères de contrôle Unicode]].
** Insérer un caractère de contrôle Unicode : insère un caractère de contrôle Unicode.
** Ouvrir IME : IME désigne {{Code|Microsoft Global Input Method Editor}}. Il permet la saisie de caractères japonais, chinois et coréens dans les applications les prenant en charge sur d'autres versions de Windows.

Les fonctionnalités ci-dessus sont fournies dans le menu contextuel du contrôle. Le menu contextuel du contrôle mémo ou du contrôle d'édition est donc différent pour {{Const|Styled}} et {{Const|Platform}} :

{| class="wikitable"
|-
! Contrôle
! Menu contextuel ({{Const|Styled}})
! Menu contextuel ({{Const|Plateform}})
|-
|
[[lib_fr:FMX.Memo.TMemo|TMemo]]
|
[[File:TMemo ContextMenu Styled RT win.png|150px]]
|
[[File:TMemo ContextMenu Platform RT win.png|300px]]
|-
|
[[lib_fr:FMX.Edit.TEdit|TEdit]]
|
[[File:TEdit ContextMenu Styled RT win.png|150px]]
|
[[File:TEdit ContextMenu Platform RT win.png|300px]]
|}

==Limitations des contrôles Windows natifs==

Avant d'utiliser les contrôles natifs, pensez aux limitations suivantes :

* Les contrôles natifs ne prennent pas en charge les styles personnalisés ou prédéfinis. Lorsque la propriété [[lib_fr:FMX.Controls.Presentation.TPresentedControl.ControlType|ControlType]] d'un contrôle natif est définie sur {{Const|Platform}}, la valeur de la propriété [[lib_fr:FMX.Controls.TStyledControl.StyleLookup|StyleLookup]] est ignorée.
* La prise en charge de l'arrière-plan transparent par les contrôles natifs est limitée. Les contrôles transparents ne sont pas peints correctement.
* Les contrôles natifs ne prennent pas en charge l'ordre Z de la fiche : un contrôle natif est toujours placé au-dessus des autres contrôles {{FM}} disponibles sur votre fiche. Voir [[#Combinaison de contrôles Windows natifs et de contrôles non natifs|Combinaison de contrôles Windows natifs et de contrôles non natifs]] pour plus d'informations.
* Les gestionnaires d'événement suivants ne sont pas pris en charge et ne peuvent pas être implémentés :
** [[lib_fr:FMX.Controls.TControl.OnApplyStyleLookup|OnApplyStyleLookup]]
** [[lib_fr:FMX.Controls.TControl.OnDblClick|OnDblClick]]
** [[lib_fr:FMX.Controls.TControl.OnGesture|OnGesture]]
* Les événements suivants se produisent mais vous ne pouvez pas les utiliser comme attendu (pour redéfinir la visualisation du contrôle). Cependant, vous pouvez les utiliser comme indication du moment auquel le système repeint le contrôle :
** [[lib_fr:FMX.Controls.TControl.OnPaint|OnPaint]]
** [[lib_fr:FMX.Controls.TControl.OnPainting|OnPainting]]

Il existe également des limitations spécifiques aux contrôles :

===TMemo===

L'événement suivant n'est pas pris en charge et ne peut pas être implémenté dans [[lib_fr:FMX.Memo.TMemo|TMemo]] :

* [[lib_fr:FMX.Memo.TMemo.OnViewportPositionChange|OnViewportPositionChange]]

===TMemo et TEdit===

La définition de valeurs de paramètre dans le gestionnaire d'événement {{Code|OnKeyXX}} ne supprime pas la saisie au clavier.
Par exemple, si vous définissez {{Code|1=KeyChar := #0;}} dans le gestionnaire d'événement [[lib_fr:FMX.Controls.TControl.OnKeyDown|OnKeyDown]] puis appuyez sur la touche {{Const|s}}, la présentation native produit toujours le résultat {{Const|s}}, alors que la présentation stylée ne produit aucun résultat.

La limitation ci-dessus s'applique aux gestionnaires d'événement suivants :

* [[lib_fr:FMX.Controls.TControl.OnKeyDown|OnKeyDown]]
* [[lib_fr:FMX.Controls.TControl.OnKeyUp|OnKeyUp]]

Les événements suivants ne sont pas pris en charge et ne peuvent pas être implémentés dans [[lib_fr:FMX.Memo.TMemo|TMemo]] et [[lib_fr:FMX.Edit.TEdit|TEdit]] :

* {{Code|OnValidate}}

{{Note| L'événement {{Code|OnValidating}} se produit dans {{FM}} et dans la présentation native de [[lib_fr:FMX.Memo.TMemo|TMemo]] et [[lib_fr:FMX.Edit.TEdit|TEdit]].}}

==Voir aussi==

* [[Contrôles natifs de FireMonkey|Contrôles natifs de FireMonkey]]
* [[Contrôles iOS natifs de FireMonkey|Contrôles iOS natifs de FireMonkey]]
* [[lib_fr:FMX.Controls.Presentation.TPresentedControl.ControlType|TPresentedControl.ControlType]]
* [[Personnalisation de l'apparence de la vue liste FireMonkey|Personnalisation de l'apparence de la vue liste {{FM}}]]

===Exemples===

* Exemple [[samp_en:FMX.NativeControls Sample|{{FM}} Native Controls]]

{{DEFAULTSORT:Controles Windows natifs de FireMonkey}}
[[Category:Multi-périphérique]]
[[Category:FMX]]
[[Category:Seattle]]

[[en:FireMonkey Native Windows Controls]]
[[de:Native FireMonkey-Windows-Steuerelemente]]
[[ja:FireMonkey のネイティブ Windows コントロール]]

Notifications de changements de données (FireDAC)

2021-05-05T20:09:50Z

Fabiola.Arias : Added the {{Note|}} template

__TOC__
{{Parent|Utilisation des commandes (FireDAC)}}

La fonctionnalité Notifications de changements de données peut être utilisée pour informer les clients de bases de données des changements de données dans certaines bases de données. Cette fonction fait le suivi des modifications de données dans une base de données (comme les opérations {{code|INSERT}}, {{code|UPDATE}} ou {{code|DELETE}}) et en informe le client de la base de données.

FireDAC prend en charge la fonctionnalité Notifications de changements pour différentes base de données (voir [[#Prise en charge des notifications de changements|Prise en charge des notifications de changements]]). Toutefois, FireDAC utilise différentes méthodes pour implémenter cette fonctionnalité en fonction du type de base de données. Cette rubrique présente des informations générales concernant la fonctionnalité Notifications de changements de données de FireDAC, puis indique les [[#Notifications de changements de données pour les SGBD spécifiques|éléments à prendre en compte concernant des implémentations de SGBD spécifiques]].

Pour plus d'informations sur les mécanismes d'alerte des bases de données, voir [[Alertes des bases de données (FireDAC)|Alertes des bases de données]].

==Configurer une fonctionnalité Notifications de changements de données FireDAC==

Pour configurer la fonctionnalité Notifications de changements de données sur une application FireDAC, vous devez inclure et configurer les composants principaux suivants :

* Un objet [[lib_fr:FireDAC.Comp.Client.TFDConnection|TFDConnection]] - Il s'agit de l'objet connexion FireDAC utilisé pour établir la connexion à un SGBD.
{{Note| Cette section suppose que vous avez lu et compris la rubrique [[Premières étapes dans l'utilisation de FireDAC|Premières étapes dans l'utilisation de FireDAC]], qui fournit des instructions sur la façon de développer une application VCL simple pour se connecter à des bases de données exemple.}}

* Un objet [[lib_fr:FireDAC.Comp.Client.TFDQuery|TFDQuery]] - Il s'agit de l'objet FireDAC utilisé pour implémenter des ensembles de données capables d'exécuter des requêtes SQL. Vous devez configurer les propriétés de base suivantes de la requête SQL suivie :
** La propriété [[lib_fr:FireDAC.Comp.Client.TFDRdbmsDataSet.Connection|Connection]] doit être définie pour spécifier l'objet connexion FireDAC.
** La propriété [[lib_fr:FireDAC.Comp.Client.TFDQuery.SQL|SQL]] doit être définie avec l'instruction SQL souhaitée.
** La propriété [[lib_fr:FireDAC.Comp.Client.TFDQuery.ChangeAlerter|ChangeAlerter]] doit être définie pour spécifier l'objet alerte FireDAC associé à votre ensemble de données.
** La propriété [[lib_fr:FireDAC.Comp.Client.TFDQuery.ChangeAlertName|ChangeAlertName]] peut être définie pour spécifier le nom de la table de base dont les changements sont suivis.

* Un objet [[lib_fr:FireDAC.Comp.Client.TFDEventAlerter|TFDEventAlerter]] - Il s'agit des objets utilisés pour gérer les notifications de changements de bases de données. Vous devez configurer les propriétés de base suivantes de l'alerte d'événement :
** La propriété [[lib_fr:FireDAC.Comp.Client.TFDEventAlerter.Options|Options]] peut être utilisée pour spécifier un [[lib_fr:FireDAC.Stan.Option.TFDEventAlerterOptions|ensemble de propriétés]] de contrôle du comportement de l'alerte d'événement.
** La propriété [[lib_fr:FireDAC.Comp.Client.TFDEventAlerter.SubscriptionName|SubscriptionName]] doit être définie pour spécifier le nom d'abonnement de la notification de changement. Cela dépend du type de base de données que vous utilisez :
{{Note| Activez [[lib_fr:FireDAC.Comp.Client.TFDEventAlerter|TFDEventAlerter]] avant d'exécuter le [[lib_fr:FireDAC.Comp.Client.TFDQuery|TFDQuery]] suivi. En effet, l'instruction doit être recensée avec l'API de notification de requête avant son exécution. C'est une condition requise par SQL Server et Oracle.}}

==Réponses aux notifications de changement==

Dès qu'il reçoit une notification de changement de données, FireDAC récupère automatiquement les changements et met à jour l'ensemble de données. Ce processus est contrôlé par les propriétés suivantes du composant [[lib_fr:FireDAC.Comp.Client.TFDEventAlerter|TFDEventAlerter]] :

* [[lib_fr:FireDAC.Comp.Client.TFDCustomEventAlerter.Options|FireDAC.Comp.Client.TFDCustomEventAlerter.Options]].[[lib_fr:FireDAC.Stan.Option.TFDEventAlerterOptions.AutoRefresh|AutoRefresh]]
* [[lib_fr:FireDAC.Comp.Client.TFDCustomEventAlerter.Options|FireDAC.Comp.Client.TFDCustomEventAlerter.Options]].[[lib_fr:FireDAC.Stan.Option.TFDEventAlerterOptions.Timeout|Timeout]]
* [[lib_fr:FireDAC.Comp.Client.TFDCustomEventAlerter.Options|FireDAC.Comp.Client.TFDCustomEventAlerter.Options]].[[lib_fr:FireDAC.Stan.Option.TFDEventAlerterOptions.MergeData|MergeData]]

Les projets de démonstration listés sur [[#Notifications de changements de données pour les SGBD spécifiques|Notifications de changements de données pour les SGBD spécifiques]] montrent comment utiliser le scénario mentionné ci-dessus.

Par ailleurs, vous pouvez utiliser le gestionnaire d'événement [[lib_fr:FireDAC.Comp.Client.TFDCustomEventAlerter.OnAlert|TFDCustomEventAlerter.OnAlert]], qui est déclenché après la détection des changements effectués dans l'ensemble de données suivi. Ce gestionnaire d'événement vous permet d'implémenter votre scénario personnalisé afin de répondre à une notification de changement de données. Le code suivant implémente un gestionnaire d'événement [[lib_fr:FireDAC.Comp.Client.TFDCustomEventAlerter.OnAlert|OnAlert]] qui affiche un message lorsque des données de la base de données sont modifiées.

<l s="delphi" />'''{{Delphi}}''' : 
<source lang="Delphi">
procedure TForm1.FDEventAlerter1Alert(ASender: TFDCustomEventAlerter;
const AEventName: string; const AArgument: Variant);
begin
ShowMessage('Detected changes to the demo dataset.');
end;</source><l e="delphi" /><l s="cpp" />'''{{CBuilder}} :''' 
<source lang="cpp">
void __fastcall TForm1::FDEventAlerter1Alert(TFDCustomEventAlerter *ASender, const UnicodeString AEventName,
const Variant &AArgument)
{
ShowMessage("Detected changes to the demo dataset. ");
}</source><l e="cpp" />

==Prise en charge des notifications de changements==

Le tableau suivant récapitule les informations sur les mécanismes de notifications de changements utilisés pour chaque SGBD.

{| border="1" frame="hsides" rules="rows"
|-
! '''SGBD'''
! '''Type de notification de changement'''
! '''Type Delta'''
! '''TFDEventAlerter.SubscriptionName'''
|-
| style="text-align: left; vertical-align: top;" |InterBase
| style="text-align: left; vertical-align: top;" |Alerte d'événement (notification manuelle)
| style="text-align: left; vertical-align: top;" |Change Views (delta automatique)
| style="text-align: left; vertical-align: top;" |Nom d'abonnement InterBase Change View
|-
| style="text-align: left; vertical-align: top;" |MS SQL Server
| style="text-align: left; vertical-align: top;" |Notification des mises à jour de requête (notification automatique)
| style="text-align: left; vertical-align: top;" |Aucun (actualisation complète de l'ensemble de données)
| style="text-align: left; vertical-align: top;" |Texte du message de notification
|-
| rowspan="2" style="text-align: left; vertical-align: middle;" | Oracle
| style="text-align: left; vertical-align: top;" |DBMS_ALERT / DBMS_PIPE (notification manuelle)
| style="text-align: left; vertical-align: top;" |Aucun (actualisation complète de l'ensemble de données)
| style="text-align: left; vertical-align: top;" |Texte du message de notification
|-
| style="text-align: left; vertical-align: top;" |Continuous Query Notification (CQN)
| style="text-align: left; vertical-align: top;" |Delta automatique
| style="text-align: left; vertical-align: top;" |Toute valeur
|-
| style="text-align: left; vertical-align: top;" |Advantage Database
| style="text-align: left; vertical-align: top;" |Alerte d'événement (notification manuelle)
| style="text-align: left; vertical-align: top;" |Aucun (actualisation complète de l'ensemble de données)
| style="text-align: left; vertical-align: top;" |Texte du message de notification
|-
| style="text-align: left; vertical-align: top;" |Sybase SQL Anywhere
| style="text-align: left; vertical-align: top;" |Messages (notification manuelle)
| style="text-align: left; vertical-align: top;" |Aucun (actualisation complète de l'ensemble de données)
| style="text-align: left; vertical-align: top;" |Texte du message de notification
|-
| style="text-align: left; vertical-align: top;" |Serveur DataSnap
| style="text-align: left; vertical-align: top;" |Rappels (notification manuelle)
| style="text-align: left; vertical-align: top;" |Aucun (actualisation complète de l'ensemble de données)
| style="text-align: left; vertical-align: top;" |Texte du message de notification
|-
| style="text-align: left; vertical-align: top;" |DB2
| style="text-align: left; vertical-align: top;" |DBMS_ALERT / DBMS_PIPE (notification manuelle)
| style="text-align: left; vertical-align: top;" |Aucun (actualisation complète de l'ensemble de données)
| style="text-align: left; vertical-align: top;" |Texte du message de notification
|-
| style="text-align: left; vertical-align: top;" |Firebird
| style="text-align: left; vertical-align: top;" |Alerte d'événement (notification manuelle)
| style="text-align: left; vertical-align: top;" |Aucun (actualisation complète de l'ensemble de données)
| style="text-align: left; vertical-align: top;" |Texte du message de notification
|-
| style="text-align: left; vertical-align: top;" |Informix
| style="text-align: left; vertical-align: top;" |DBMS_ALERT (notification manuelle)
| style="text-align: left; vertical-align: top;" |Aucun (actualisation complète de l'ensemble de données)
| style="text-align: left; vertical-align: top;" |Texte du message de notification
|-
| style="text-align: left; vertical-align: top;" |PostgreSQL
| style="text-align: left; vertical-align: top;" |Notification d'événement (notification manuelle)
| style="text-align: left; vertical-align: top;" |Aucun (actualisation complète de l'ensemble de données)
| style="text-align: left; vertical-align: top;" |Texte du message de notification
|-
| style="text-align: left; vertical-align: top;" |SQLite
| style="text-align: left; vertical-align: top;" |Alerte d'événement (notification manuelle)
| style="text-align: left; vertical-align: top;" |Aucun (actualisation complète de l'ensemble de données)
| style="text-align: left; vertical-align: top;" |Texte du message de notification
|}

==Notifications de changements de données pour des SGBD spécifiques==

Cette section indique les éléments spécifiques à prendre en compte pour implémenter une fonctionnalité Notifications de changements de données pour différentes bases de données.

===InterBase Change Views===

La fonctionnalité Change Views est la méthode Interbase d'implémentation de la Notification de changements de données. Pour plus d'informations, voir [http://docwiki.embarcadero.com/InterBase/XE7/en/Change_Views Change Views (EN)].

Avant de développer une application InterBase qui utilise la fonctionnalité Change Views, vous devez créer un abonnement à Change Views. Le fragment de code suivant fournit un exemple de création de l'abonnement :

<source lang="sql">
/* Create the xxx subscription to track changes to the 'yyy' table */
CREATE SUBSCRIPTION xxx ON yyy FOR ROW (INSERT, UPDATE, DELETE);
</source>

Pour plus d'informations sur la configuration de la fonctionnalité Change Views, consultez le projet de démonstration dans :

* {{SamplesMenu}}, puis naviguez jusqu'à '''Object Pascal\Database\FireDAC\Samples\DBMS Specific\InterBase\ChangeView\Generic'''

===Oracle CQN===

La fonctionnalité Continuous Query Notification (CQN) est l'implémentation Oracle de la fonctionnalité Notifications de changements de données. Pour de plus amples informations, voir [http://docs.oracle.com/cd/B28359_01/appdev.111/b28395/oci10new.htm#CJGHFEDD Continuous Query Notification (EN)].

Pour configurer la fonctionnalité Oracle CQN, vous devez prendre en compte les considérations suivantes :

* Le client Oracle doit avoir le privilège '''notification de changement'''. Le fragment de code suivant montre comment donner à l'utilisateur ce privilège :

<blockquote><source lang="sql">
/* Give change notification privilege to the xxx Oracle user */
GRANT DBMS_CHANGE_NOTIFICATION TO xxx;
</source></blockquote>

* La propriété [[lib_fr:FireDAC.Comp.Client.TFDQuery.SQL|SQL]] doit inclure les [[Utilisation d'Oracle avec FireDAC#ROWID implicites|colonnes {{code|ROWID}}]] dans la liste {{code|SELECT}} de la table de base. Par exemple : {{code|SELECT t.ROWID, t.* FROM table t}}.
{{Note| L'identifiant {{code|ROWID}} est un [[Champs d'identification unique (FireDAC)|champ d'identification unique (FireDAC)]] pour une ligne dans une base de données. Il est créé au moment où la ligne est insérée dans la table, et est détruit lorsqu'elle est supprimée. Les valeurs ROWID ont plusieurs utilisations importantes. Par exemple, elles fournissent le moyen le plus rapide d'accéder à une ligne unique.}}

* Les propriétés suivantes de l'objet [[lib_fr:FireDAC.Comp.Client.TFDEventAlerter|TFDEventAlerter]] doivent être configurées comme suit :
** Définissez la propriété [[lib_fr:FireDAC.Comp.Client.TFDEventAlerter.Options|Options]].[[lib_fr:FireDAC.Stan.Option.TFDEventAlerterOptions.Kind|Kind]] sur {{code|QueryNotifies}}.
** Définissez la propriété [[lib_fr:FireDAC.Comp.Client.TFDEventAlerter.SubscriptionName|SubscriptionName]] sur n'importe quelle valeur. Cette propriété ne peut pas être vide. Sinon, la requête sera actualisée entièrement plutôt que de façon incrémentielle.

Pour plus d'informations sur la configuration de la fonctionnalité Oracle CQN, voir l'exemple [[samp_en:FireDAC.Oracle CQN Sample|FireDAC Oracle CQN]].

====Problèmes Oracle connus====

Certaines versions du logiciel client 11.2 ne peuvent pas recevoir de notifications de changements, de notifications de rappels OCI ou de notifications Advanced Queuing (AQ) de certaines versions de bases de données 11.2. Il s'agit d'un problème Oracle connu. Vous trouverez plus d'informations dans la [https://support.oracle.com/epmos/faces/DocumentDisplay?id=1310859.1 page (EN)] Oracle suivante.

===Microsoft SQL===

Pour plus d'informations sur la configuration de la fonctionnalité Notifications de changements de données pour une base de données MSSQL, consultez le projet de démonstration dans :

* {{SamplesMenu}}, puis naviguez jusqu'à '''Object Pascal\Database\FireDAC\Samples\DBMS Specific\MSSQL\QueryNotify'''.

==Voir aussi==

* [[Alertes des bases de données (FireDAC)|Alertes des bases de données (FireDAC)]]
* [[lib_fr:FireDAC.Comp.Client.TFDEventAlerter|FireDAC.Comp.Client.TFDEventAlerter]]
* [[lib_fr:FireDAC.Comp.Client.TFDQuery|FireDAC.Comp.Client.TFDQuery]]

{{DEFAULTSORT:Notifications de changements de donnees (FireDAC)}}
[[Category:FireDAC]]
[[Category:AMMigrate]]

[[en:Data Change Notifications (FireDAC)]]
[[de:Benachrichtigungen über Datenänderungen (FireDAC)]]
[[ja:データ変更通知（FireDAC）]]

Conversion d'un thread anonyme en thread nommé

2021-05-05T18:38:04Z

Fabiola.Arias : Added the {{Note|}} template

{{Parent|Nommer un thread}}

Vous pouvez convertir un thread anonyme en thread nommé. Si, par exemple, vous avez une classe thread créée avec {{Delphi}} 6 ou une version antérieure, convertissez-la en thread nommé.

<l s="delphi" />
'''Pour convertir un thread anonyme en thread nommé dans {{Delphi}}'''

<ol><li>
Ajoutez l'unité Windows à la clause '''uses''' de l'unité dans laquelle votre thread est déclaré :
<source lang="delphi">
uses
Classes {$IFDEF MSWINDOWS} , Windows {$ENDIF};
</source></li>
<li>Ajoutez la méthode ''SetName'' à votre classe de thread dans la section '''interface''' :
<source lang="delphi">
type
TMyThread = class(TThread)
private
procedure SetName;
protected
procedure Execute; override;
end;
</source></li>
<li>
Ajoutez l'enregistrement ''TThreadNameInfo'' et la méthode ''SetName'' dans la section '''implementation''' :
<source lang="delphi">
{$IFDEF MSWINDOWS}
type
TThreadNameInfo = record
FType: LongWord; // must be 0x1000
FName: PChar; // pointer to name (in user address space)
FThreadID: LongWord; // thread ID (-1 indicates caller thread)
FFlags: LongWord; // reserved for future use, must be zero
end;
{$ENDIF}
{ TMyThread }
procedure TMyThread.SetName;
{$IFDEF MSWINDOWS}
var
ThreadNameInfo: TThreadNameInfo;
{$ENDIF}
begin
{$IFDEF MSWINDOWS}
ThreadNameInfo.FType := $1000;
ThreadNameInfo.FName := 'MyThreadName';
ThreadNameInfo.FThreadID := $FFFFFFFF;
ThreadNameInfo.FFlags := 0;
try
RaiseException( $406D1388, 0, sizeof(ThreadNameInfo) div sizeof(LongWord), @ThreadNameInfo );
except
end;
{$ENDIF}
end;
</source>

{{Note| Définissez ''TThreadNameInfo'' sur le nom de votre classe thread.}}
:Le débogueur trouve l'exception et recherche le nom du thread dans la structure transmise. Lors du débogage, le débogueur affiche le nom du thread dans le champ ID thread de la boîte Etat des threads.
</li>
<li>
Ajoutez un appel à la méthode ''SetName'' au début de la méthode ''Execute'' du thread :
<source lang="delphi">
procedure TMyThread.Execute;
begin
SetName;
{ Place thread code here }
end;
</source></li>
</ol>

<l e="delphi" />

<l s="cpp" />
'''Pour convertir un thread anonyme en thread nommé dans {{CBuilder}}'''

Vous pouvez convertir un thread anonyme en thread nommé. Si, par exemple, vous avez une classe de thread créée avec {{CBuilder}} 5 ou une version antérieure, convertissez-la en thread nommé en suivant la procédure suivante.

<ol><li>Ajoutez la méthode ''SetName'' à votre classe de thread :
<source lang="cpp">
void TMyThread::SetName() {
THREADNAME_INFO info;
info.dwType = 0x1000;
info.szName = "MyThreadName";
info.dwThreadID = -1;
info.dwFlags = 0;
__try {
RaiseException(0x406D1388, 0, sizeof(info) / sizeof(DWORD),
(DWORD*)&info);
}
__except (EXCEPTION_CONTINUE_EXECUTION) {
}
}
</source>

{{Note| Définissez <code>info.szName</code> sur le nom de votre classe thread.}}

Le débogueur trouve l'exception et recherche le nom du thread dans la structure transmise. Lors du débogage, le débogueur affiche le nom du thread dans le champ ID thread de la boîte Etat des threads.

</li>
<li>Ajoutez un appel à la méthode ''SetName'' au début de la méthode ''Execute'' du thread :
<source lang="cpp">void __fastcall TMyThread::Execute() {
SetName();
// ---- Place existing Execute method code here ----
}
</source></li>
</ol>

<l e="cpp" />

==Voir aussi==

*[[Nommer un thread|Nommer un thread]]
*[[Assignation de noms distincts à des threads similaires|Assignation de noms distincts à des threads similaires]]

{{DEFAULTSORT:Conversion d'un thread anonyme en thread nomme}}
[[Category:Guide du développeur Windows]]
[[Category:Delphi]]

[[en:Converting an Unnamed Thread to a Named Thread]]
[[de:Einen unbenannten Thread in einen benannten konvertieren]]
[[ja:名前のないスレッドを名前付きのスレッドに変換する]]

Exécution des commandes (FireDAC)

2021-04-14T02:54:54Z

Fabiola.Arias : Added the {{Note|}} template

{{Parent|Utilisation des commandes (FireDAC)}}
__TOC__

==Utilisation de TFDConnection==

[[lib_fr:FireDAC.Comp.Client.TFDConnection|TFDConnection]] fournit des méthodes [[lib_fr:FireDAC.Comp.Client.TFDCustomConnection.ExecSQL|ExecSQL]]. Simples d'emploi, ces méthodes surchargées sont utiles dans les cas suivants :

* Aucun ensemble de résultats n'est renvoyé.
* Une commande SQL n'est exécutée qu'une fois et n'a donc pas besoin d'être stockée dans un état préparé.
* Il n'est pas nécessaire de définir des paramètres avancés.
* Il n'est pas nécessaire de définir des commandes SQL à la conception.

Par exemple, pour exécuter des commandes DDL, utilisez la syntaxe suivante :

<source lang="delphi">
FDConnection1.ExecSQL('drop table testtab');
FDConnection1.ExecSQL('create table testtab (id integer, name varchar(10))');
FDConnection1.ExecSQL('insert into testtab values (1, ''FireDAC'')');
</source>

Pour exécuter une requête paramétrée, utilisez l'autre méthode surchargée :

<source lang="delphi">
FDConnection1.ExecSQL('insert into testtab values (:id, :name)', [1, 'FireDAC']);
</source>

De même, TFDConnection fournit des méthodes [[lib_fr:FireDAC.Comp.Client.TFDCustomConnection.ExecSQLScalar|ExecSQLScalar]] différentes des méthodes '''ExecSQL''', dans la mesure où elles renvoient une valeur d'ensemble de résultats unique :

<source lang="delphi">
sName := FDConnection1.ExecSQLScalar('select name from testtab where id = :id', [1]);
</source>

==Utilisation de TFDQuery==

En général, [[lib_fr:FireDAC.Comp.Client.TFDQuery|TFDQuery]] est défini à la conception et/ou à l'exécution.

===Définition de TFDQuery à la conception===

Pour définir TFDQuery à la conception, déposez-le sur une fiche. [[lib_fr:FireDAC.Comp.Client.TFDRdbmsDataSet.Connection|TFDQuery.Connection]] sera automatiquement défini pour pointer vers un composant TFDConnection sur cette fiche, s'il en existe un. Ensuite, double-cliquez sur TFDQuery pour invoquer l'éditeur de requête FireDAC :

[[File:AD QueryDlg.png]]

De cet emplacement, vous pouvez spécifier du texte SQL et, en option, indiquer des valeurs de paramètre et de macro et définir des options.

Appuyez sur le bouton '''Exécuter''' pour exécuter la requête. Si une commande renvoie un ensemble de résultats, celui-ci s'affichera dans le volet '''Ensemble d'enregistrements''' et la structure de l'ensemble de résultats s'affichera dans le volet '''Structure'''. Si le SGBD renvoie des messages ou des avertissements pour une commande, ceux-ci s'afficheront dans le volet '''Messages'''. Le bouton '''Ensemble d'enregistrements suivant''' vous permet de parcourir tous les ensembles de résultats renvoyés par la commande.

Lorsque vous testez des commandes DML, telles que '''UPDATE'''/'''INSERT'''/'''DELETE''', vous devez activer la case à cocher '''Restauration automatique''' pour annuler automatiquement les actions effectuées par une commande.

Appuyez sur OK pour enregistrer les modifications dans le composant TFDQuery.

===Utilisation des paramètres===

L'utilisation des requêtes paramétrées est l'une des meilleures pratiques du développement d'applications de base de données SQL. Les principaux avantages sont les suivants :

* Vous avez la possibilité de composer une commande SQL unique et de l'utiliser plusieurs fois avec des valeurs de paramètre différentes. Le SGBD construira le plan d'exécution de la commande une seule fois, Cela réduit la charge du moteur du SGBD.
* A la prochaine exécution de la commande, seules les valeurs de paramètre seront transférées au moteur du SGBD, réduisant ainsi la charge du réseau.
* Vous n'avez pas besoin d'écrire des formats de constante SQL sans erreur, par exemple une constante de date dans Microsoft Access SQL.

Pour insérer un marqueur de paramètre dans le texte SQL, utilisez la syntaxe ''':<name>'''. Assignez ensuite les valeurs correspondantes à l'aide de la collection Params. Par exemple :

<source lang="delphi">
FDQuery1.SQL.Text := 'select * from tab where code = :Code';
FDQuery1.ParamByName('code').AsString := '123';
FDQuery1.Open;
</source>

Avant l'exécution de la requête, chaque paramètre '''Name''', '''DataType''' et '''ParamType''' doit être rempli. Le paramètre '''Position''' doit également être défini.

Lorsque vous assignez la propriété SQL et que la propriété '''ResourceOptions.ParamCreate''' vaut '''True''', la collection Params est automatiquement remplie.

{{Note| Seules les propriétés '''TFDParam.Name''' et '''TFDParam.Position''' sont définies. Les propriétés '''DataType''', '''ParamType''' et les autres propriétés doivent être définies dans votre application. Les paramètres de la collection Params apparaissent dans le même ordre que dans la commande SQL.}}

Vous pouvez également remplir la collection Params par du code. Pour cela, vous devez désactiver la création automatique de paramètres en définissant la propriété '''ResourceOptions.ParamCreate''' sur '''False'''. Par exemple :

<source lang="delphi">
FDQuery1.ResourceOptions.ParamCreate := False;
FDQuery1.SQL.Text := 'select * from tab where code = :Code';
with FDQuery1.Params do begin
Clear;
with Add do begin
Name := 'CODE';
DataType := ftString;
Size := 10;
ParamType := ptInput;
end;
end;
</source>

Les paramètres peuvent être liés à la commande SQL par nom ou par position. Pour contrôler les points suivants, utilisez la propriété Params.BindMode :

* '''pbByName'''. Les paramètres de la collection Params seront liés par la propriété '''Name''' aux marqueurs de paramètre correspondants. Si la commande SQL comporte des marqueurs de paramètre portant les mêmes noms, une seule instance apparaîtra dans la collection Params.
* '''pbByNumber'''. Les paramètres de la collection Params seront liés par la propriété '''Position''' aux marqueurs du texte de la commande SQL. Si la commande SQL comporte des marqueurs de paramètre portant les mêmes noms, chaque occurrence apparaîtra dans la collection Params. Si la propriété '''Position''' n'est pas définie pour les paramètres, elle sera assignée automatiquement lors de la préparation de commande à l'aide des index de paramètres. La propriété Position commence à 1.

La propriété DataType est spécifiée soit explicitement, soit implicitement, par l'assignation d'une valeur de paramètre à la propriété '''Value''' ou '''AsXxxx'''. Sinon, la propriété [[lib_fr:FireDAC.Stan.Option.TFDFormatOptions.DefaultParamDataType|FormatOptions.DefaultParamDataType]] est utilisée.

Lorsque la propriété '''ParamType''' n'est pas spécifiée, la propriété [[lib_fr:FireDAC.Stan.Option.TFDResourceOptions.DefaultParamType|ResourceOptions.DefaultParamType]] est utilisée. Par défaut, tous les paramètres sont des paramètres d'entrée uniquement. Si vous souhaitez utiliser des paramètres de sortie, vous devez spécifier la propriété ParamType de manière explicite.

Les valeurs de paramètre d'entrée doivent être définies avant l'exécution de la requête. Pour cela, choisissez l'une des options suivantes :

* Assignez des valeurs de paramètre de manière explicite :

<source lang="delphi">
FDQuery1.ParamByName('code').AsString := 'DA1001';
FDQuery1.Open;
</source>

* Utilisez l'une des méthodes '''ExecSQL''' ou '''Open''' surchargées :

<source lang="delphi">
FDQuery1.Open('', ['DA1001']);
</source>

Pour définir la valeur du paramètre sur '''Null''', spécifiez le type de données du paramètre, puis appelez la méthode '''Clear''' :

<source lang="delphi">
with FDQuery1.ParamByName('name') do begin
DataType := ftString;
Clear;
end;
FDQuery1.ExecSQL;
</source>

Les valeurs de paramètre de sortie sont accessibles après l'exécution de la requête. Certaines commandes SQL et le SGBD peuvent requérir en premier lieu le traitement de tous les ensembles de résultats de commande, suivi de la réception des valeurs de paramètre de sortie. Pour forcer l'obtention des valeurs de paramètre de sortie, utilisez la méthode [[lib_fr:FireDAC.Comp.Client.TFDAdaptedDataSet.GetResults|TFDAdaptedDataSet.GetResults]]. Consultez également la rubrique [[Support unifié de RETURNING (FireDAC)|Support unifié de RETURNING]] concernant les paramètres de sortie dans la phrase RETURNING sous Firebird et Oracle.

===Préparation de la requête===

Une requête doit être préparée avant d'être exécutée. Pour cela, FireDAC réalise automatiquement les actions suivantes :

* Met la connexion à l'état [[Etablissement d'une connexion (FireDAC)|active]] ou [[Connexion hors ligne (FireDAC)|en ligne]].
* Vérifie que tous les paramètres sont définis correctement.
* [[Prétraitement du texte des commandes (FireDAC)|Prétraite le texte des commandes]].
* En option, applique [[lib_fr:FireDAC.Stan.Option.TFDFetchOptions.RecsSkip|RecsSkip]] et [[lib_fr:FireDAC.Stan.Option.TFDFetchOptions.RecsMax|RecsMax]] au texte de la commande.
* En option, démarre une transaction pour le SGBD Firebird/InterBase, lorsqu'il n'y a pas de connexion active.
* Transfère le texte de commande final à l'API du SGBD. Le texte final est obtenu à l'aide de la propriété [[lib_fr:FireDAC.Comp.Client.TFDCustomQuery.Text|TFDQuery.Text]].

Lors de la préparation de la commande, la connexion doit être active et la requête conserve les ressources du serveur. Pour annuler la préparation de la requête et libérer toutes les ressources, utilisez la méthode '''Unprepare''' ou '''Disconnect'''.

Si vous devez exécuter une commande une seule fois, définissez la propriété [[lib_fr:FireDAC.Stan.Option.TFDResourceOptions.DirectExecute|ResourceOptions.DirectExecute]] sur '''True'''. Pour certains SGBD (SQL Server, SQL Anywhere), cette action permet d'accélérer l'exécution car elle évite l'opération coûteuse de préparation de commande SQL.

===Exécution de la requête===

Pour exécuter une requête qui ne renvoie aucun ensemble de résultats, utilisez les méthodes '''ExecSQL'''. Si une requête renvoie un ensemble de résultats, l'exception "'''[FireDAC][Phys][MSAcc]-310. Impossible d'exécuter la commande retournant un ensemble de résultats'''" est déclenchée.

Pour exécuter une requête, renvoyer et ouvrir un ensemble de résultats, utilisez les méthodes '''Open'''. Si une requête ne renvoie aucun ensemble de résultats, l'exception "'''[FireDAC][Phys][MSAcc]-308. Impossible d'ouvrir / définir la commande, qui ne retourne aucun ensemble de résultats'''" est déclenchée.

Pour exécuter une requête ad hoc, utilisez la méthode '''ExecuteOrOpen'''.

{{Note| La requête peut être [[Exécution asynchrone (FireDAC)|exécutée de manière asynchrone]]. Si la requête est un groupe de commandes, consultez la rubrique "'''[[Groupes de commandes (FireDAC)|Groupes de commandes]]'''" pour plus d'informations.}}

===Exception '''Le type de données du paramètre est modifié'''===

Si le type du paramètre a été modifié après le premier appel de la méthode Prepare/ExecSQL/Open, FireDAC déclenche une exception sur un appel suivant :

<source lang="delphi">
[FireDAC][Phys][IB]-338. Parameter [Xxxx] data type is changed.
Query must be reprepared.
</source>

Au premier appel de la méthode Prepare/ExecSQL/Open, FireDAC mémorise le type de données du paramètre. Le type de données peut être spécifié soit explicitement en définissant la '''propriété TFDParam.DataType''', soit implicitement en assignant une valeur à l'aide de la propriété '''TFDParam.AsXxxx''' ou '''TFDParam.Value'''. Comme l'application modifie le type de données du paramètre avant l'appel suivant de la méthode ExecSQL/Open, lorsque ExecSQL/Open est rappelée, l'exception "Le type de données du paramètre [xxxxx] est modifié" est déclenchée.

La propriété '''TFDParam.Value''' ne modifie pas le type de données du paramètre lors de l'appel suivant. Elle transtype la valeur assignée dans le type de données en cours. Par conséquent, pour éviter l'exception ci-dessus, utilisez :

* La valeur de la propriété '''TFDParam.Value'''.
* La propriété '''TFDParam.AsXxxx''', puisque '''Xxxx''' a été utilisé la première fois.

===Retour d'informations du SGBD===

Utilisez la propriété [[lib_fr:FireDAC.Comp.Client.TFDRdbmsDataSet.RowsAffected|TFDQuery.RowsAffected]] pour obtenir le nombre de lignes traitées par la commande (par exemple, le nombre de lignes supprimées par la commande DELETE).

{{Note| Pour Microsoft SQL Server, la propriété '''RowsAffected''' peut inopinément être égale à -1 lorsqu'une procédure stockée ou un déclencheur de table omet le paramètre SET NOCOUNT ON. Utilisez alors la propriété '''TFDQuery.RecordCount''' pour obtenir le nombre de lignes extraites. }}

{{Note| FireDAC ne renvoie aucun message "N lignes traitées". Si nécessaire, l'application doit construire ce type de messages. }}

Si la commande renvoie une erreur, une exception est déclenchée. Pour plus d'informations, voir la rubrique [[Gestion des erreurs (FireDAC)|Gestion des erreurs]]. L'exception peut être traitée selon l'une des trois méthodes suivantes :

* En utilisant la construction try/except/end. Par exemple :

<source lang="delphi">
try
FDQuery1.ExecSQL;
except
on E: EFDDBEngineException do
; // do something here
end;
</source>

* En définissant le gestionnaire d'événement [[lib_fr:FireDAC.Comp.Client.TFDAdaptedDataSet.OnError|TFDQuery.OnError]].
* En définissant le gestionnaire d'événement [[lib_fr:FireDAC.Comp.Client.TFDCustomConnection.OnError|TFDConnection.OnError]]. Par exemple :

<source lang="delphi">
procedure TForm1.FDConnection1Error(ASender: TObject; const AInitiator: IFDStanObject;
var AException: Exception);
begin
if (AException is EFDDBEngineException) and (EFDDBEngineException(AException).Kind = ekRecordLocked) then
AException.Message := 'Please, try the operation later. At moment, the record is busy';
end;

FDConnection1.OnError := FDConnection1Error;
</source>

Pour la commande Array DML, la gestion des erreurs est plus complexe.

En outre, la commande renvoie des avertissements, des conseils et des messages, selon le SGBD utilisé. Pour activer le traitement des messages, définissez [[lib_fr:FireDAC.Stan.Option.TFDTopResourceOptions.ServerOutput|ResourceOptions.ServerOutput]] sur '''True'''. Pour traiter les messages, utilisez la propriété [[lib_fr:FireDAC.Comp.Client.TFDCustomConnection.Messages|TFDConnection.Messages]]. Par exemple :

<source lang="delphi">
var
i: Integer;
begin
FDConnection1.ResourceOptions.ServerOutput := True;
FDQuery1.ExecSQL;
if FDConnection1.Messages <> nil then
for i := 0 to FDConnection1.Messages.ErrorCount - 1 do
Memo1.Lines.Add(FDConnection1.Messages[i].Message);
end;
</source>

Certains SGBD, tels SQL Server, renvoient des messages en tant qu'ensemble de résultats supplémentaire. Pour traiter les messages, l'application doit donc traiter plusieurs ensembles de résultats. Voici un exemple plus complexe qui fournit le statut et des messages pour SQL Server. Comme vous pouvez le constater, nous utilisons '''TFDMemTable''' pour stocker les ensembles de résultats avec les lignes.

<source lang="delphi">
var
i: Integer;
begin
FDConnection1.ResourceOptions.ServerOutput := True;
FDQuery1.FetchOptions.AutoClose := False;
FDQuery1.Open('select * from Region; print ''Hello''');
FDMemTable1.Data := FDQuery1.Data;
Memo1.Lines.Add(Format('%d rows processed', [FDMemTable1.RecordCount]));
FDQuery1.NextRecordSet;
if FDConnection1.Messages <> nil then
for i := 0 to FDConnection1.Messages.ErrorCount - 1 do
Memo1.Lines.Add(FDConnection1.Messages[i].Message);
end;
</source>

==Exécution de requêtes et transactions==

Par défaut, toutes les exécutions de commande SQL sont effectuées en mode Validation automatique. Cela signifie que, s'il n'y a pas de transaction active juste avant l'exécution d'une commande, cette transaction implicite démarre. De la même façon, juste après l'exécution de la commande, la transaction se termine :

* par '''Commit''', si l'exécution a abouti.
* par '''Rollback''', si l'exécution a échoué.

Pour Firebird et InterBase, une transaction implicite démarre juste avant la préparation de la requête. Il est inutile d'encapsuler une exécution de commande unique dans des transactions explicites ; il suffit d'utiliser le mode Validation automatique.

==Avancées==

La plupart des applications de base de données comportent des utilitaires d'administration dorsaux qui doivent exécuter un script SQL. Les lignes contenues dans ces scripts sont compatibles avec la syntaxe des scripts SQL du SGBD. Pour exécuter les [[Exécution de scripts SQL (FireDAC)|scripts SQL]], utilisez le composant [[lib_fr:FireDAC.Comp.Script.TFDScript|TFDScript]].

Parfois, une application de base de données exécute des requêtes hétérogènes à l'aide de tables provenant de plusieurs bases de données ou exécute des commandes SQL sur les descendants '''TDataSet''' à la place des tables de base de données. Pour exécuter de telles requêtes, utilisez [[SQL local (FireDAC)|le moteur SQL local]] et le composant [[lib_fr:FireDAC.Phys.SQLiteVDataSet.TFDLocalSQL|TFDLocalSQL]].

==Voir aussi==

*[[Exécution des procédures stockées (FireDAC)|Exécution des procédures stockées]]
*[[Navigation dans la table (FireDAC)|Navigation dans la table]]
*[[Groupes de commandes (FireDAC)|Groupes de commandes]]
*[[Exécution asynchrone (FireDAC)|Exécution asynchrone]]
*[[SQL local (FireDAC)|SQL local]]

{{DEFAULTSORT:Execution des commandes (FireDAC)}}
[[Category:FireDAC]]
[[Category:AMMigrate]]

[[en:Executing Commands (FireDAC)]]
[[de:Ausführen von Anweisungen (FireDAC)]]
[[ja:コマンドの実行（FireDAC）]]

Fonctions inline

2021-04-12T20:59:29Z

Fabiola.Arias : Added the {{Note|}} template

{{Parent|Classes - Index}}
<ideTag id="inline"></ideTag>Vous pouvez déclarer des fonctions membres dans leur classe et les définir ailleurs. Vous pouvez aussi les déclarer et les définir dans leur classe : ces fonctions sont dites ''fonctions inline''.

Le compilateur peut parfois réduire le temps d'appel d'une fonction en remplaçant l'appel directement par le code compilé du corps de la fonction. Ce processus, dit de développement inline d'un corps de fonction, n'affecte pas la portée du nom ni les arguments de la fonction. Les développements inline ne sont pas toujours réalisables. Le spécificateur '''[[inline]]''' indique au compilateur que vous souhaitez un développement inline.

{{Note| Le compilateur peut ignorer les demandes de développement inline.}}

Les demandes explicites et implicites '''inline''' sont plutôt réservées à des petites fonctions, fréquemment utilisées, comme, par exemple, les fonctions opérateur qui implémentent des opérateurs de surcharge. La déclaration de classe de ''func'' :

<source lang="cpp">

int i; // int global
class X {
public:
char* func(void) { return i; } // inline par défaut
char* i;
};
</source>

est l'équivalent de :

<source lang="cpp">
inline char* X::func(void) { return i; }
</source>

''func'' est définie "hors" de la classe avec un spécificateur '''inline''' explicite. La valeur ''i'' renvoyée par ''func'' est le <code>char* i</code> de la classe ''X'' (voir Portée des membres).

==Fonctions inline et exceptions==

Une fonction inline avec spécification d'exception ne sera jamais développée en ligne par le compilateur. Par exemple,

<source lang="cpp">
inline void f1() throw(int)
{
// Avertissement : Les fonctions avec spécification d'exception ne sont pas développées
}
</source>

Les restrictions restantes ne s'appliquent que lorsque l'élimination des destructeurs est activée.

{{Note| Les destructeurs sont appelés par défaut. Voir Initialisation des options de gestion des exceptions pour de plus amples informations sur les options de gestion des exceptions.}}

Une fonction inline qui accepte au moins un paramètre du type "classe avec un destructeur" ne sera pas développée inline. Remarquez que cette restriction ne s'applique qu'aux classes transmises par référence.

'''Exemple :

<source lang="cpp">
struct foo {
foo();
~foo();
};
inline void f2(foo& x)
{
// pas d'avertissement, f2() peut être développé inline
}
inline void f3(foo x)
{
// Avertissement : Les fonctions acceptant le ou les arguments classe-par-valeur
// ne sont pas développées inline dans la fonction f3(foo)
}
</source>

Une fonction inline qui renvoie par valeur une classe contenant un destructeur ne sera pas développée inline chaque fois que des variables ou des objets temporaires devront être détruits dans l'expression renvoyée :

<source lang="cpp">
struct foo {
foo();
~foo();
};
inline foo f4()
{
return foo();
// pas d'avertissement, f4() peut être développée inline
}
inline foo f5()
{
foo X;
return foo(); // L'object X doit être détruit
// Avertissement : Les fonctions contenant les instructions
// renvoyées ne sont pas développées inline dans la fonction f5()
}
inline foo f6()
{
return ( foo(), foo() ); // provisoire dans la valeur renvoyée
// Avertissement : les fonctions contenant les instructions
// renvoyées ne sont pas développées inline dans la fonction f6()
}

</source>

==Voir aussi==
* [[inline]]
* [[Pragma inline|#pragma inline]]
* [[Classes C++]]
* [[Types de classes]]
* [[Portée de classe]]
* [[Objets de classes]]
* [[Liste des membres de classe]]
* [[Fonctions membres]]
* [[Mot clé This]]
* [[Membres statiques (C++)]]
* [[Portée des membres]]
* [[Déclarations de types imbriqués]]
* [[Contrôle d'accès aux membres]]
* [[Accès aux classes de base et dérivées]]
* [[Classes de base virtuelles]]
* [[Amies de classes]]

[[Catégorie:Référence C++]]
[[Catégorie:C++]]
[[Catégorie:AMMigrate]]

[[en:Inline Functions]]
[[de:Inline-Funktionen]]
[[ja:インライン関数]]

Accès aux classes de base et dérivées

2021-03-24T13:03:47Z

Fabiola.Arias : Added the {{Note|}} template

{{Parent|Portée des membres - Index}}

Lorsque vous déclarez une classe dérivée D, vous énumérez les classes de base B1, B2, ... dans une liste-bases dont le délimiteur est une virgule :

: <code>class-key D : base-list { <member-list> }</code>

D hérite de tous les membres de ces classes de base. Les membres des classes de base redéfinies sont obtenus par héritage et sont accessibles via une redéfinition de portée. D ne peut utiliser que des membres '''public''' ou '''protected''' de ses classes de base. Mais quels vont être les attributs d'accès des membres dérivés tels que les voit D ? D souhaitera, par exemple, utiliser un membre '''public''' d'une classe de base, mais le rendre '''private''' dans la mesure où des fonctions extérieures sont impliquées. La solution consiste à appliquer des spécificateurs d'accès dans la liste-bases.

{{Note| Puisqu'une classe de base peut être elle-même une classe dérivée, la question de l'attribut d'accès est récursive : vous revenez en arrière jusqu'à ce que vous parveniez à la première des classes de base, celle qui n'a hérité d'aucune autre.}}

Lorsque vous déclarez D, vous pouvez utiliser le spécificateur d'accès '''public''', '''protected''' ou '''private''' devant chaque classe de la liste-bases :

<source lang="cpp">
class D : public B1, private B2 /* , … */ {
// …
}
</source>

Ces modificateurs ne changent pas les attributs d'accès des membres de base tels qu'ils sont perçus par la classe de base, même s'ils peuvent modifier ceux des membres de base tels que les voit la classe dérivée.

La valeur par défaut est private si D est une déclaration class, et public si D est une déclaration struct.

{{Note| Les unions ne peuvent contenir aucune classe de base ni être utilisées comme classes de base.}}

La classe dérivée hérite des attributs d'accès d'une classe de base selon les principes suivants :

* Classe de base '''public''' : les membres à accès '''public''' de la classe de base sont des membres '''public''' de la classe dérivée. Les membres à accès '''protected''' de la classe de base sont des membres '''protected''' de la classe dérivée. Les membres à accès '''private''' de la classe de base restent '''private''' pour cette classe.
* Classe de base '''protected''' : les membres à accès '''public''' et '''protected''' de la classe de base sont des membres '''protected''' de la classe dérivée. Les membres à accès '''private''' de la classe de base restent des membres '''private''' de cette classe.
* Classe de base '''private''' : les membres à accès '''public''' et '''protected''' de la classe de base sont des membres '''private''' de la classe dérivée. Les membres à accès '''private''' de la classe de base restent des membres '''private''' de cette classe.

Vous remarquerez que les membres '''private''' d'une classe de base sont, et restent, inaccessibles aux fonctions membres de la classe dérivée, à moins que vous ne déclariez explicitement un spécificateur '''friend''' dans la classe de base pour autoriser l'accès. Par exemple :

<source lang="cpp">
/* class X is derived from class A */
class X : A { // default for class is private A
// …
}
/* class Y is derived (multiple inheritance) from B and C
B defaults to private B */
class Y : B, public C { // override default for C
// …
}
/* struct S is derived from D */
struct S : D { // default for struct is public D
// …
}
/* struct T is derived (multiple inheritance) from D and E
E defaults to public E */
struct T : private D, E { // override default for D
// E is public by default
// …
}
</source>

Les effets dus aux spécificateurs d'accès dans la liste de base sont adaptables à l'aide d'un nom-qualifié dans les déclarations public ou protected de la classe dérivée. Par exemple :

<source lang="cpp">
class B {
int a; // private by default
public:
int b, c;
int Bfunc(void);
};
class X : private B { // a, b, c, Bfunc are now private in X
int d; // private by default, NOTE: a is not
// accessible in X
public:
B::c; // c was private, now is public
int e;
int Xfunc(void);
};
int Efunc(X& x); // external to B and X
</source>

La fonction Efunc() ne peut utiliser que les noms publics c, e et Xfunc().

La fonction Xfunc() de X, et dérivée de '''private''' B, a accès :

* à c "devenu public"
* aux membres "private-pour-X" à partir de B : b et Bfunc()
* aux membres private et public de X : d, e et Xfunc()

Cependant, Xfunc() ne peut pas accéder au membre "private-pour-B", a.

==Voir aussi==

*[[Classes C++|Classes C++]]
*[[Types de classes|Types classe]]
*[[Portée de classe|Portée de classe]]
*[[Objets de classes|Objets de classes]]
*[[Liste des membres de classe|Liste des membres de classe]]
*[[Fonctions membres|Fonctions membres]]
*[[Mot clé This|Mot clé This]]
* [[This|this]]
*[[Membres statiques (C++)|Membres statiques (C++)]]
*[[Fonctions inline|Fonctions inline]]
*[[Portée des membres|Portée des membres]]
*[[Types imbriqués|Types imbriqués]]
*[[Contrôle d'accès aux membres|Contrôle d'accès aux membres]]
*[[Classes de base virtuelles|Classes de base virtuelles]]
*[[Amies de classes|Amies de classes]]

{{DEFAULTSORT:Acces aux classes de base et derivees}}
[[Category:Référence C++]]
[[Category:C++]]
[[Category:AMMigrate]]

[[en:Base And Derived Class Access]]
[[de:Zugriff auf Basisklassen und abgeleitete Klassen]]
[[ja:基底クラスと派生クラスへのアクセス]]

Dynamic cast (opérateur de transtypage C++)

2021-03-24T12:36:52Z

Fabiola.Arias : Added the {{Note|}} template

{{Parent|Liste alphabétique des mots clés - Index}}
{{DISPLAYTITLE:dynamic_cast (opérateur de transtypage C++)}}

'''Catégorie'''

[[Mots clés spécifiques C++|Mots clés spécifiques C++]]

'''Description'''

Dans l'expression :

dynamic_cast< T > (ptr)

T doit être un pointeur, ou une référence, à un type classe défini ou '''void'''*. L'argument ptr doit être une expression résultant en un pointeur ou en une référence.

Si T est void*, ptr doit aussi être un pointeur. Le pointeur qui en résulte peut alors accéder à tout élément de la classe la plus dérivée dans la hiérarchie. Une classe de ce genre ne peut servir de base à aucune autre classe.

Les conversions de classe dérivée en classe de base, ou de classe dérivée en une autre, se présentent comme suit : si T est un pointeur et si ptr pointe sur une classe qui n'est pas de base, mais qui entre dans la hiérarchie, le résultat est un pointeur sur la sous-classe unique. Les références sont traitées de la même manière : si T est une référence et ptr une référence à une classe non base, le résultat est une référence à l'unique sous-classe.

La conversion d'une classe de base en classe dérivée ne peut être effectuée que si la base est de type polymorphe.

La conversion en classe de base est résolue au moment de la compilation. La conversion d'une classe de base en classe dérivée ou la conversion à travers une hiérarchie, est résolue au moment de l'exécution.

Si la conversion réussit, dynamic_cast< T > (ptr) convertit ptr au type souhaité. Si un transtypage de pointeur échoue, le pointeur a pour valeur 0 lorsqu'il est renvoyé. Si un transtypage à un type référence échoue, l'exception Bad_cast est déclenchée.

{{Note| Les informations de type à l'exécution (RTTI) sont nécessaires pour '''dynamic_cast'''.}}

==Voir aussi==

* [[Const cast (opérateur de transtypage)|const_cast (opérateur de transtypage)]]
* [[Reinterpret cast (opérateur de transtypage)|reinterpret_cast (opérateur de transtypage)]]
* [[Static cast (opérateur de transtypage)|static_cast (opérateur de transtypage)]]
* [[Rtti et option -RT|Rtti et option -RT]]

==Exemples de code==

*[[Samp xe: ActivePage (C++)|Exemple de code ActivePage (C++)]]
*[[Samp xe: TStringBuilderClickCount (C++)|Exemple de code TStringBuilderClickCount (C++)]]
*[[Samp xe: BoundsRect (C++)|Exemple de code BoundsRect (C++)]]
*[[Samp xe: ComponentCount (C++)|Exemple de code ComponentCount (C++)]]

{{DEFAULTSORT:dynamic_cast (operateur de transtypage C++)}}
[[Category:Référence C++]]
[[Category:C++]]
[[Category:RTTI]]
[[Category:AMMigrate]]

[[en:Dynamic cast (C++ Type Cast Operator)]]
[[de:Dynamic cast (Typumwandlungsoperator)]]
[[ja:Dynamic cast（型変換演算子）]]

Utilisation du thread VCL principal

2021-03-18T04:40:29Z

Fabiola.Arias : Added the {{Note|}} template

{{Parent|Comment construire des applications multithreads}}
L'utilisation du thread VCL principal comprend les étapes de base suivantes :

# Créer une routine distincte pour gérer les messages Windows reçus par les composants de votre application.
# Appeler régulièrement CheckSynchronize.
# Déclarer, si nécessaire, des variables locales aux threads pour une utilisation exclusive par votre thread.

'''Pour créer une routine distincte'''

# Ecrivez une routine de thread principal qui gère l'accès aux propriétés des objets et l'exécution des méthodes de tous les objets de votre application.
# Appelez la routine en utilisant la méthode TThread.Synchronize ({{Delphi}}) ou TThread::Synchronize (C++). Le code suivant illustre un exemple de l'appel d'une méthode en utilisant Synchronize :

procedure TMyThread.PushTheButton
begin
Button1.Click;
end;
procedure TMyThread.Execute;
begin
...
Synchronize(PushThebutton);
...
end;

void TMyThread::PushTheButton()
{
Form1->Button1->Click();
}
void __fastcall TMyThread::Execute()
{
...
Synchronize( (TThreadMethod)&PushTheButton );
...
}

Synchronize attend le thread principal pour entrer dans la boucle des messages, puis exécute la méthode qui lui est transmise.

{{Note| Comme = </nowiki>"codeInline">Synchronize utilise une boucle de messages, elle ne fonctionne pas dans les applications console. Pour les applications console, utilisez d'autres mécanismes, comme les sections critiques, pour protéger l'accès aux objets VCL.}}

'''Pour appeler CheckSynchronize'''

# Appelez régulièrement CheckSynchronize depuis le thread principal pour que les threads d'arrière-plan synchronisent leur exécution avec le thread principal.
# Pour garantir la sécurité des appels aux threads d'arrière-plan, appelez CheckSynchronize lorsque l'application est inactive (par exemple, dans un gestionnaire d'événements OnIdle).

'''Pour utiliser une variable locale au thread'''

# Identifiez les variables que vous voulez rendre globales pour toutes les routines exécutées dans votre thread sans qu'elles ne soient partagées par les autres instances de la même classe de thread.
# Pour {{Delphi}}, déclarez ces variables dans une section '''threadvar''', par exemple :

threadvar
x: integer;

Pour C++, déclarez ces variables avec le modificateur '''__thread''' :

int __thread x;

{{Note| Utilisez la section '''threadvar''' uniquement pour des variables globales. Ne l'utilisez pas pour les variables Pointer et Function ou les types qui utilisent une sémantique de copie-sur-écriture, comme les chaînes longues.}}

{{Note| Pour C++, si vous initialisez une variable '''__thread''', vous devez l'initialiser par une expression constante. Par exemple, = </nowiki>"codeInline">int __thread foo <nowiki> = </nowiki> 3; est une instruction correcte, mais = </nowiki>"codeInline">int __thread foo <nowiki> = </nowiki> get_value(); est interdite car l'initialisation se produit à l'exécution.}}

== Voir aussi ==

* [[Présentation de la VCL]]
* [[Ecriture de la fonction Thread]]
* [[Eviter les accès de threads simultanés dans la même mémoire]]
* [[Attente des threads]]
* [[Gérer les exceptions]]

[[Category:Utilisation de Delphi pour Windows]]
[[Category:{{Delphi}}]]

[[en:Using the Main VCL Thread]]
[[de:Haupt-VCL-Thread benutzen]]
[[ja:メイン VCL スレッドを使用する]]

Exécution d'objets thread

2021-03-18T02:54:19Z

Fabiola.Arias : Added the {{Warning|}} template

{{Parent|Exécution d'objets thread - Index}}
Une fois une classe thread implémentée en définissant sa méthode ''Execute'', vous pouvez l'utiliser dans une application pour exécuter le code de sa méthode ''Execute''. Pour utiliser un thread, créez une instance de la classe thread. L'instance de thread peut être créée pour un démarrage immédiat ou placée en état d'attente afin de n'être exécutée qu'avec l'appel de la méthode [[lib_fr:System.Classes.TThread.Resume|Resume]]. Pour créer un thread s'exécutant immédiatement, affectez la valeur ''False'' au paramètre ''CreateSuspended'' du constructeur. Par exemple, la ligne suivante crée un thread et commence son exécution.

<source lang="delphi">

SecondThread := TMyThread.Create(false); {créer et exécuter le thread }

</source>

<source lang="cpp">

TMyThread *SecondThread = new TMyThread(false); // crée et exécute le thread

</source>

{{Warning| Ne créez pas trop de threads dans une application. Le surcoût lié à la gestion de plusieurs threads peut influer sur les performances. La limite recommandée est de 16 threads par processus sur une machine disposant d'un seul processeur. Cette limite suppose que la plupart de ces threads attendent des événements externes. Si tous les threads sont actifs, il convient de réduire encore ce nombre.}}

Vous pouvez créer plusieurs instances du même type de thread pour exécuter du code parallèle. Vous pouvez, par exemple, démarrer une nouvelle instance d'un thread en réponse à une action de l'utilisateur, ce qui permet à chaque thread de générer la réponse attendue.

Les rubriques suivantes décrivent l'utilisation des threads dans votre application :

* [[Redéfinition de la priorité par défaut|Redéfinition de la priorité par défaut]].
* [[Démarrage et arrêt des threads|Démarrage et arrêt des threads]]

==Voir aussi==

* [[Définition d'objets thread]]

{{DEFAULTSORT:Execution d'objets thread}}
[[Category:Guide du développeur Windows]]
[[Category:{{Delphi}}]]

[[en:Executing Thread Objects]]
[[de:Thread-Objekte ausführen]]
[[ja:スレッドオブジェクトの実行]]

Validation des modifications dans le contrôle de version Mercurial

2021-03-09T18:53:06Z

Fabiola.Arias : Added the {{Note|}} template

{{Parent|Intégration de Mercurial dans l'EDI}}

La validation des modifications d'un fichier ou d'un projet l'enregistre dans le référentiel local.

'''Pour valider un fichier spécifique'''

# Dans le [[Fenêtre Projets|Gestionnaire de projets]], cliquez avec le bouton droit sur le fichier à valider.
# Dans le menu contextuel, sélectionnez {{Menu|Mercurial > Valider}}. Le volet [[Valider (Mercurial)|Valider (Mercurial)]] apparaît dans la fenêtre principale de l'EDI.
# Entrez un commentaire pour le journal dans le champ '''Commentaire'''. Vous pouvez voir (ou sélectionner) des [[Commentaires récents|commentaires des versions préalablement validées]].
# Cliquez sur '''Valider'''. Le système de contrôle de version affiche les résultats dans la [[Vue Messages|vue Messages]].

'''Pour valider un répertoire ou un projet entier'''

# Dans le [[Fenêtre Projets|Gestionnaire de projets]], cliquez avec le bouton droit sur le dossier ou le projet à valider.
# Dans le menu contextuel, sélectionnez {{Menu|Mercurial > Valider}}.
# Sous la commande '''Valider''' du menu contextuel, sélectionnez l'une des sous-commandes suivantes :
#* '''Depuis la racine du référentiel''' recherche dans l'arborescence de répertoires le dernier répertoire géré par le même référentiel que le fichier projet, puis ajoute dans le volet de validation tous les fichiers de ce répertoire et ceux en dessous.
#* '''Depuis le répertoire du projet''' ajoute dans le volet de validation tous les fichiers du répertoire du projet, et ceux en-dessous.
# Le volet [[Valider (Mercurial)|Valider (Mercurial)]] apparaît dans la fenêtre principale de l'EDI. Sélectionnez les fichiers que vous voulez valider dans le champ '''Valider dans : Emplacement'''.
# Entrez un commentaire pour le journal dans le champ '''Commentaire'''. Vous pouvez voir les commentaires des versions préalablement validées.
# Cliquez sur '''Valider'''. Le système de contrôle de version affiche les résultats dans la [[Vue Messages|vue Messages]].

{{Note| Pour valider les modifications dans votre référentiel distant dans Mercurial, [[Valider (Mercurial)|envoyez vos modifications à un référentiel distant]].}}
{{Note| La boîte de dialogue Valider n'affiche pas les fichiers renommés. Vous devez cliquer sur '''Afficher les fichiers non versionnés''' et sélectionner les fichiers renommés afin qu'ils soient ajoutés à l'opération de validation.}}

==Voir aussi==

* [[Intégration de Mercurial dans l'EDI|Intégration de Mercurial dans l'EDI]]
* [[Valider (Mercurial)|Valider (Mercurial)]]
* [[Gestionnaire de l'historique|Gestionnaire de l'historique]]
* [[Ajout d'un fichier au contrôle de version|Ajout d'un fichier au contrôle de version]]

{{DEFAULTSORT:Validation des modifications dans le controle de version Mercurial}}
[[Category:Delphi]]
[[Category:C++]]
[[Category:XE8]]
[[Category:AMMigrate]]

[[en:Committing Changes to Mercurial Version Control]]
[[de:Übergeben von Änderungen an die Mercurial-Versionskontrolle]]
[[ja:変更を Mercurial バージョン管理にコミットする]]

Intégration de Mercurial dans l'EDI

2021-03-09T15:39:47Z

Fabiola.Arias : Added the {{Note|}} template

{{Parent|Systèmes de contrôle de version dans l'EDI}}
__TOC__

La fonctionnalité '''Version Insight''' intègre le support du système de contrôle de version '''Mercurial''' dans l'EDI.

Pour de plus amples informations sur Mercurial SCM, voir [http://mercurial.selenic.com/ http://mercurial.selenic.com/]

==Fonctionnalités de Mercurial dans l'EDI==

Pour tout fichier qui est géré par Mercurial dans l'EDI :

* Le '''[[Gestionnaire de l'historique|Gestionnaire de l'historique]]''' affiche les informations d'historique du fichier local et les informations d'historique de Mercurial. Par exemple, les commentaires Mercurial et l'historique sont disponibles sur l'onglet '''Informations''' du Gestionnaire de l'historique.
* Vous pouvez comparer ou '''[[Comparaison (diff) des versions d'un fichier|déterminer les différences entre]]''' les versions d'un fichier créées et gérées par un système Mercurial, même si le fichier n'a pas été créé ou sauvegardé par l'EDI.
* Vous pouvez exécuter des commandes Mercurial communes telles que :
** [[Valider (Mercurial)|Valider (Mercurial)]] (envoie vos modifications locales dans votre référentiel local).
** Afficher le journal (clic sur l'onglet '''Informations''' du '''Gestionnaire de l'historique''').
** [[Comparaison (diff) des versions d'un fichier|Diff]] (compare deux versions d'un fichier).

==[[Commandes Mercurial dans RAD Studio|Commandes Mercurial dans {{Product}}]]==

Si vous connaissez bien Mercurial, consultez ce '''[[Commandes Mercurial dans RAD Studio|tableau utile]]''' qui décrit comment effectuer les tâches Mercurial communes dans l'EDI de {{Product}}.

==Activation de Mercurial dans {{Product}}==

Le support de Mercurial n'est pas activé par défaut. Pour activer Mercurial dans l'EDI, utilisez les étapes suivantes :

# [http://mercurial.selenic.com/downloads Téléchargez et installez Mercurial] dans votre système.
# Dans l'EDI, accédez à {{Menu|Outils > Options > Contrôle de version > Mercurial}}.
# Insérez le chemin à l'exécutable Mercurial installé ('''hg.exe''') dans votre système. Par exemple, dans un système Windows l'exécutable Hg réside à l'adresse suivante :
#: {{Path|C:\Program Files\Mercurial\hg.exe}}
# Changez les autres paramètres à votre guise.
# Cliquez sur '''OK''' pour fermer l'expert.

Pour implémenter les fonctionnalités Mercurial, l'EDI n'ajoute rien à votre projet. A la place, l'EDI utilise simplement les informations Mercurial qui sont stockées dans votre référentiel local.

==Configuration de Mercurial==

Dès que vous avez installé Mercurial sur votre système, vous devez définir votre '''nom d'utilisateur''' et '''adresse e-mail'''. Mercurial utilise ces informations dans chaque validation.

Pour configurer votre nom d'utilisateur et adresse e-mail de votre référentiel Mercurial, vous devez modifier le fichier '''Mercurial.ini''' qui réside dans votre système ({{Path|C:\Users\<nom_utilisateur>\Mercurial.ini}}).

<ol><li> Ouvrez l'outil de ligne de commande.</li>
<li>Tapez la commande suivante :
:<code> hg config --edit</code>
</li>
<li> Ajoutez votre nom d'utilisateur et email, comme détaillé dans le fichier : 
<code> # username = Jane Doe <jdoe@example.com></code> 
<code> username = </code>
</li>
<li>Vérifiez vos nouveaux paramètres en tapant :
:<code> hg config </code>
</li>
</ol>

==Mettre à jour votre référentiel local==

Pour éviter un conflit entre versions, effectuez toujours une mise à jour sur vos fichiers locaux avant de commencer à faire des modifications :

# Ouvrez l'outil de ligne de commande.
# Naviguez jusqu'au dossier local de votre référentiel Mercurial.
# Tapez la commande suivante :
#:<code>hg pull</code>
# Effectuez une authentification dans le référentiel distant, si nécessaire.
# Mettez à jour le référentiel local (la commande <code>pull</code> ne le met pas à jour automatiquement) :
#:<code>hg update</code>

{{Note| Si vous utilisez la dernière révision des fichiers sous le contrôle de version, vous obtiendrez le message suivant : '''Aucune modification trouvée'''.}}

==Résolution des problèmes Mercurial==

===Impossible de récupérer le contenu de votre référentiel distant===

Si votre référentiel Mercurial distant (référentiel privé) nécessite une authentification, vous devez cloner les données depuis la ligne de commande. Voir [[Clonage d'une copie d'un référentiel Mercurial|Clonage d'une copie d'un référentiel qui nécessite une authentification]].

==Rubriques==

'''Commandes équivalentes'''

* [[Commandes Mercurial dans RAD Studio|Commandes Mercurial dans {{Product}}]]

'''Actions liées au référentiel'''

* [[Clonage d'une copie d'un référentiel Mercurial|Clonage d'une copie d'un référentiel Mercurial]]
* [[Ajout d'un fichier au contrôle de version|Ajout d'un fichier au contrôle de version]]
* [[Validation des modifications dans le contrôle de version Mercurial|Validation des modifications dans le contrôle de version Mercurial]]

'''Actions liées au journal et à l'historique'''

* [[Visualisation de l'historique et des révisions|Visualisation de l'historique et des révisions]]
* [[Visualisation des commentaires du contrôle de version|Visualisation des commentaires du contrôle de version]]
* [[Affichage du journal de Subversion|Affichage du journal du contrôle de version]]
* [[Utilisation de la fonctionnalité d'annotation|Utilisation de la fonctionnalité d'annotation]]

'''Actions liées à l'affichage des différences'''

* [[Comparaison (diff) des versions d'un fichier|Comparaison (diff) des versions d'un fichier]]
* [[Ajout d'une nouvelle visionneuse de différences|Ajout d'une nouvelle visionneuse de différences]]
* [[Installation d'une autre visionneuse de différences|Installation d'une autre visionneuse de différences]]
* [[Utilisation d'une visionneuse de différences externe|Utilisation d'une visionneuse de différences externe]]

'''Annulation des modifications'''

* [[Annulation des modifications (contrôle de version)|Annulation des modifications]]

===Boîtes de dialogue et volets===

* [[Cloner (Mercurial)|Cloner (Mercurial)]]
* [[Valider (Mercurial)|Valider (Mercurial)]]
* [[Volet Journal|Volet Journal]]

==Voir aussi==

* [[Gestionnaire de l'historique|Gestionnaire de l'historique]]
* [[Valider (Mercurial)|Valider (Mercurial)]]
* [[Cloner (Mercurial)|Cloner (Mercurial)]]
* [[Volet Journal|Volet Journal]]
* [[Sélectionner un programme|Sélectionner un programme]]
* [[Sélectionner un projet ou un groupe de projets à ouvrir|Sélectionner un projet ou un groupe de projets à ouvrir]]

{{DEFAULTSORT:Integration de Mercurial dans l'EDI}}
[[Category:Delphi]]
[[Category:C++]]
[[Category:AMMigrate]]
[[Category:XE8]]

[[en:Mercurial Integration in the IDE]]
[[de:Mercurial-Integration in der IDE]]
[[ja:IDE 内の Mercurial インテグレーション]]

Utilisation du Gestionnaire de l'historique

2021-03-09T15:29:49Z

Fabiola.Arias : Added the {{Tip|}} and the {{Note|}} templates

{{Parent|Comment modifier le code dans l'éditeur de code}}

Le '''Gestionnaire de l'historique''' vous permet de voir et de comparer les versions d'un fichier, notamment plusieurs versions de sauvegarde, les modifications locales enregistrées et le tampon d'édition des modifications non enregistrées.

{{Note| Pour de plus amples informations sur l'utilisation d'un [[Systèmes de contrôle de version dans l'EDI|système de contrôle de version]] dans le '''Gestionnaire de l'historique''', voir :

* Pour '''Subversion''' : [[Intégration de Subversion dans l'EDI|Intégration de Subversion dans l'EDI]].
* Pour '''Git''' : [[Intégration de Git dans l'EDI|Intégration de Git dans l'EDI]].
* Pour '''Mercurial''' : [[Intégration de Mercurial dans l'EDI|Intégration de Mercurial dans l'EDI]].}}

Dans un souci de simplicité, cette rubrique a été écrite sous la forme d'un tutoriel qui utilise un petit fichier texte pour introduire la fonctionnalité du '''Gestionnaire de l'historique'''. Toutefois, le '''Gestionnaire de l'historique''' est disponible pour la plupart des fichiers, notamment les fichiers HTML, XML et de code source.

'''Etape 1 du tutoriel : Pour créer et afficher les versions d'un fichier sur la page Contenu'''

# Choisissez la page {{Menu|Outils > Options > Options de l'éditeur}} et vérifiez que l'option '''Créer des fichiers de sauvegarde''' est cochée.
# Choisissez {{Menu|Fichier > Nouveau > Autre > Autres fichiers > Fichier texte}} et cliquez sur '''OK''' pour afficher un fichier texte vide dans '''l'éditeur de code'''.
# Sur la première ligne du fichier, tapez Première ligne de texte et enregistrez le fichier avec le nom et à l'emplacement de votre choix.
# Sur la deuxième ligne, tapez Deuxième ligne de texte et enregistrez le fichier.
# Sur la troisième ligne, tapez Troisième ligne de texte et enregistrez le fichier. Il existe maintenant trois versions du fichier stockées dans un répertoire caché appelé __history à l'intérieur du répertoire en cours.
# Cliquez sur l'onglet '''Historique''', situé à côté de l'onglet '''Code'''. La liste des révisions en haut de l'onglet '''Contenu''' affiche les trois versions du fichier. La première version est appelée ~1~, la deuxième ~2~ et la version en cours Fichier. Le visualiseur de source en bas de l'onglet affiche le source de la version sélectionnée.
# Sélectionnez les différentes versions pour afficher leur source dans le visualiseur de source.
# Cliquez sur l'onglet '''Code''' pour revenir à '''l'éditeur de code''' et, sur la quatrième ligne du fichier, tapez Quatrième ligne de texte mais n'enregistrez '''pas''' le fichier. Vos modifications sont stockées dans la mémoire tampon de l'éditeur, mais ne sont pas enregistrées dans le fichier.
# Lisez les descriptions des barres d'outils et icônes suivantes, puis utilisez la procédure qui suit pour comparer les versions du fichier que vous venez de créer.

{{Tip| Pour trier une colonne sur une page du '''Gestionnaire de l'historique''', cliquez sur l'en-tête de la colonne.}}

'''Etape 2 du tutoriel : Pour comparer des versions d'un fichier en utilisant la page Diff'''

# En utilisant le fichier que vous avez créé dans la procédure précédente, cliquez sur l'onglet '''Historique'''.
# Cliquez sur l'onglet '''Différences''' en bas du '''Gestionnaire de l'historique'''. Les volets '''Différences entre''' et '''Et''' en haut de la page présentent les versions du fichier que vous pouvez comparer. En bas de la page, les lignes de source qui ont été supprimées sont en surbrillance et marquées avec un signe moins (-). Les lignes qui ont été ajoutées sont en surbrillance et marquées avec un signe plus (+). Les couleurs de la surbrillance dépendent des couleurs de '''l'éditeur de code'''.
# Sélectionnez les différentes versions du fichier dans les volets '''Différences entre''' et '''Et''' pour voir les résultats dans le visualiseur de source.

'''Etape 3 du tutoriel : Pour faire d'une version précédente du fichier la version en cours'''

# En utilisant le fichier résultant des procédures précédentes, cliquez sur l'onglet '''Contenu'''.
# Cliquez avec le bouton droit sur la version ~2~ du fichier et sélectionnez Rétablir, ou cliquez sur le bouton [[Image:HistViewRevert.jpg|Rétablir]] de la barre d'outils. La boîte de dialogue de '''confirmation''' indique que le rétablissement du fichier entraînera la perte des modifications non enregistrées du tampon.
# Cliquez sur '''Oui''' dans la boîte de dialogue de '''confirmation'''. La version ~2~ devient la version en cours.
# Revenez à '''l'éditeur de code''' et enregistrez la modification.

{{Tip| La commande Rétablir est aussi disponible sur la page '''Info'''.}}

==Voir aussi==

*[[Présentation de l'EDI|Présentation de l'EDI]]
*[[Gestionnaire de l'historique|Gestionnaire de l'historique]]
*[[Intégration de Subversion dans l'EDI|Intégration de Subversion dans l'EDI]]
*[[Intégration de Git dans l'EDI|Intégration de Git dans l'EDI]]
*[[Intégration de Mercurial dans l'EDI|Intégration de Mercurial dans l'EDI]]

[[Category:Utilisation de RAD Studio]]
[[Category:AMMigrate]]

[[en:Using the History Manager]]
[[de:Mit der Versionsverwaltung arbeiten]]
[[ja:履歴マネージャを使用する]]

Tutoriel mobile : Définition de votre environnement de développement sur le Mac (iOS)

2021-03-09T14:16:12Z

Fabiola.Arias : Added the {{Note|}} template

{{Parent|Tutoriels mobiles : Développement d'applications mobiles (iOS et Android)}}
{{DISPLAYTITLE:Tutoriel mobile : Définition de votre environnement de développement sur le Mac (iOS)}}
__TOC__

Une application {{Delphi}} {{FM}} destinée à la plate-forme cible iOS peut être facultativement testée sur le '''simulateur iOS''' disponible sur le Mac. Les applications C++ et {{Delphi}} {{FM}} peuvent être testées en utilisant la plate-forme cible '''Périphérique iOS''' ; pour ce test, un périphérique iOS test doit être connecté au Mac.

* La première moitié de ce tutoriel décrit les étapes à effectuer afin d'exécuter votre application iOS ({{Delphi}} seulement) sur le '''simulateur iOS''' sur le Mac.
* La deuxième moitié de ce tutoriel décrit les étapes supplémentaires requises afin d'exécuter votre application iOS ({{Delphi}} ou C++) sur '''votre périphérique iOS'''.

{{Note| Le '''simulateur iOS''' n'est pas pris en charge par [[BCCIOSARM.EXE, le compilateur C++ pour le périphérique iOS 32 bits|BCCIOSARM, le compilateur C++ pour le périphérique iOS]]. Seuls les périphériques iOS sont pris en charge par BCCIOSARM.}}

==Exigences relatives au Mac et iOS==

* 10.9 Mavericks
* 10.10 Yosemite
* 10.11 El Capitan
*:Aucun système d'exploitation n'est pris en charge sur les anciens systèmes Macintosh PowerPC- et 680x0. Tous les Mac depuis 2007 sont basés sur Intel ; tous les Mac depuis 2008 sont 64 bits.
* Pour le développement OS X, la dernière version de [[Installation de Xcode sur un Mac|Xcode]]
* Pour le développement iOS, la dernière version du SDK iOS et de '''[[Installation de Xcode sur un Mac|Xcode]]''' installée, ainsi que '''[[Installation des outils de ligne de commande Xcode sur un Mac|les outils de ligne de commande Xcode]]'''.
{{Note| {{Product}} ne prend pas en charge les versions de SDK iOS antérieures à la version 8.0.}}
* [[Rejoindre le programme Développeur Apple|Appartenance au programme Développeur Apple]].
* Un périphérique iOS connecté au Mac par le port USB (requis pour tester ou exécuter votre application iOS sur le périphérique)

==Etapes de configuration de votre Mac afin d'exécuter votre application iOS==

Pour déployer une application iOS sur votre périphérique à des fins de débogage et de tests, votre système doit avoir la configuration présentée à la figure suivante. {{Product}} s'exécute sur un PC sous Windows. Ce PC est connecté à un Mac exécutant '''[[PAServer, l'application serveur Platform Assistant|Platform Assistant]]''' et équipé des versions appropriées de '''[[Installation de Xcode sur un Mac|Xcode]]''' et du SDK iOS (pour le développement iOS). Pour exécuter les apps iOS sur un périphérique iOS, ce dernier doit être connecté au Mac via un câble USB.

[[File:Win2Mac2.png|650px]]

Pour déployer une application iOS vers le '''simulateur iOS''' sur le Mac ou vers un périphérique iOS, vous devez installer les outils suivants sur votre Mac :

*'''[[PAServer, l'application serveur Platform Assistant|Platform Assistant (PAServer)]]'''
** {{Product}} utilise '''[[PAServer, l'application serveur Platform Assistant|Platform Assistant]]''' pour [[Débogage des applications multi-périphériques|exécuter et déboguer les applications multi-périphériques]] et pour [[Déploiement des applications multi-périphériques|déployer les applications multi-périphériques]] sur les périphériques OS X et iOS.
** [[Installation de Platform Assistant sur un Mac|Installez]] et [[Exécution de Platform Assistant sur un Mac|exécutez]] Platform Assistant sur votre Mac.
*'''[http://developer.apple.com/xcode/ Xcode]'''
*: Xcode est l'environnement de développement et de débogage sur le Mac, qui fournit les fichiers de développement requis pour les applications OS X et iOS.

===Etape 1 : Installer Platform Assistant===

[[PAServer, l'application serveur Platform Assistant|Platform Assistant]] doit s'exécuter sur le Mac quand vous déployez une app iOS de votre PC vers le simulateur iOS ou un périphérique iOS.

L'installateur OS X pour Platform Assistant se nomme {{Path|{{PAServerOSXInstallerFile}}}} et est disponible à deux emplacements :

* Dans le répertoire d'installation de {{Product}} sur votre PC :
*: {{Path|{{PAServerOSXInstallerPath}}}}
* Sur le Web où vous pouvez le télécharger sur le Mac :
*: {{Path|{{PAServerOSXInstallerUrl}}}}

: [[File:Installing PAServer1.png|400px|Installing PAServer]]

Pour plus de détails, voir '''[[Installation de Platform Assistant sur un Mac|Installation de Platform Assistant sur un Mac]]'''.

===Etape 2 : Exécuter Platform Assistant===

Sur le Mac, dans le Finder, activez le fichier .app ({{Path|{{PAServerOSXAppFile}}}}) de la manière suivante :

# Naviguez jusqu'au dossier de niveau supérieur '''Applications'''.
# Double-cliquez sur {{Path|{{PAServerOSXAppFile}}}} pour démarrer Platform Assistant :
#:[[Image:SelectNewRADPAServer.png]] 
#:La fenêtre Terminal apparaît, affichant la bannière Platform Assistant et l'invite de mot de passe : 
#::<code>Mot de passe du profil de connexion <appuyez sur Entrée si aucun mot de passe></code> 
#: Appuyez sur la touche '''Retour''' ou entrez un mot de passe pour PAServer, puis appuyez sur Retour. 
# Vous êtes maintenant invité à entrer votre mot de passe d'utilisateur Mac pour permettre à Platform Assistant de déboguer (prendre le contrôle d'un autre processus) votre application. 
#:
#:: [[File:TakeControl.png]] 
#::Entrez votre mot de passe et sélectionnez '''Take Control''' : 
#::[[Image:PAServerXE7.png||Message d'identification PAServer]] 

Pour plus de détails sur l'exécution de Platform Assistant, voir [[Exécution de Platform Assistant sur un Mac|Exécution de Platform Assistant sur un Mac]].

===Etape 3 : Installer Xcode sur le Mac===

'''[http://developer.apple.com/xcode/ Xcode]''' est l'environnement de développement et de débogage sur le Mac, qui fournit les fichiers de développement requis pour les applications [[Développement d'applications OS X|OS X]] et [[Développement d'applications mobiles iOS|iOS]].

Vous pouvez installer Xcode depuis l'une des sources suivantes :

* Sur votre DVD "OS X Install", sous '''Optional Installs''', double-cliquez sur '''Xcode.mpkg''' pour installer Xcode sur votre système.
* Au niveau de [http://www.apple.com/mac/app-store/ l'App Store Mac], téléchargez Xcode gratuitement.
* En tant que développeur Apple enregistré, vous pouvez télécharger la dernière version de Xcode sous forme de bundle (<code>.dmg</code>). Pour s'enregistrer puis télécharger Xcode :
*# Enregistrez-vous (gratuitement) en tant que développeur Apple sur [http://developer.apple.com/programs/register/ http://developer.apple.com/programs/register/].
*# Téléchargez Xcode sous forme de bundle à l'adresse [https://developer.apple.com/downloads https://developer.apple.com/downloads].

===Etapes suivantes===

Vous avez configuré votre Mac pour exécuter une application iOS sur le '''simulateur iOS'''.

{{Note| Seules les applications {{Delphi}} peuvent être exécutées sur le '''simulateur iOS'''. {{CBuilder}} ne prend pas en charge le simulateur iOS.}}

* '''Simulateur iOS :''' Pour exécuter une application iOS ({{Delphi}} uniquement) sur le '''simulateur iOS''' sur le Mac, vous n'avez pas besoin de mener à bien la deuxième partie de ce tutoriel. Vous pouvez passer directement au tutoriel suivant ('''[[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)]]''' pour achever la configuration de l'EDI de {{Product}}.

* '''Périphérique iOS :''' pour exécuter votre application iOS ({{Delphi}} ou {{C++Builder}}) sur votre '''périphérique iOS''', suivez les étapes de ce tutoriel pour achever la configuration de votre Mac. Passez ensuite au tutoriel suivant ('''[[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)]]''') pour achever la configuration de l'EDI de {{Product}}.

[[File:WhiteSpace50.png]] 

=Etapes supplémentaires permettant de configurer votre Mac afin d'exécuter votre application iOS sur votre périphérique iOS=

Les étapes supplémentaires suivantes vous permettent d'exécuter votre application iOS sur votre '''périphérique iOS'''.

[[File:Win2Mac2iOSDevice2.png|650px]]

: Rappelez-vous que votre périphérique iOS doit être connecté à votre Mac via un câble USB.

==Etape 1 : Vérifier que les outils de ligne de commande Xcode sont installés sur votre Mac==

{{Note| A partir de la version 6.1 de Xcode, les outils de ligne de commande Xcode sont automatiquement installés pendant l'installation de Xcode.}}

'''Pour vérifier que les [[Installation des outils de ligne de commande Xcode sur un Mac|outils de ligne de commande Xcode sont installés sur votre Mac]] :'''

# Démarrez Xcode sur le Mac.
# Choisissez {{Menu|Preferences}} dans le menu {{Menu|Xcode}}.
#: [[File:XcodePreference.png]]
# Dans la fenêtre '''General''', cliquez sur l'onglet '''Locations'''.
# Dans la fenêtre '''Location''', vérifiez que le champ '''Command Line Tools''' indique la version de Xcode (avec laquelle les outils de ligne de commande ont été installés). Cela signifie que les outils de ligne de commande Xcode sont déjà installés et que vous n'avez pas besoin de le faire.
#: [[File:XcodeLocations.png]]
# Si les outils de ligne de commande Xcode ne sont pas installés, le champ '''Command Line Tools''' n'indique pas la version de Xcode.
## Dans ce cas, cliquez sur l'onglet '''Downloads''' dans la fenêtre '''Locations'''.
## Dans la fenêtre '''Downloads''', choisissez l'onglet '''Components'''.
##: [[File:InstallingiOSCommandLineTools.png|600px]]
## Cliquez sur le bouton '''Install''' auprès de '''Command Line Tools'''.
#:Vous êtes invité à fournir votre identifiant de connexion développeur Apple pendant le processus d'installation.

Pour plus de détails, voir [[Installation des outils de ligne de commande Xcode sur un Mac|Installation des outils de ligne de commande Xcode sur un Mac]].

==Etape 2 : S'inscrire à un compte développeur==

L'appartenance à l'un des programmes Développeur Apple est obligatoire pour construire, exécuter, déboguer et déployer des applications pour iOS.

Suivez les étapes décrites dans [[Rejoindre le programme Développeur Apple|Rejoindre le programme Développeur Apple]].

==Etape 3 : Demander, télécharger et installer votre certificat de développement==

Les applications qui sont déployées sur le périphérique (ou sur le simulateur iOS) doivent être signées cryptographiquement avant leur exécution. Le '''certificat de développement''' contient des informations nécessaires à la signature des applications. Chaque individu (un développeur individuel ou un membre d'équipe) doit avoir un certificat de développement unique, utilisable pour plusieurs applications.

Pour les équipes de développement, les certificats de développement doivent être demandés par chaque membre d'équipe, et ces demandes doivent être approuvées par un administrateur d'équipe.

===Demander, télécharger et installer votre certificat===

# Dans l'application '''Trousseaux d'accès''' de votre Mac, sélectionnez dans le menu '''Trousseaux d'accès''' : '''Assistant de certification > Demander un certificat à une autorité de certificat''' :
#: [[File:RequestCertificateDev.png|500px]] 
#* Si vous êtes un membre de l'équipe de développement d'un programme d'entreprise/d'organisation, l'administrateur de votre équipe doit approuver votre demande. Dès que l'administrateur de votre équipe l'a approuvé, vous pouvez télécharger le certificat.
#* Si vous êtes un développeur individuel, une option de téléchargement de votre certificat devrait apparaître rapidement dès sa demande. Pour de plus amples détails, voir la documentation Apple : [https://developer.apple.com/library/ios/documentation/Security/Conceptual/CodeSigningGuide/Introduction/Introduction.html Code Signing Guide (EN)].
#: Enregistrez la demande de certificat dans un fichier CSR, puis envoyez-le à votre autorité de certificat via le [https://developer.apple.com/ios/my/certificates/index.action Portail d'approvisionnement iOS] de la manière suivante :
## A l'invite, entrez votre identifiant et votre mot de passe Apple, puis cliquez sur '''Sign In'''.
## Sous '''iOS Apps''', cliquez sur '''Certificates'''.
## Sur la page qui s'ouvre, cliquez sur l'icône du signe plus (+). Cette action ouvre l'expert '''Add iOS Certificate'''.
## Sur la page '''Select Type''', cliquez sur '''Continue''' et suivez les instructions à l'écran pour poursuivre dans l'expert.
## A l'invite, téléchargez le fichier CSR que vous avez enregistré sur votre Mac.
# Accédez au [https://developer.apple.com/ios/my/certificates/index.action Portail d'approvisionnement iOS]. Vous pouvez télécharger le certificat de développement en cliquant sur le bouton '''Télécharger''' comme montré ci-dessous :
#: [[File:DownloadDevelopmentCertificate.png|500px]] 
# Lancez le certificat de développement en double-cliquant dessus. Il se charge automatiquement dans l'application '''Trousseaux d'accès'''.

==Etape 4 : Recenser le périphérique pour le déploiement==

Avant qu'un périphérique puisse exécuter des applications utilisateur, il doit être recensé dans le [https://developer.apple.com/ios/my/devices/index.action Portail d'approvisionnement Apple] (EN). Les périphériques sont recensés par leur identifiant de périphérique unique (UDID). Le UDID peut être déterminé par Xcode, comme suit :

# Assurez-vous que votre périphérique iOS est connecté à votre machine Mac.
# Ouvrez Xcode et allez à '''Devices''' ('''Window > Devices''').
# Cliquez sur votre périphérique.
# Une chaîne de caractères se trouve auprès du libellé '''Identifier''' :
#: [[File:DeviceUDID.png|540px]] 
#: La chaîne Identifier représente le UDID de votre périphérique.
#:* Si vous êtes un développeur individuel, recensez votre périphérique en ajoutant le UDID dans [https://developer.apple.com/ios/my/devices/index.action l'onglet Devices du Portail d'approvisionnement Apple].
#:* Si vous appartenez à une société/organisation, demandez à l'administrateur de votre équipe de recenser votre périphérique.

==Etape 5 : Créer et installer un profil d'approvisionnement==

Les profils d'approvisionnement sont utilisés pour lier un développeur et des périphériques à une équipe de développement. Ce profil d'approvisionnement est requis pour l'exécution d'applications sur un périphérique iOS.

* Si vous êtes un développeur individuel, vous devez créer un profil d'approvisionnement. Pour des informations spécifiques, voir : [https://developer.apple.com/library/ios/documentation/IDEs/Conceptual/AppStoreDistributionTutorial/Introduction/Introduction.html Creating and Downloading a Distribution Provisioning Profile (EN)].
* Si vous appartenez à une société/organisation, l'administrateur de votre équipe doit créer un profil d'approvisionnement que vous pourrez utiliser.

Dès que votre profil d'approvisionnement est créé, vous devez l'installer dans Xcode, comme suit :

# Ouvrez Xcode sur le Mac et accédez aux périphériques ('''Window > Devices''').
# Cliquez avec le bouton droit sur le périphérique et sélectionnez '''Show Provisioning Profiles…'''
#:[[File:ShowProvisioningProfiles.png|600px]] 
# Cliquez sur le '''bouton du signe plus''' pour ajouter un profil d'approvisionnement.
#:[[File:PlusButtonAddProvisioningProfiles.png|600px]] 
# Recherchez votre profil d'approvisionnement, sélectionnez-le et cliquez sur '''Install'''.
# Cliquez sur '''Done''' pour fermer la fenêtre.

Vous avez configuré votre Mac pour exécuter votre application iOS sur votre '''périphérique iOS'''.

Pour exécuter votre application iOS, voir [[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)]] et achevez la configuration de l'EDI de {{Product}}. (Si vous avez configuré votre PC pour l'exécution de votre application sur le '''simulateur iOS''', vous pouvez ignorer cette étape.)

==Voir aussi==

* [[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 : 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)]]
* [[PAServer, l'application serveur Platform Assistant|paserver, l'application serveur Platform Assistant]]
* [[Installation de Xcode sur un Mac|Installation de Xcode sur un Mac]]
* [[Installation des outils de ligne de commande Xcode sur un Mac|Installation des outils de ligne de commande Xcode sur un Mac]]
* [[Installation de Platform Assistant sur un Mac|Installation de Platform Assistant sur un Mac]]
* [[Exécution de Platform Assistant sur un Mac|Exécution de Platform Assistant sur un Mac]]
* [[Acquisition d'un certificat Développeur iOS|Acquisition d'un certificat Développeur iOS]]
* [[Dépannage : Impossible de déployer sur le périphérique iOS|Dépannage : Impossible de déployer sur le périphérique iOS]]
* Pages Web Apple utiles :
** [https://developer.apple.com/library/ios/documentation/IDEs/Conceptual/AppDistributionGuide/MaintainingProfiles/MaintainingProfiles.html Creating and Configuring App IDs (EN)]
** [https://developer.apple.com/library/ios/documentation/Security/Conceptual/CodeSigningGuide/Introduction/Introduction.html Creating signing certificates (Code Signing Guide) (EN)]
** [https://developer.apple.com/ios/my/certificates/index.action iOS Provisioning Portal (Requires your Apple Developer login) (EN)]
** [https://developer.apple.com/ios/my/devices/index.action Devices tab of the Apple Provisioning Portal (EN)]
** [https://appleid.apple.com/cgi-bin/WebObjects/MyAppleId.woa/wa/createAppleId Create an Apple ID (EN)]

** [https://developer.apple.com/library/ios/documentation/IDEs/Conceptual/AppDistributionGuide/MaintainingProfiles/MaintainingProfiles.html#//apple_ref/doc/uid/TP40012582-CH30-SW1 Creating and Downloading a Distribution Provisioning Profile (EN)]

{{DEFAULTSORT:Tutoriel mobile : Definition de votre environnement de developpement sur le Mac (iOS)}}
[[Category:XE4]]
[[Category:IOS]]
[[Category:OS X]]
[[Category:AMMigrate]]

[[en:Mobile Tutorial: Set Up Your Development Environment on the Mac (iOS)]]
[[de:Mobile-Tutorial: Konfigurieren der Entwicklungsumgebung auf dem Mac (iOS)]]
[[ja:モバイルチュートリアル：Mac に開発環境をセットアップする（iOS）]]

Pseudo-propriété ClassGroup de TDataModule

2021-02-26T15:44:37Z

Fabiola.Arias : Added the {{Note|}} template

{{Parent|Création et modification de modules de données standard}}
__TOC__

==Effets de la pseudo-propriété ClassGroup==

[[lib_fr:System.Classes.TDataModule|System.Classes.TDataModule]] et ses classes descendantes, telles que [[lib_fr:Web.HTTPApp.TWebModule|Web.HTTPApp.TWebModule]], ont une pseudo-propriété nommée '''ClassGroup''' qui effectue les tâches suivantes :

* Détermine l'affinité de framework pour le module de données. Ainsi, '''ClassGroup''' spécifie que le module de données est indépendant du framework ou doit travailler avec un framework spécifique (à savoir VCL ou FMX).
* Active les composants non visuels spécifiques au framework dans la '''[[Palette d'outils|Palette d'outils]]'''.
*: Vous devez [[Définition de l'affinité de framework pour un module de données|définir une valeur spécifique au framework pour '''ClassGroup''']] dans '''[[Inspecteur d'objets|l'inspecteur d'objets]]''' afin d'activer les composants non visuels spécifiques au framework tels que :
** '''[[lib_fr:Vcl.ActnList.TActionList|TActionList]]''' est VCL-seulement. Ainsi, pour activer '''TActionList''' dans la Palette d'outils, vous devez définir '''ClassGroup''' sur le paramètre VCL.
** '''TTimer''' existe à la fois dans FMX et VCL. Pour activer TTimer pour le framework correct, vous devez définir '''ClassGroup''' sur FMX ou VCL, afin de correspondre au framework de l'application parent.

:
:: ('''TTimer''' et '''TActionList''' sont traités plus loin dans cette rubrique.

Puisque la pseudo-propriété '''ClassGroup''' est utilisée seulement par l'EDI et n'est pas une propriété générée par le compilateur (d'où, 'pseudo-propriété'), '''ClassGroup''' n'est pas documentée dans la [[lib_fr:Accueil|Référence des bibliothèques]] générée par le compilateur. La page que vous lisez actuellement est la documentation relative à '''ClassGroup'''.

{{Note| Les deux frameworks, '''VCL''' et '''FMX''', ne sont pas mutuellement compatibles. Pour cette raison, la combinaison de VCL et FMX dans une application n'est pas supportée. Voir [[FireMonkey#La VCL est incompatible avec FireMonkey|Plate-forme d'applications FireMonkey]].}}

==Valeurs de ClassGroup==

Voici les valeurs de '''ClassGroup''' que vous pouvez choisir dans '''l'inspecteur d'objets''', notamment le framework et les éléments de la RTL qui peuvent être utilisés avec chaque choix spécifique au framework :

{| border="1" frame="hsides" rules="rows"
|-
! '''ClassGroup'''
! '''Framework associé '''
! '''Bibliothèque d'exécution '''
|- valign="top"
|
{{Code|System.Classes.TPersistent}}
|
Aucun (indépendant du framework)
|
RTL {{Delphi}}

(à l'exception des éléments spécifiques au framework non supportés)
|- valign="top"
|
{{Code|Vcl.Controls.TControl}}
|
Framework VCL
|
RTL {{Delphi}}

(à l'exception des éléments spécifiques au framework non supportés)
|- valign="top"
|
{{Code|FMX.Controls.TControl}}
|
Framework FMX
|
RTL {{Delphi}}

(à l'exception des éléments spécifiques au framework non supportés)
|}

==TDataModule est initialement indépendant du framework ; définissez l'affinité de framework avec ClassGroup==

Quand vous créez un module de données, le fichier d'unité contient initialement une directive qui définit la pseudo-propriété '''ClassGroup''' sur une valeur de base indépendante du framework ('''System.Classes.TPersistent'''), comme suit :

'''{{Delphi}} :'''
<source lang="delphi"> {%CLASSGROUP 'System.Classes.TPersistent'} </source>

'''C++ :'''
<source lang="cpp"> #pragma classgroup "System.Classes.TPersistent" </source>

{{Note| Cette directive est utilisée seulement par l'EDI et indique les relations du module de données avec un éventuel framework de composants particulier. L'EDI applique ensuite les types de composants que vous pouvez déposer sur le module de données. 
Quand vous changez la valeur '''ClassGroup''', la directive est automatiquement changée dans votre code.
}}

Puisque '''[[lib_fr:System.Classes.TDataModule|TDataModule]]''' est initialement indépendant du framework, vous pouvez utiliser un module de données avec la VCL ou le framework {{FM}}. Cela signifie aussi que les classes et les membres spécifiques au framework (comme '''[[lib_fr:Vcl.ActnList.TActionList|Vcl.ActnList.TActionList]]''' et '''[[lib_fr:FMX.Types.TTimer|FMX.Types.TTimer]]''') ne sont pas disponibles dans la '''Palette d'outils''' pour un module de données indépendant du framework. Vous pouvez inclure les classes et membres appropriés, spécifiques au framework, en accédant à '''l'inspecteur d'objets''' et en définissant la propriété '''ClassGroup''' de votre module de données pour indiquer votre framework correct, comme l'un des suivants :

* Vcl.Controls.TControl
* FMX.Controls.TControl (OS X)

===Exemples de composants non visuels spécifiques au framework===

* '''[[lib_fr:Vcl.ActnList.TActionList|TActionList]]''' est un composant non visuel VCL, et en tant que tel, il n'apparaît pas dans la '''Palette d'outils''' pour un module de données dont la pseudo-propriété '''ClassGroup''' est '''System.Classes.TPersistent''' (indépendant du framework) plutôt que '''Vcl.Controls.TControl''' (spécifique au framework). De même, TActionList n'est pas disponible si la propriété '''ClassGroup''' est définie sur '''FMX.Controls.TControl'''.

*'''TTimer''' a deux implémentations spécifiques au framework, comme suit
** [[lib_fr:FMX.Types.TTimer|FMX.Types.TTimer]]
** [[lib_fr:Vcl.ExtCtrls.TTimer|Vcl.ExtCtrls.TTimer]]
*: Dans les deux cas, '''TTimer''' est seulement disponible dans la '''Palette d'outils''' quand la propriété '''ClassGroup''' est définie sur une valeur spécifique au framework, au lieu d'une valeur '''System.Classes.TPersistent''' indépendante du framework. Mais puisque '''TTimer''' a une implémentation VCL et FMX, assurez-vous de sélectionner la valeur '''ClassGroup''' correcte pour votre module de données, afin de correspondre au framework de l'application, sinon des erreurs peuvent se produire.

* Exemples d'autres composants spécifiques au framework, affectés par la valeur de '''ClassGroup'''
** ''' TMainMenu :''' [[lib_fr:Vcl.Menus.TMainMenu|Vcl.Menus.TMainMenu]] et [[lib_fr:FMX.Menus.TMainMenu|FMX.Menus.TMainMenu]]
** '''TPopupMenu :''' [[lib_fr:Vcl.Menus.TPopupMenu|Vcl.Menus.TPopupMenu]] et [[lib_fr:FMX.Menus.TPopupMenu|FMX.Menus.TPopupMenu]]
** '''TOpenDialog :''' [[lib_fr:Vcl.Dialogs.TOpenDialog|Vcl.Dialogs.TOpenDialog]] et [[lib_fr:FMX.Dialogs.TOpenDialog|FMX.Dialogs.TOpenDialog]]

Après avoir sélectionné le Classgroup voulu, vous pouvez activer l'onglet Edition puis revenir à l'onglet Conception afin d'actualiser la '''Palette d'outils''' afin de refléter votre choix de Classgroup.

==Dépannage des situations d'erreur==

Si vous créez un module de données à l'intérieur d'une application fiches VCL, et définissez une valeur FMX pour la propriété '''ClassGroup''', le message suivant est affiché quand vous essayez de déposer un composant FMX sur le module de données :

: Class <classname> is not applicable to this module.

Ce message survient quand la valeur '''ClassGroup''' du module de données ne correspond pas au framework de l'application.

Un message similaire apparaît si vous créez une application {{FM}}, ajoutez un module de données, sélectionnez la valeur ''Vcl.Controls.TControl'' de '''ClassGroup''' et essayez de déposer un TTimer sur le module de données, puisque le composant non visuel [[lib_fr:Vcl.ExtCtrls.TTimer|Vcl.ExtCtrls.TTimer]] n'est pas compatible avec le framework {{FM}}.

Le message suivant peut aussi être affiché par l'EDI :

: The following component(s) are not available in the specified class group.
: This is likely to cause compile or runtime errors.
:
: FMX.Types.TTimer

Si vous essayez de compiler un projet ayant une valeur de '''ClassGroup''' non compatible avec le framework de l'application, vous pourrez voir des erreurs de compilation pour les éléments qui ne sont pas supportés dans le framework en cours. Voici des exemples d'éventuelles erreurs :

* [[X1026 Fichier introuvable : '%s' (Delphi)|X1026 Fichier introuvable : '%s' (Delphi)]]
* [[E2109 Type non autorisé (C++)|E2109 Type non autorisé (C++)]]
* [[E2209 Impossible d'ouvrir le fichier include 'nomfichier' (C++)|E2209 Impossible d'ouvrir le fichier include 'nomfichier' (C++)]]
* [['symbole' externe non résolu, référencé depuis 'module'|'symbole' externe non résolu, référencé depuis 'module' (Lieur C++)]]

==Voir aussi==

* [[lib_fr:System.Classes.TDataModule Properties|Propriétés de System.Classes.TDataModule]]
* [[Utilisation des modules de données|Utilisation des modules de données]]
* [[Définition de l'affinité de framework pour un module de données|Définition de l'affinité de framework pour un module de données]]

{{DEFAULTSORT:Pseudo-propriete ClassGroup de TDataModule}}
[[Category:Guide du développeur Windows]]
[[Category:Delphi]]
[[Category:C++]]

[[en:ClassGroup pseudo-property of TDataModule]]
[[de:Pseudo-Eigenschaft ClassGroup von TDataModule]]
[[ja:TDataModule の ClassGroup 疑似プロパティ]]

Test et débogage de l'application

2021-02-04T04:00:43Z

Fabiola.Arias : Added the {{Note|}} template

{{Parent|Création de serveurs COM simples - Index}}

Lorsque vous avez créé une application serveur COM, vous souhaitez la tester avant de la déployer.

'''Pour tester et déboguer une application serveur COM,'''

# Si nécessaire, activez les informations de débogage en utilisant la page '''Compilateur''' de la boîte de dialogue '''Projet > Options'''. Activez aussi '''Débogage intégré''' dans la boîte de dialogue '''Outils > Options > Options du débogueur'''.
# Pour un serveur en processus, choisissez '''Exécuter > Paramètres''', entrez le nom du contrôleur Automation dans la zone '''Application hôte''', puis choisissez OK.
# Choisissez '''Exécuter > Exécuter'''.
# Définissez des points d'arrêts dans le serveur Automation.
# Utilisez le contrôleur Automation pour interagir avec le serveur Automation.

Le serveur Automation fait une pause quand les points d'arrêts sont rencontrés.

{{Note| Comme autre approche, si vous écrivez aussi le contrôleur Automation, vous pouvez déboguer dans un serveur en processus en activant la prise en charge inter-processus COM. Utilisez la page '''Débogueurs {{Company}}''' de la boîte de dialogue obtenue par = </nowiki>"#598527">'''Outils > Options > Options du débogueur''' pour activer le support inter-processus.}}

{{DEFAULTSORT:Test et debogage de l'application}}
[[Category:Guide du développeur Windows]]
[[Category:Delphi]]
[[Category:C++]]

[[en:Testing and Debugging the Application]]
[[de:Die Anwendung testen und Fehler entfernen]]
[[ja:アプリケーションのテストとデバッグ]]

Fourniture des paramètres pendant la conception

2021-02-04T03:31:29Z

Fabiola.Arias : Added the {{Note|}} template

{{Parent|Utilisation de paramètres dans les requêtes}}

Au cours de la conception, vous pouvez spécifier les valeurs des paramètres en utilisant l'éditeur de collection de paramètres. Pour afficher l'éditeur de collection de paramètres, cliquez sur le bouton points de suspension de la propriété ''Params'' ou ''Parameters'' dans '''l'inspecteur d'objets'''. Si l'instruction SQL ne contient aucun paramètre, aucun objet n'apparaît dans l'éditeur de collection.

{{Note| L'éditeur de collection de paramètres est le même éditeur de collection que celui qui apparaît pour d'autres propriétés de collection. Comme cet éditeur est partagé par d'autre propriétés, son menu contextuel (clic droit) contient les commandes Ajouter et Supprimer. Cependant, elles ne sont jamais activées pour les paramètres des requêtes. Le seul endroit où l'on peut ajouter ou supprimer des paramètres est dans l'instruction SQL elle-même.}}

Sélectionnez chaque paramètre dans l'éditeur de collection de paramètres. Utilisez ensuite '''l'inspecteur d'objets''' pour modifier ses propriétés.

Quand vous utilisez la propriété ''Params'' (objets ''TParam''), vous pouvez inspecter ou modifier ce qui suit,

La propriété [[lib_fr:Data.DB.TParam.DataType|DataType]] liste le type de données de la valeur du paramètre. Pour certains ensembles de données, cette valeur peut être correctement initialisée. Si l'ensemble de données ne peut pas déduire le type, ''DataType'' vaut ''ftUnknown'', et vous devez la modifier et indiquer le type de la valeur du paramètre.

La propriété ''DataType'' indique le type de données logique du paramètre. En général, ces types de données sont conformes aux types de données du serveur. Pour avoir la correspondance entre les types logiques et les types de données du serveur, consultez la documentation du mécanisme d'accès aux données ((BDE, dbExpress, InterBase).

La propriété [[lib_fr:Data.DB.TParam.ParamType|ParamType]] liste le type du paramètre sélectionné. Pour les requêtes, elle est toujours initialisée à ''ptInput'', car les requêtes ne peuvent contenir que des paramètres d'entrée. Si la valeur de ''ParamType'' est ''ptUnknown'', changez-la en ''ptInput''.

La propriété [[lib_fr:Data.DB.TParam.Value|Value]] spécifie la valeur du paramètre sélectionné. Vous pouvez laisser vide cette ''Value'' si votre application fournit les valeurs des paramètres au cours de l'exécution.

Quand vous utilisez la propriété ''Parameters'' (objets ''TParameter''), vous pouvez inspecter ou modifier ce qui suit :

La propriété [[lib_fr:Data.Win.ADODB.TParameter.DataType|DataType]] liste le type de données de la valeur du paramètre. Pour certains types de données, vous devez ajouter d'autres informations :

* La propriété [[lib_fr:Data.Win.ADODB.TParameter.NumericScale|NumericScale]] indique le nombre de décimales des paramètres numériques.
* La propriété [[lib_fr:Data.Win.ADODB.TParameter.Precision|Precision]] indique le nombre total de chiffres des paramètres numériques.
* La propriété [[lib_fr:Data.Win.ADODB.TParameter.Size|Size]] indique le nombre de caractères des paramètres chaîne.

La propriété [[lib_fr:Data.Win.ADODB.TParameter.Direction|Direction]] liste le type du paramètre sélectionné. Pour les requêtes, elle est toujours initialisée à ''pdInput'', car les requêtes ne peuvent contenir que des paramètres d'entrée.

La propriété [[lib_fr:Data.Win.ADODB.TParameter.Attributes|Attributes]] indique le type des valeurs que le paramètre acceptera. ''Attributes'' peut être défini par une combinaison de ''psSigned'', ''psNullable'' et ''psLong''.

La propriété [[lib_fr:Data.Win.ADODB.TParameter.Value|Value]] spécifie la valeur du paramètre sélectionné. Vous pouvez laisser vide cette ''Value'' si votre application fournit les valeurs des paramètres au cours de l'exécution.

==Voir aussi==

* [[Fourniture des paramètres pendant l'exécution]]
* [[Etablissement de relations maître-détail en utilisant des paramètres]]

{{DEFAULTSORT:Fourniture des parametres pendant la conception}}
[[Category:Guide du développeur Windows]]
[[Category:{{Delphi}}]]
[[Category:C++]]

[[en:Supplying Parameters at Design Time]]
[[de:Parameter zur Entwurfszeit setzen]]
[[ja:設計時でのパラメータ値の指定]]

Evaluer/Modifier

2021-02-04T03:10:15Z

Fabiola.Arias : Added the {{Note|}} template

{{Parent|Menu Exécuter}}
{{DISPLAYTITLE:Evaluer/Modifier}}
<ideTag id="hcDEvalModify"></ideTag>
<ideTag id="hcMRunEvalModify"></ideTag>
'''Exécuter > Evaluer/Modifier'''  <code>Ctrl+F7</code>

Evalue ou modifie la valeur d'une propriété ou d'une expression existante. Cela permet de tester une correction de code sans quitter le débogueur, modifier le code source et recompiler le programme. La boîte de dialogue '''Evaluer/Modifier''' affiche les boutons représentés dans la première colonne ci-dessous.

{| border="1" frame="hsides" rules="rows"
! '''Elément'''
! '''Description'''
|- valign="top"
|
[[Image:Evaluate.png]] 
Evaluer
|
Evalue l'expression de la zone d'édition '''Expression''' et affiche sa valeur dans la zone d'édition '''Résultat'''.

* Si vous effectuez le débogage d'une application C++ Windows 64 bits, vous devez faire précéder le nom de registre du signe dollar ($) afin d'évaluer le contenu d'un registre. Par exemple : <code>$rax</code>
* Sur les autres plates-formes, le signe $ n'est pas accepté dans les noms de registre.
* Pour plus d'informations sur les registres CPU, voir [[Expressions assembleur]].
|- valign="top"
|
[[Image:Modify.png]] 
Modifier
|
Modifie la valeur de l'expression de la zone d'édition '''Expression''' en utilisant la valeur de la zone d'édition '''Nouvelle valeur'''.
|- valign="top"
|
[[Image:Watch.png]] 
Suivi
|
Crée un point de suivi pour l'expression que vous avez sélectionnée.
|- valign="top"
|
[[Image:Inspect.png]] 
Inspecter
|
Ouvre un nouvel '''inspecteur de débogage''' pour l'élément de données que vous avez sélectionné. Cela est utile pour voir les détails des structures de données, des classes et des tableaux.
|- valign="top"
|
[[Image:VisualizersButtonLocVar.png]] 
Visualiseurs
|
Seulement affiché quand un visualiseur de type visionneuse externe est disponible pour le type de l'expression. Cliquez sur la flèche orientée vers le bas du bouton pour sélectionner un visualiseur parmi les visualiseurs disponibles. Une fenêtre distincte s'ouvre pour afficher les données du visualiseur.
|- valign="top"
|
[[Image:Help.png]] 
Aide
|
Affiche cette rubrique d'aide.
|- valign="top"
|
Expression
|
Entrez la variable, le champ, le tableau ou l'objet à évaluer ou à modifier. Par défaut, le mot au niveau du curseur dans '''l'éditeur de code''' est placé dans la zone d'édition '''Expression'''. Vous pouvez accepter cette expression, en saisir une autre ou la choisir dans la liste de l'historique des expressions précédemment évaluées. Pour évaluer un appel de fonction, entrez le nom de la fonction, les parenthèses et les arguments comme vous le feriez dans votre programme, mais en omettant le point-virgule de fin d'instruction (;).
|- valign="top"
|
Résultat
|
Affiche la valeur de l'élément spécifié dans la zone d'édition '''Expression''' après que vous ayez choisi '''Evaluer''' ou '''Modifier'''.
|- valign="top"
|
Nouvelle valeur
|
Affecte une nouvelle valeur à l'élément spécifié dans la zone d'édition '''Expression'''. Entrez une nouvelle valeur pour cet élément si vous le souhaitez.
|}

{{note| Vous pouvez évaluer n'importe quelle expression autorisée par le langage ou les variables statiques qui sont accessibles depuis la position du point d'exécution.}}

==Spécificateurs de format d'affichage==

Par défaut, le débogueur affiche le résultat dans le format correspondant au type de données de l'expression. Par exemple, les valeurs entières sont affichées au format décimal. Pour modifier ce format d'affichage, il faut saisir après l'expression une virgule (,) suivie d'un spécificateur de format.

Le tableau suivant décrit les spécificateurs de formats de la boîte de dialogue Evaluer/Modifier :

{| border="1" frame="hsides" rules="rows"
! '''Spécificateur'''
! '''Types affectés'''
! '''Description'''
|-
| align="left" valign="top" |
,C
| align="left" valign="top" |
Caractère, chaînes
| align="left" valign="top" |
Caractère.

Pour {{Delphi}}, affiche les caractères de code ASCII 0 à 31 en notation {{Delphi}} #nn.
|-
| align="left" valign="top" |
,S
| align="left" valign="top" |
Caractère, chaînes
| align="left" valign="top" |
Chaîne.

Pour {{Delphi}}, affiche les caractères de code ASCII 0 à 31 en notation {{Delphi}} #nn.
|-
| align="left" valign="top" |
,D
| align="left" valign="top" |
Entiers
| align="left" valign="top" |
Décimal. Affiche les valeurs entières au format décimal, y compris celles incluses dans des structures de données.
|-
| align="left" valign="top" |
,H ou ,X
| align="left" valign="top" |
Entiers
| align="left" valign="top" |
Hexadécimal. Affiche les valeurs entières, y compris celles incluses dans des structures de données, au format hexadécimal et préfixées par $.
|-
| align="left" valign="top" |
,Fn
| align="left" valign="top" |
Virgule flottante
| align="left" valign="top" |
Virgule flottante.

Supportés par {{Delphi}} uniquement. Affiche ''n'' chiffres significatifs, ''n'' étant compris entre 2 et 18. Par exemple, pour afficher les quatre premiers chiffres d'une valeur en virgule flottante, entrez ",F4". Si ''n'' n'est pas spécifié, la valeur par défaut est 11.
|-
| align="left" valign="top" |
,R
| align="left" valign="top" |
Enregistrement
| align="left" valign="top" |
Enreg./Struct.

Pour {{Delphi}}, affiche le nom des champs et la valeur correspondante de la manière suivante (X:1;Y:10;Z:5) au lieu de (1,10,5).
|}

==Voir aussi==
* [[Inspection et modification de la valeur d'éléments de données]]
* [[Modification d'expressions variables]]
[[Category: Référence {{Product}}]]
* [[Visualiseurs de débogage]]
* [[Expressions assembleur]]

[[Category:{{Delphi}}]]
[[Category:C++]]

[[en:Evaluate/Modify]]
[[de:Auswerten/Ändern]]
[[ja:［評価/変更］]]

Notification des exceptions du débogueur

2021-02-04T02:50:44Z

Fabiola.Arias : Added the {{Tip|}} and the {{Note|}} templates

{{Parent|Menu Exécuter}}
Cette boîte de dialogue apparaît lorsque le programme que vous déboguez déclenche une exception de langage ou une exception de système d'exploitation et que vous avez défini des options demandant au débogueur de gérer les exceptions sur les pages '''Exceptions du langage''' et '''Exceptions natives du SE''' dans '''Outils > Options > Options du débogueur'''.

Le format du message est le suivant :

Le projet <nom_projet> a déclenché une exception de classe <yyyy> avec le message <texte_message>.

Si yyyy est un nom de classe, l'exception est une exception du langage. Si yyyy est une valeur hexadécimale, l'exception est une exception du système d'exploitation.

{| border="1" frame="hsides" rules="rows"
|-
! '''Elément'''
! '''Description'''
|- valign="top"
|
Ignorer ce type d'exception
|
Force le débogueur à ignorer ce type d'exception du langage ou du SE et définit la case à cocher correspondante dans la liste '''Types d'exceptions à ignorer''' de la page '''Outils > Options > Options du débogueur > Exceptions du langage'''.
|- valign="top"
|
Afficher la vue CPU
|
Cette option ne s'affiche que si l'emplacement de l'exception ne correspond pas à un emplacement source. Affiche la '''vue CPU''' si vous cliquez sur '''Arrêter''' pour interrompre l'exécution.
|- valign="top"
|
Arrêter
|
Interrompt l'exécution du programme là où l'exception s'est produite et place '''l'éditeur de code''' sur cette ligne de code.
|- valign="top"
|
Continuer
|
Poursuit l'exécution du programme.
|}

{{Tip| Tapez = </nowiki>"courier new,courier,monospace"> = </nowiki>"#999999">CTRL+C pour copier les messages dans le presse-papiers.}}

{{Note| Dans certains cas, l'état du programme vous empêchera de poursuivre l'exécution et vous verrez la boîte de dialogue '''Notification d'exceptions du débogueur''' se répéter indéfiniment. Dans ce cas, cliquez sur '''Arrêter''', puis choisissez = </nowiki>"#598527">'''Exécuter > Réinitialiser le programme''' pour arrêter l'exécution du programme en cours et l'effacer de la mémoire.}}

{{DEFAULTSORT:Notification des exceptions du debogueur}}
[[Category:Référence RAD Studio]]
[[Category:AMMigrate]]

[[en:Debugger Exception Notification]]
[[de:Benachrichtigung über Debugger-Exception]]
[[ja:デバッガ例外通知]]

Charger un processus Local

2021-02-03T02:48:08Z

Fabiola.Arias : Added the {{Note|}} template

{{Parent|Menu exécuter|Menu exécuter}}
<ideTag id="hcDDebuggerLoadLocalPage"></ideTag>
 '''Exécuter > Charger un processus > Local''' 

Passe les paramètres de la ligne de commande à votre application, spécifie un exécutable hôte pour tester une DLL ou charge un exécutable dans un débogueur sélectionné.

{| border="1" frame="hsides" rules="rows"
|-
! '''Elément'''
! '''Description'''
|- valign="top"
|
Débogueur
|
Sélectionnez le débogueur que vous voulez utiliser :
* '''Débogueur Embarcadero Win32''' est le débogueur incorporé par défaut pour les applications Windows 32 bits.
* '''Débogueur Embarcadero Win64''' a été conçu spécifiquement pour le débogage des applications qui ciblent Windows 64 bits
*'''{{Company}} OS X Debugger''' a été conçu spécifiquement pour le débogage des applications qui ciblent un Mac exécutant OS X ou un simulateur iOS.
{{Note| [[Charger un processus Local|Charger un processus Local]] n'est pas supporté pour le '''débogueur {{Company}} OS X'''.}}
*'''Débogueur Embarcadero Périphérique iOS32''' a été conçu spécifiquement pour le débogage des applications qui ciblent les périphériques iOS 32 bits et 64 bits.
{{Note|[[Charger un processus Local|Charger un processus Local]] n'est pas supporté pour le '''débogueur Embarcadero Périphérique iOS32'''.}}
*'''Débogueur Embarcadero Périphérique iOS64''' a été conçu spécifiquement pour le débogage des applications qui ciblent les périphériques iOS 64 bits.
{{Note| [[Charger un processus Local|Charger un processus Local]] n'est pas supporté pour le '''débogueur Embarcadero Périphérique iOS64'''.}}
* '''Débogueur Embarcadero Android''' a été conçu spécifiquement pour le débogage des applications qui ciblent un périphérique Android
|- valign="top"
|
Processus
|
Entrez le nom du chemin complet incluant le nom du fichier exécutable (<code>.EXE</code>) que vous voulez exécuter dans le débogueur. Cliquez ensuite sur '''Charger''' pour charger l'exécutable. L'exécutable est interrompu à son point d'entrée. S'il n'y a pas d'informations de débogage au point d'entrée, la fenêtre '''CPU''' est ouverte. Sélectionnez '''Exécuter > Exécuter''' pour lancer l'exécutable. Cliquez sur '''Parcourir''' pour rechercher un répertoire et un exécutable.
|- valign="top"
|
Paramètres
|
Entrez les arguments de la ligne de commande que vous voulez passer à votre application quand elle démarre.
|- valign="top"
|
Répertoire de travail
|
Entrez le nom du répertoire à utiliser pour le processus de débogage. Par défaut, c'est le même répertoire que celui contenant l'exécutable de votre application.
|- valign="top"
|
Chemin source
|
Spécifie le chemin des fichiers source utilisés pour construire l'exécutable.
|- valign="top"
|
Après le chargement
|
Spécifie le code (le cas échéant) qui doit être exécuté après le chargement du processus. Choisissez l'une des options suivantes :
{| border="1" frame="hsides" rules="rows"
|-
|
'''Ne pas exécuter'''
|
Equivalent au démarrage d'une session de débogage avec '''Exécuter > [[Pas à pas approfondi|Pas à pas approfondi]]''' (F7)
|
Charge l'exécutable mais ne l'exécute pas.
|- valign="top"
|
'''Exécuter jusqu'au point d'entrée du programme'''
|
Equivalent au démarrage d'une session de débogage avec '''Exécuter > [[Pas à pas|Pas à pas]]''' (F8)
|
Pour C++ seulement ; exécute jusqu'au premier point d'entrée, tel que main().
|- valign="top"
|
'''Exécuter jusqu'au premier source'''
|
Equivalent au démarrage d'une session de débogage avec '''Exécuter > [[Pas à pas jusqu'à la prochaine ligne|Pas à pas jusqu'à la prochaine ligne]]''' (MAj+F7)
|
Exécute jusqu'à la première ligne de source.
|- valign="top"
|
'''Exécuter'''
|
Equivalent au démarrage d'une session de débogage avec '''Exécuter > [[Exécuter|Exécuter]]''' (F9)
|
Exécute complètement le processus, sous le contrôle du débogueur.
|}
|}

==Voir aussi==

* [[Charger un processus|Charger un processus]]
* [[Charger un processus distant|Charger un processus distant]]
* [[Charger un processus Tables des symboles|Charger un processus Tables des symboles]]
* [[Charger un processus Bloc d'environnement|Charger un processus Bloc d'environnement]]
* [[Attacher au processus|Attacher au processus]]

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

[[en:Load Process Local]]
[[de:Prozess laden: Lokal]]
[[ja:［プロセスの読み込み｜ローカル］]]

Charger un processus

2021-02-03T01:50:42Z

Fabiola.Arias : Added the {{Tip|}} template

{{Parent|Menu Exécuter}}

'''Exécuter > Charger un processus'''

Ouvre la f de dialogue '''Charger un processus''', qui vous permet de charger un processus arbitraire dans un débogueur sélectionné, tel que le débogueur Win32, le débogueur Win64, le débogueur OS X, le débogueur périphérique iOS ou le débogueur Android.

Vous pouvez choisir parmi les opérations suivantes de chargement d'un processus :

*[[Charger un processus Local|Charger un processus Local]]
*[[Charger un processus distant|Charger un processus distant]]
*[[Charger un processus Tables des symboles|Charger un processus Tables des symboles]]
*[[Charger un processus Bloc d'environnement|Charger un processus Bloc d'environnement]]

{{Tip| Dans la boîte de dialogue '''Charger un processus''', vous pouvez appuyer sur <code>F1</code> dans n'importe quel élément de la liste pour afficher la page d'aide sur la rubrique sélectionnée.}}

==Voir aussi==

* [[Attacher au processus|Attacher au processus]]

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

[[en:Load Process]]
[[de:Prozess laden]]
[[ja:［プロセスの読み込み］]]

Charger un processus Bloc d'environnement

2021-02-03T01:41:29Z

Fabiola.Arias : Added the {{Note|}} template

{{Parent|Menu exécuter|Menu exécuter}}
<ideTag id="hcDDebuggerLoadEnvVarPage"></ideTag>
 '''Exécuter > Charger un processus > Bloc d'environnement''' 

Indique les variables d'environnement qui sont passées à votre application lors du débogage.

{| border="1" frame="hsides" rules="rows"
|-
! '''Elément'''
! '''Description'''
|- valign="top"
|
Débogueur
|
Sélectionnez le débogueur que vous voulez utiliser :
* '''Débogueur Embarcadero Win32''' est le débogueur incorporé par défaut pour les applications Windows 32 bits.
* '''Débogueur Embarcadero Win64''' a été conçu spécifiquement pour le débogage des applications qui ciblent Windows 64 bits.
* '''Débogueur {{Company}} OS X''' a été conçu spécifiquement pour le débogage des applications qui ciblent un Mac exécutant OS X ou le simulateur iOS.
* '''Débogueur Embarcadero Périphérique iOS32''' a été conçu spécifiquement pour le débogage des applications qui ciblent les périphériques iOS 32 bits et 64 bits.
*'''Débogueur Embarcadero Périphérique iOS64''' a été conçu spécifiquement pour le débogage des applications qui ciblent les périphériques iOS 64 bits.
{{Note| '''Charger un processus > Bloc d'environnement''' n'est pas supporté pour le '''débogueur Embarcadero Périphérique iOS'''.}}
*'''Débogueur Embarcadero Android''' a été conçu spécifiquement pour le débogage des applications multiplates-formes qui ciblent un périphérique Android ou un émulateur Android.
{{Note| '''Charger un processus > Bloc d'environnement''' n'est pas supporté pour le '''débogueur Embarcadero Périphérique iOS'''.}}
|- valign="top"
|
Variables système
|
Liste 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 redéfinir.
|- valign="top"
|
Redéfinir
|
Affiche la boîte de dialogue '''Redéfinir la variable système''', dans laquelle vous pouvez modifier une variable système existante afin de créer une nouvelle redéfinition utilisateur. Ce bouton est estompé 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 utilisateur définies et leurs valeurs. Une redéfinition utilisateur a priorité sur une variable système existante jusqu'à ce que vous supprimiez la redéfinition utilisateur.
|- valign="top"
|
Nouvelle
|
Affiche la boîte de dialogue '''Nouvelle variable utilisateur''', dans laquelle vous pouvez créer une nouvelle redéfinition utilisateur d'une variable système.
|- valign="top"
|
Modifier
|
Affiche la boîte de dialogue '''Modifier la 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 actuellement sélectionnée dans la liste '''Redéfinitions utilisateur'''.
|- valign="top"
|
Inclure les variables système
|
Passe les variables d'environnement du système à l'application que vous êtes en train de déboguer. Si cette option n'est pas cochée, seules les redéfinitions utilisateur sont passées à votre application.
|}

==Voir aussi==

* [[Charger un processus Local|Charger un processus Local]]
* [[Charger un processus distant|Charger un processus distant]]
* [[Charger un processus Tables des symboles|Charger un processus Tables des symboles]]

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

[[en:Load Process Environment Block]]
[[de:Prozess laden: Umgebungsblock]]
[[ja:［プロセスの読み込み｜環境ブロック］]]

Recenser/Dérecenser le serveur ActiveX

2021-02-03T01:32:04Z

Fabiola.Arias : Added the {{Warning|}} template

{{Parent|Menu Exécuter}}
<ideTag id="hcmRunRegisterActiveXServer"></ideTag>
'''Exécuter > Serveur ActiveX > Recenser '''

'''Exécuter > Serveur ActiveX > Recenser pour l'utilisateur en cours'''

'''Exécuter > Serveur ActiveX > Dérecenser'''

Ces commandes effectuent les tâches suivantes :
* '''Recensement''' du serveur ActiveX dans le registre Windows :
** '''Recenser''' recense un serveur ActiveX (en recensant dans HKEY_CLASSES_ROOT, pour tous les utilisateurs)
** '''Recenser pour l'utilisateur en cours''' recense un serveur ActiveX (en recensant dans HKEY_CURRENT_USER, pour une base par-utilisateur).

* '''Dérecensement''' d'un serveur ActiveX depuis le registre :
*: La commande '''Dérecenser''' effectue les deux actions suivantes :
** Dérecense de HKEY_CLASSES_ROOT (pour les objets recensés pour tous les utilisateurs)
** Dérecense de HKEY_CURRENT_USER (pour les objets recensés sur une base par-utilisateur)

{{Warning| Une entrée de registre est créée pour le serveur ActiveX chaque fois que vous entrez une commande '''Recenser''' ou '''Recenser pour l'utilisateur en cours'''. L'entrée de registre restera "orpheline" si vous abandonnez par la suite l'application et si vous échouez dans l'une des actions suivantes :

* Sauvegarder le serveur que vous avez recensé (sans le serveur, il est difficile de supprimer ultérieurement l'entrée de registre)
* Emettre une commande '''Dérecenser''' pour le serveur }}

==Voir aussi==
* [[Serveurs en processus, hors processus et distants]]
* [[Création d'une page Active Server - Index]]
* [[Recensement d'un objet Active Server]]
* [[Recensement d'un objet COM]]
* [[Recensement des serveurs ActiveX pour l'utilisateur en cours]]

{{DEFAULTSORT:Recenser/Derecenser le serveur ActiveX}}
[[Category:Référence {{Product}}]]

[[en:Register/Unregister ActiveX Server]]
[[de:ActiveX-Server registrieren/entfernen]]
[[ja:ActiveX サーバーの登録/登録解除]]

Recherche incrémentielle

2021-02-03T01:12:53Z

Fabiola.Arias : Added the {{Note|}} template

{{Parent|Menu Chercher}}
<ideTag id="hcMSearchIncrementalSearch"></ideTag>
{{menu | Chercher > Recherche incrémentielle}} <code>Ctrl+E</code>

Vous permet de rechercher du texte de façon interactive. Tapez votre chaîne de recherche immédiatement après l'invocation de la commande '''Recherche incrémentielle'''. Au fur et à mesure de la frappe, le premier résultat correspondant est mis en surbrillance dans l'éditeur, et toutes les autres instances correspondantes sont mises en surbrillance dans une seconde couleur.

{{Note| Le premier résultat correspondant est le premier résultat trouvé après la position du curseur.}}

La barre d'état située en bas de la fenêtre de l'éditeur affiche une zone de recherche avec le texte recherché :

[[image:IncrementalSearch2.jpg]]

Pour commencer une nouvelle recherche, appuyez sur <code>Retour arrière</code> pour effacer la barre d'état, ou sélectionnez de nouveau {{menu |Chercher > Recherche incrémentielle}}.

Pour activer la [[Chercher | barre d'outils de recherche]], cliquez sur la zone de texte de la barre d'outils '''Recherche incrémentielle'''.

Quand la barre d'outils de recherche est activée, vous pouvez lancer une recherche vers le haut ou depuis le début du fichier sans utiliser la souris pour cliquer sur les boutons Chercher vers le haut et Redémarrer depuis le début.

* <code>Entrée</code> lance une recherche vers le bas.
* <code>Maj+Entrée</code> lance une recherche vers le haut.
* <code>Ctrl+Entrée</code> lance une recherche depuis le début du fichier.

Pour chercher directement dans [[Editeur de code|l'éditeur de code]] :

# Une fois que vous avez saisi vos critères de recherche dans la barre d'outils et appuyé sur Entrée, la focalisation bascule vers l'éditeur de code.
# Toutes les correspondances apparaissent en surbrillance.
# Pour parcourir les correspondances de chaîne dans l'éditeur de code sans passer par la barre d'outils, utilisez les raccourcis suivants :
#* <code>F3 / Ctrl+L </code> pour rechercher vers le bas.
#* <code>Maj+F3</code> pour rechercher vers le haut.

{| border="1" frame="hsides" rules="rows"
! '''Elément'''
! '''Description'''
|- valign="top"
|
<zone de texte>
|
Affiche votre chaîne de recherche au fur et à mesure de la frappe. Vous pouvez aussi cliquer sur la flèche Bas associée [[File:DownArrowFind.png]] pour sélectionner une chaîne de recherche préalablement entrée.
|- valign="top"
|
[[File:SearchUp.png]] Flèche Haut
|
Recherche à partir de la position en cours jusqu'au début du fichier.
|- valign="top"
|
[[File:SearchDown.png]] Flèche Bas

|
Recherche à partir de la position en cours jusqu'à la fin du fichier. C'est la valeur par défaut.
|- valign="top"
|
[[File:RestartFromBeginning.png]] Redémarrer depuis le début
|
Démarre la recherche vers le bas à partir du début du fichier.
|}

==Voir aussi==
* [[Chercher]]

{{DEFAULTSORT:Recherche incrementielle}}
[[Category: Référence {{Product}}]]
[[Category:AMMigrate]]

[[en:Incremental Search]]
[[de:Inkrementelle Suche]]
[[ja:［インクリメンタルサーチ］]]

Propriétés du point de suivi

2021-02-03T00:09:15Z

Fabiola.Arias : Added the {{Tip|}} and the {{Note|}} templates

{{Parent|Menu Exécuter}}

'''Exécuter > Ajouter un point de suivi'''    <code>Ctrl+F5</code>

Ajoute un point de suivi ou modifie les propriétés d'un point de suivi existant. Le point de suivi apparaît dans la liste des points de suivi.

{{Note| Les spécificateurs de format listés dans la boîte de dialogue '''Propriétés du point de suivi''' dépendent des spécificateurs de format supportés par l'évaluateur en cours. Tous les spécificateurs de format cités ci-dessous ne seront pas disponibles pour chaque évaluateur. La plupart du temps, l'évaluateur est spécifié par la personnalité.}}

{| border="1" frame="hsides" rules="rows"
|-
! '''Elément'''
! '''Description'''
|- valign="top"
|
Expression
|
Spécifie l'expression à suivre. Entrez ou modifiez l'expression à suivre. La liste déroulante permet de choisir dans l'historique une expression préalablement entrée.
|- valign="top"
|
Nom du groupe
|
Spécifie le groupe auquel appartient le suivi sélectionné. Si vous spécifiez un nouveau groupe, ce nouveau groupe est ajouté et le suivi placé dans ce nouveau groupe. Utilisez la liste déroulante pour choisir un nom dans la liste des groupes de points de suivi existants.
|- valign="top"
|
Répétitions
|
Spécifie le nombre de répétitions, lorsque l'expression du point de suivi représente un élément de données, ou spécifie le nombre d'éléments du tableau, lorsque l'expression du point de suivi représente un tableau. Si vous surveillez un tableau sans spécifier un nombre d'éléments avec Répétitions, la fenêtre Liste des points de suivi affiche la valeur de tous les éléments du tableau.
|- valign="top"
|
Chiffres
|
Spécifie le nombre de chiffres significatifs pour une valeur d'une expression de suivi à virgule flottante. Entrez le nombre de chiffres. Cette option prend effet seulement quand vous sélectionnez '''Virgule flottante''' comme format d'affichage.
|- valign="top"
|
Activé
|
Active ou désactive le point de suivi. Désactiver un point de suivi cache celui-ci à l'exécution en cours. Un point de suivi désactivé reste défini, mais le débogueur ne l'évalue plus. Désactiver les points de suivi augmente les performances du débogueur puisqu'il n'a pas à les évaluer lorsque vous exécutez votre programme. Lorsque vous définissez un point de suivi, il est actif par défaut.
|- valign="top"
|
Autoriser les effets de bord et les appels de fonctions
|
Evalue le point de suivi même si cela entraîne des appels de fonctions. Cette option est désactivée par défaut pour tous les points de suivi. Lorsqu'elle est désactivée, les points de suivi qui provoqueraient des appels de fonctions ne sont pas évalués mais génèrent, à la place, le message "Valeur inaccessible". Voir aussi [[E2382 Les effets de bord ne sont pas autorisés (C++)|E2382 Les effets de bord ne sont pas autorisés (C++)]].
|- valign="top"
|
Caractère
|
Affiche des caractères spéciaux pour les codes ASCII de 0 à 31 (affichés #$0, #$1F, etc.). Ce type de format affecte les caractères et les chaînes.
|- valign="top"
|
Chaîne
|
Affiche des caractères pour les codes ASCII de 0 à 31 en utilisant la notation Pascal #nn (#$0, etc.). Ce type de format affecte les caractères et les chaînes.
|- valign="top"
|
Décimal
|
Affiche les valeurs entières en décimal, y compris celles des structures de données. Ce type de format affecte les entiers.
|- valign="top"
|
Hexadécimal
|
Affiche les valeurs entières en hexadécimal avec le préfixe 0x (pour C++, C#) ou $ (pour {{Delphi}}), y compris celles des structures de données. Ce type de format affecte les entiers.
|- valign="top"
|
Virgule flottante
|
Affiche les valeurs entières en notation virgule flottante (nombres réels ou nombres pouvant contenir une partie fractionnaire).
|- valign="top"
|
Pointeur
|
Utilisé pour les applications Win32 uniquement.
|- valign="top"
|
Enreg./Struct.
|
Affiche le nom des champs et la valeur correspondante de la manière suivante (X:1;Y:10;Z:5) au lieu de (1,10,5).
|- valign="top"
|
Par défaut
|
Montre le résultat dans le format d'affichage correspondant aux types de données de l'expression. Ce format s'applique aux expressions de tout type.
|- valign="top"
|
Vidage mémoire
|
Utilisé pour les applications Win32 uniquement.
|}

{{Tip| Par défaut, le débogueur affiche le résultat d'un point de suivi dans le format correspondant au type de données de l'expression. Par exemple, les valeurs entières sont affichées au format décimal. Vous pouvez cependant spécifier pour une expression de type entier un affichage hexadécimal en cliquant sur le bouton '''Hexadécimal'''. Si vous placez un point de suivi sur l'élément d'une structure de données (un tableau, par exemple), vous pouvez afficher les valeurs de plusieurs éléments consécutifs. Par exemple, supposons que vous ayez un tableau de cinq entiers appelé tableauX. Tapez le nombre 5 pour l'option '''Répétitions''' pour voir les cinq valeurs du tableau. Toutefois, pour utiliser Répétitions l'expression de suivi doit représenter un seul élément de données. Vous pouvez modifier la valeur de l'expression d'un point de suivi dans la boîte de dialogue '''Evaluer/Modifier'''.}}

{{Tip| Pour formater une expression à virgule flottante, sélectionnez '''Virgule flottante''' et entrez un nombre pour l'option '''Chiffres''' pour indiquer le nombre de chiffres significatifs devant apparaître dans la liste des points de suivi. }}

==Voir aussi==

* [[Fenêtre Liste des points de suivi|Fenêtre Liste des points de suivi]]
* [[Ajout d'un point de suivi|Ajout d'un point de suivi]]
* [[Présentation du débogage|Présentation du débogage]]

{{DEFAULTSORT:Proprietes du point de suivi}}
[[Category:Référence RAD Studio]]
[[Category:AMMigrate]]

[[en:Watch Properties]]
[[de:Eigenschaften Darstellung überwachter Ausdrücke]]
[[ja:［監視式のプロパティ］]]

Recensement d'un objet Active Server

2021-01-29T03:07:47Z

Fabiola.Arias : Added the {{Note|}} template

{{Parent|Création d'une page Active Server - Index}}

Vous pouvez recenser la page Active Server en tant que [[Serveurs en processus, hors processus et distants|serveur en processus ou hors processus]]. Toutefois, les serveurs en processus sont plus couramment utilisés. Un '''serveur automation en-processus''' est un ensemble d'objets Automation COM pour la connexion aux bases de données, l'exécution des instructions SQL et des blocs PL/SQL et l'accès aux résultats. Les objets automation en-processus sont à l'intérieur des .DLLs ; les '''serveurs automation hors processus''' sont des applications (.EXEs).

{{Note| Le recensement d'un objet Page Active Server ajoute une entrée au registre système Windows. Les entrées de registre associées aux objets peuvent seulement être dérecensées en utilisant le code de l'objet associé approprié. C'est-à-dire que si l'objet n'existe plus, il ne peut pas être utilisé pour le dérecensement. Ainsi, le registre peut devenir encombré avec des recensements "orphelins". 

* Le '''dérecensement''' est important dans plusieurs cas
** Avant de retirer un objet Page Active Server de votre système, vous devez dérecenser l'objet.
** Si vous recensez un objet Page Active Server pendant le développement d'une application, mais que vous décidez par la suite de ne pas enregistrer l'application, vous devrez toujours dérecenser l'objet avant d'abandonner l'application.
}}

==Recensement d'un serveur en processus==

Pour recenser un serveur en processus (DLL ou OCX), choisissez l'une des actions suivantes :

* '''Exécuter > Serveur ActiveX > Recenser '''
* '''Exécuter > Serveur ActiveX > Recenser pour l'utilisateur en cours'''

Pour dérecenser un serveur en processus, choisissez '''Exécuter > Serveur ActiveX > Dérecenser'''. Cette action dérecense tous les serveurs, y compris ceux qui ont été recensés par utilisateur.

{{Note| L'EDI, étant un processus 32 bits, ne peut pas recenser les '''serveurs DLL/en processus 64 bits''' (les processus 32 bits ne peuvent pas charger les DLLs 64 bits). Pour recenser les serveurs en processus 64 bits, vous devez utiliser la version 64 bits de [[TRegSvr.exe, l'outil de recensement des bibliothèques de types|TRegSvr.exe]], située dans $(BDS)\bin64\TRegSvr.exe.}}

==Recensement d’un serveur hors processus==

Pour recenser un serveur hors processus, exécutez le serveur avec l'option de ligne de commande <code>/regserver</code>. Vous pouvez définir les paramètres de la ligne de commande sur la boîte de dialogue '''Exécuter > Paramètres'''.

Pour dérecenser un serveur hors processus, exécutez le serveur avec l'option de ligne de commande <code>/unregserver</code>.

==Voir aussi==

* [[Recensement d'un objet COM|Recensement d'un objet COM]]
* [[Recensement des serveurs ActiveX pour l'utilisateur en cours|Recensement des serveurs ActiveX pour l'utilisateur en cours]]

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

[[en:Registering an Active Server Object]]
[[de:Ein Active-Server-Objekt registrieren]]
[[ja:Active Server オブジェクトの登録]]

Définition d'une connexion (FireDAC)

2021-01-19T03:28:22Z

Fabiola.Arias : Added the {{Note|}} template

{{Parent|Utilisation des connexions (FireDAC)}}

Explique comment stocker et utiliser les paramètres de connexion FireDAC, ainsi que la signification d'une définition de connexion. Pour spécifier les paramètres de connexion, une application doit utiliser une définition de connexion. La définition de connexion est un ensemble de paramètres. Une connexion peut également être regroupée ('''mise en pool''').

==Informations générales==

Une '''définition de connexion''' est un ensemble de paramètres qui définissent comment connecter une application à un SGBD en utilisant un pilote FireDAC spécifique. {{f|bde|C'est l'équivalent d'un alias BDE, d'un UDL ADO (chaîne de connexion OLEDB stockée) ou d'un nom de source de données (DSN) ODBC.|C'est l'équivalent d'un UDL ADO (chaîne de connexion OLEDB stockée) ou d'un nom de source de données (DSN) ODBC.}} Pour connaître la liste des systèmes de gestion de base de données supportés et des paramètres correspondants, voir [[Connectivité des bases de données (FireDAC)|Connectivité des bases de données FireDAC]].

FireDAC supporte trois types de définition de connexion :

{| border="1" frame="hsides" rules="rows"
|-
! '''Type'''
! '''Description'''
! '''Avantages'''
! '''Inconvénients'''
|-
| style="text-align: left; vertical-align: top;" | '''Persistante '''
| style="text-align: left; vertical-align: top;" | Possède un nom unique, est gérée par FDManager et stockée dans un fichier de définition de connexion.
| style="text-align: left; vertical-align: top;" | Peut être définie une fois et réutilisée dans de nombreuses applications. Peut être mise en pool.
| style="text-align: left; vertical-align: top;" | Les paramètres (adresse du serveur, nom de la base de données, etc.) sont publiquement visibles et peuvent être modifiés par inadvertance.

FDManager doit être réactivé ou l'EDI {{Delphi}} doit être redémarré pour qu'une définition nouvellement ajoutée soit visible à la conception.
|-
| style="text-align: left; vertical-align: top;" | '''Privée '''
| style="text-align: left; vertical-align: top;" | Possède un nom unique, est gérée par FDManager, mais n'est PAS stockée dans un fichier de définition de connexion.
| style="text-align: left; vertical-align: top;" | Les paramètres de la définition de connexion ne sont pas visibles "en dehors" de l'application. Peut être mise en pool.
| style="text-align: left; vertical-align: top;" | L'application doit créer une définition de connexion privée après chaque redémarrage du programme et ne peut pas la partager avec les autres programmes.

Ne peut pas être créée à la conception.
|-
| style="text-align: left; vertical-align: top;" | '''Temporaire '''
| style="text-align: left; vertical-align: top;" | N'a pas de nom, n'est pas stockée dans un fichier de définition de connexion et n'est pas gérée par FDManager.
| style="text-align: left; vertical-align: top;" | Le moyen le plus simple de créer une définition de connexion consiste à remplir la propriété [[lib_fr:FireDAC.Comp.Client.TFDConnection.Params|TFDConnection.Params]].

Peut être créée à la conception à l'aide de l'éditeur de composant TFDConnection.
| style="text-align: left; vertical-align: top;" | Similaire à la définition de connexion privée. Ne peut pas être référencée par un nom et ne peut pas être mise en pool.
|}

==Fichier de définition de connexion==

Les définitions de connexions persistantes sont stockées dans un fichier externe : le '''fichier de définition de connexion'''. Ce fichier est au format de fichier texte INI standard. Il peut être modifié par les utilitaires [[FDExplorer|FDExplorer]] ou [[FDAdministrator|FDAdministrator]] (pour commencer), manuellement ou par le code. Par défaut, le fichier est {{Path|{{PublicFireDACPath}}\FDConnectionDefs.ini}}.

{{Note| Si vous ajoutez une nouvelle définition de connexion persistante en utilisant FDExplorer ou FDAdministrator alors que l'EDI de {{Product}} est en cours d'exécution, la connexion est invisible pour le code FireDAC en mode conception. Pour actualiser la liste des définitions de connexions persistantes, vous devez réactiver FDManager ou redémarrer l'EDI de {{Product}}.}}

Contenu exemple de ce fichier :

<source lang="ini">
[Oracle_Demo]
DriverID=Ora
Database=ORA_920_APP
User_Name=ADDemo
Password=a
MetaDefSchema=ADDemo
;MonitorBy=Remote

[MSSQL_Demo]
DriverID=MSSQL
Server=127.0.0.1
Database=Northwind
User_Name=sa
Password=
MetaDefSchema=dbo
MetaDefCatalog=Northwind
MonitorBy=Remote
</source>

Une application peut spécifier un nom de fichier de définition de connexion dans la propriété [[lib_fr:FireDAC.Comp.Client.TFDCustomManager.ConnectionDefFileName|FDManager.ConnectionDefFileName]]. FireDAC recherche un fichier de définition de connexion aux endroits suivants :

* Si ConnectionDefFileName est spécifié :
** Recherche un nom de fichier sans chemin, puis le cherche dans le dossier EXE d'une application.
** Sinon, utilise un nom de fichier spécifié.
* Si ConnectionDefFileName n'est pas spécifié :
** Recherche '''FDConnectionDefs.ini''' dans le dossier EXE d'une application.
** Si le fichier ci-dessus n'est pas trouvé, recherche un fichier spécifié dans la clé de registre '''HKCU\Software\{{Company}}\FireDAC\ConnectionDefFile'''. Par défaut, il s'agit de {{Path|{{PublicFireDACPath}}\FDConnectionDefs.ini}}.

{{Note| A la conception, FireDAC ignore la valeur de [[lib_fr:FireDAC.Comp.Client.TFDManager.ConnectionDefFileName|FDManager.ConnectionDefFileName]], puis cherche un fichier dans un dossier Bin {{Product}} ou tel que spécifié dans le registre. Si le fichier n'est pas trouvé, une exception est déclenchée.}}

Si [[lib_fr:FireDAC.Comp.Client.TFDCustomManager.ConnectionDefFileAutoLoad|FDManager.ConnectionDefFileAutoLoad]] a la valeur '''True''', un fichier de définition de connexion se charge automatiquement. Sinon, il doit être chargé explicitement en appelant la méthode [[lib_fr:FireDAC.Comp.Client.TFDCustomManager.LoadConnectionDefFile|FDManager.LoadConnectionDefFile]] avant la première utilisation des définitions de connexion. Par exemple, avant de définir TFDConnection.Connected sur '''True'''.

==Création d'une définition de connexion persistante==

Une définition de connexion persistante peut être créée à l'aide de [[FDExplorer|FDExplorer]] ou [[FDAdministrator|FDAdministrator]]. Voici comment vous pouvez faire cela dans le code. Voir également la démo [[samp_en:FireDAC.ConnectionDefs Sample|Connection Definitions (EN)]].

L'extrait de code suivant crée une définition de connexion nommée "MSSQL_Connection", qui possède tous les paramètres requis pour se connecter à Microsoft SQL Server exécuté localement, en utilisant l'authentification du système d'exploitation (SSPI) :

<source lang="delphi">

uses
FireDAC.Comp.Client, FireDAC.Stan.Def, FireDAC.Stan.Intf,
// Required uses for creating a persistent connection with MSSQL (to fdconnectiondefs.ini)
FireDAC.Phys.MSSQL,
FireDAC.Phys.MSSQLDef;

const
cNameConnDef = 'MSSQL_Connection';

procedure TForm1.PersistentConnectionClick(Sender: TObject);
var
oDef: IFDStanConnectionDef;
oParams: TFDPhysMSSQLConnectionDefParams; // MSSQL connection params
begin
// Adding new persistent connection to fdconnectiondefs.ini
FDManager.ConnectionDefs.AddConnectionDef;
oDef := FDManager.ConnectionDefs.AddConnectionDef;
oDef.Name := cNameConnDef;
oParams := TFDPhysMSSQLConnectionDefParams(oDef.Params);
oParams.DriverID := 'MSSQL'
oParams.Database := 'Northwind';
oParams.UserName := '.............';
oParams.Password := '.............';
oParams.Server := '127.0.0.1';
oParams.OSAuthent := false;
oParams.MARS := false;
oDef.MarkPersistent;
oDef.Apply;
end;

.....................

procedure TForm1.ConnectionClick(Sender: TObject);
FDConnection1.ConnectionDefName := cNameConnDef;
FDConnection1.Connected := True;
end;
</source>

FDManager est une instance globale du gestionnaire de connexion FireDAC. Sa propriété [[lib_fr:FireDAC.Comp.Client.TFDCustomManager.ConnectionDefs|FDManager.ConnectionDefs]] : IFDStanConnectionDefs est une collection de définitions de connexions persistantes et privées. La méthode '''AddConnectionDef''' ajoute une nouvelle définition de connexion. La méthode '''MarkPersistent''' marque une définition de connexion comme persistante. La méthode '''Apply''' enregistre une définition de connexion dans un fichier de définition de connexion. Sans l'appel MarkPersistent, la définition de connexion est privée.

==Création d'une définition de connexion privée==

Une définition de connexion privée peut uniquement être créée dans le code. Le code est similaire à celui ci-dessus, mais sans l'appel MarkPersistent.

{{f|bde|Vous pouvez également utiliser une technique similaire à BDE :|Vous pouvez également utiliser la technique alternative suivante :}}

<source lang="delphi">
var
oParams: TStrings;
begin
oParams := TStringList.Create;
oParams.Add('Server=127.0.0.1');
oParams.Add('Database=Northwind');
oParams.Add('OSAuthent=Yes');
FDManager.AddConnectionDef('MSSQL_Connection', 'MSSQL', oParams);
.....................
FDConnection1.ConnectionDefName := 'MSSQL_Connection';
FDConnection1.Connected := True;
</source>

==Création d'une définition de connexion temporaire==

===A la conception===

Une définition de connexion temporaire peut être créée à la conception à l'aide de l'éditeur de connexion FireDAC. Pour ce faire, double-cliquez sur un composant TFDConnection pour appeler l'éditeur :

[[Image:Defining.png|450px]]

Ou en cliquant sur l'icône [[lib_fr:FireDAC.Comp.Client.TFDConnection|TFDConnection]] en mode ''Conception'' et en sélectionnant le pilote dans la propriété [[lib_fr:FireDAC.Comp.Client.TFDConnection.DriverName|DriverName]] de '''l'inspecteur d'objets'''. Développez ensuite la propriété [[lib_fr:FireDAC.Comp.Client.TFDConnection.Params|Params]] et configurez les propriétés requises. La dernière étape consiste à définir la propriété [[lib_fr:FireDAC.Comp.Client.TFDConnection.Connected|Connected]] sur '''True'''.

===A l'exécution===

Pour créer une connexion temporaire, à l'exécution dans le code, remplissez la propriété [[lib_fr:FireDAC.Comp.Client.TFDConnection.Params|TFDConnection.Params]]. C'est le moyen le plus simple et le plus pratique de créer une définition de connexion.

<source lang="delphi">
FDConnection1.DriverName := 'MSSQL';
FDConnection1.Params.Add('Server=127.0.0.1');
FDConnection1.Params.Add('Database=Northwind');
FDConnection1.Params.Add('User_name=sa');
FDConnection1.Connected := True;
</source>

Une autre façon de créer une définition de connexion temporaire à l'exécution consiste à transtyper la propriété [[lib_fr:FireDAC.Comp.Client.TFDConnection.Params|TFDConnection.Params]] en une classe spécifique SGBD. C'est le moyen le plus fiable pour créer une définition de connexion, car l'audit de code de l'EDI et la vérification syntaxique du compilateur peuvent être utilisés pour contrôler la justesse.

<source lang="delphi">
uses
FireDAC.Phys.IBDef, FireDAC.Phys.IBWrapper;
......
FDConnection1.DriverName := 'IB';
with FDConnection1.Params as TFDPhysIBConnectionDefParams do begin
Protocol := ipTCPIP;
Server := '127.0.0.1';
Database := 'c:\IB\employee.gdb';
UserName := 'sysdba';
Password := 'masterkey';
end;
FDConnection1.Connected := True;
</source>

Une autre option consiste à spécifier une chaîne de connexion à l'exécution en remplissant la propriété [[lib_fr:FireDAC.Comp.Client.TFDCustomConnection.ConnectionString|TFDConnection.ConnectionString]]. Une chaîne de connexion peut être un moyen pratique de spécifier les paramètres d'une définition de connexion pour certains types d'applications. Par exemple :

<source lang="delphi">
FDConnection1.ConnectionString := 'DriverID=MSSQL;Server=127.0.0.1;Database=Northwind;User_name=sa';
FDConnection1.Connected := True;
</source>

==Modification d'une définition de connexion==

Une application peut avoir besoin de créer et de modifier une définition de connexion à l'exécution à l'aide de la boîte de dialogue Editeur de connexion FireDAC standard. Pour modifier une définition de connexion temporaire stockée dans TFDConnection, utilisez le code :

<source lang="delphi">
uses
FireDAC.VCLUI.ConnEdit;
...
if TfrmFDGUIxFormsConnEdit.Execute(FDConnection1, '') then
FDConnection1.Connected := True;
</source>

Pour modifier une définition de connexion représentée sous forme de chaîne de connexion FireDAC, utilisez le code :

<source lang="delphi">
uses
FireDAC.VCLUI.ConnEdit;
...
var
sConnStr: String;
...
sConnStr := FDConnection1.ResultConnectionDef.BuildString();
if TfrmFDGUIxFormsConnEdit.Execute(sConnStr, '') then begin
FDConnection1.ResultConnectionDef.ParseString(sConnStr);
FDConnection1.Connected := True;
end;
</source>

==Voir aussi==

* [[FDAdministrator|Utilitaire FDAdministrator]]
* [[FDExplorer|Utilitaire FDExplorer]]
* [[Connectivité des bases de données (FireDAC)|Connectivité des bases de données FireDAC]]
* [[Multi-threading (FireDAC)|Multi-threading]]
* [[Variables relatives au chemin (FireDAC)|Variables relatives au chemin]]

===Exemple===

* Exemple [[samp_en:FireDAC.ConnectionDefs Sample|FireDAC Connection Definitions]]
* Exemple [[samp_en:FireDAC.IFDPhysConnection.CreateConnection Sample|FireDAC Create Connection]]
* Exemple [[samp_en:FireDAC.InterBase Sample|FireDAC InterBase]]
* Exemple [[samp_en:FireDAC.MSAccess Sample|FireDAC MS Access]]
* Exemple [[samp_en:FireDAC.MSSQL Sample|FireDAC MS SQL]]
* Exemple [[samp_en:FireDAC.MySQL Sample|FireDAC MySQL]]
* Exemple [[samp_en:FireDAC.SQLite Sample|FireDAC SQLite]]

{{DEFAULTSORT:Definition d'une connexion (FireDAC)}}
[[Category:FireDAC]]
[[Category:AMMigrate]]

[[en:Defining Connection (FireDAC)]]
[[de:Definieren von Verbindungen (FireDAC)]]
[[ja:接続の定義（FireDAC）]]

Utilisation des conseils durant le débogage

2021-01-14T04:02:15Z

Fabiola.Arias : Added the {{Tip|}} and the {{Note|}} templates

{{Parent|Comment utiliser le débogueur}}

Lorsque vous déboguez une application, vous pouvez afficher les valeurs des membres dans un objet suivi dont le type est un objet de données complexe (comme une classe, un enregistrement ou un tableau). Ces valeurs s'affichent dans la fenêtre de l'éditeur de code quand vous développez un objet suivi. En outre, vous pouvez développer les éléments d'un objet, en affichant ses sous-éléments et leurs valeurs. Vous pouvez développer tous les niveaux de l'objet. Les membres sont groupés par ancêtre.

{{Note| Les conseils sont supportés par tous les débogueurs Embarcadero.}}

'''Pour développer les conseils lors du débogage'''

# Créez une nouvelle application VCL pour Win32 ou ouvrez une application existante.
# Choisissez {{menu|Projet > Options > Compilateur {{Delphi}} > [[Compilation|Compilation]]}} et vérifiez que l'option '''Utiliser DCU de débogage''' est sélectionnée.
# Choisissez {{menu|Outils > Options > Options de l'éditeur > [[Audit de code|Audit de code]]}} et vérifiez que l'option '''Evaluation d'expression dans conseil''' est sélectionnée.
# Choisissez {{menu|Exécuter > Pas à pas}}.{{Tip| Vous pouvez aussi appuyer sur <code>'''F8'''</code>.}} Cela ouvre la page '''Code''' du fichier source principal du projet.
# Choisissez de nouveau {{menu|Exécuter > [[Pas à pas|Pas à pas]]}}. Cette opération initialise le projet.
# Déplacez le curseur sur le mot clé '''Application'''. Cette opération affiche le conseil dans un bloc unique.
# Cliquez sur le '''+''' situé près du mot clé '''Application''' dans le conseil.
#* Le conseil se développe en une boîte défilable qui contient chaque propriété enfant et sa valeur.
#* Un '''+''' apparaît en regard de chaque propriété ayant une ou plusieurs propriétés enfant.
#* Vous pouvez développer n'importe quel membre pour afficher les propriétés et les valeurs hiérarchiquement dans le conseil.

==Voir aussi==

*[[Débogage des applications|Débogage des applications]]
*[[Audit de code|Audit de code]]
* [[Fenêtre Liste des points de suivi|Fenêtre Liste des points de suivi]]

{{DEFAULTSORT:Utilisation des conseils durant le debogage}}
[[Category:Utilisation de RAD Studio]]
[[Category:Delphi]]
[[Category:C++]]
[[Category:AMMigrate]]

[[en:Using Tooltips During Debugging]]
[[de:Kurzhinweise während des Debuggens verwenden]]
[[ja:デバッグ中にツールチップを使用する]]

Recensement des types non scalaires

2021-01-09T04:42:30Z

Fabiola.Arias : Added the {{Note|}} template

{{Parent|Utilisation de types non scalaires dans des interfaces invocables}}

Pour qu'une interface invocable puisse utiliser des types autres que les types scalaires prédéfinis énumérés dans [[Utilisation de types non scalaires dans des interfaces invocables|Utilisation de types non scalaires dans des interfaces invocables]], l'application doit avoir recensé le type à l'aide du registre des types distants. Pour accéder à ce registre, vous devez ajouter l'unité InvokeRegistry à votre clause uses. Cette unité déclare une fonction globale, ''RemTypeRegistry'', qui renvoie une référence au registre des types distants.

{{Note| Côté client, le code permettant de recenser les types avec le registre des types distants est généré automatiquement lorsque vous importez un document WSDL. Côté serveur, les types distants sont automatiquement recensés lorsque vous recensez une interface qui les utilise. Il vous suffit d'ajouter du code pour recenser les types de manière explicite si vous souhaitez spécifier l'espace de nommage ou le nom du type plutôt qu'utiliser les valeurs générées automatiquement.}}

Le registre des types distants dispose de deux méthodes pour recenser les types :[[lib_fr:Soap.InvokeRegistry.TRemotableTypeRegistry.RegisterXSInfo|RegisterXSInfo]] et [[lib_fr:Soap.InvokeRegistry.TRemotableTypeRegistry.RegisterXSClass|RegisterXSClass]]. La première ''RegisterXSInfo'') vous permet de recenser un tableau dynamique ou une autre définition de type. La deuxième (''RegisterXSClass'') concerne le recensement des classes distantes que vous définissez pour représenter d'autres types.

Si vous utilisez des tableaux dynamiques ou des types énumérés, le registre d'invocation peut obtenir les informations dont il a besoin à partir des informations de type générées par le compilateur. Par exemple, votre interface peut utiliser un type comme celui-ci :
<l s="delphi" />

type
TDateTimeArray = array of TXSDateTime;

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

typdef DynamicArray<TXSDateTime> TDateTimeArray;

<l e="cpp" />
Ce type est automatiquement recensé lorsque vous recensez l'interface invocable. Toutefois, si vous voulez spécifier l'espace de nommage dans lequel le type est défini ou bien le nom du type, vous devez ajouter du code pour recenser explicitement le type à l'aide de la méthode ''RegisterXSInfo'' du registre des types distants.

Le recensement figure dans la section initialisation de l'unité dans laquelle vous déclarez ou utilisez le tableau dynamique :
<l s="delphi" />

RemTypeRegistry.RegisterXSInfo(TypeInfo(TDateTimeArray), MyNameSpace, 'DTarray', 'DTarray');

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

void RegTypes()
{
RemTypeRegistry()->RegisterXSInfo(__arraytypeinfo(TDateTimeArray),
MyNameSpace, "DTarray", "DTarray");
InvRegistry()->RegisterInterface(__delphirtti(ITimeServices));
}

<l e="cpp" />
Le premier paramètre de ''RegisterXSInfo'' comprend les informations de type concernant le type que vous êtes en train de recenser. Le deuxième paramètre est l'URI de l'espace de nommage dans lequel le type est défini. Si vous omettez ce paramètre ou spécifiez une chaîne vide, le registre génère un espace de nommage à votre place. Le troisième paramètre est le nom du type tel qu'il apparaît dans le code natif. Si vous omettez ce paramètre ou spécifiez une chaîne vide, le registre extrait le nom du type des informations de type fournies comme premier paramètre. Le dernier paramètre est le nom du type tel qu'il apparaît dans les documents WSDL. Si vous omettez ce paramètre ou spécifiez une chaîne vide, le registre utilise le nom de type natif (le troisième paramètre).

L'enregistrement d'une [[Utilisation d'objets distants|classe distante]] est similaire, mis à part que vous fournissez une référence de classe au lieu d'un pointeur d'informations de type. Par exemple, la ligne suivante provient de l'unité XSBuiltIns. Elle recense ''TXSDateTime'', un descendant de ''TRemotable'' qui représente des valeurs ''TDateTime'' :
<l s="delphi" />

RemClassRegistry.RegisterXSClass(TXSDateTime, XMLSchemaNameSpace, 'dateTime', '',True);''

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

void RegTypes()
{
RemTypeRegistry()->RegisterXSclass(__classid(TXSDateTime), XMLSchemaNameSpace, "dateTime", "", true);
InvRegistry()->RegisterInterface(__delphirtti(ITimeServices));
}

<l e="cpp" />
Le premier paramètre est la référence de classe de la classe distante qui représente le type. Le deuxième est un identificateur de ressource uniforme (URI) qui identifie de manière unique l'espace de nommage de la nouvelle classe. Si vous spécifiez une chaîne vide, le registre génère un URI à votre place. Les troisième et quatrième paramètres spécifient les noms natif et externe du type de données représenté par votre classe. Si vous omettez le quatrième paramètres, le registre des types utilise le troisième paramètre pour les deux valeurs. Si vous spécifiez une chaîne vide pour les deux paramètres, le registre utilise le nom de la classe. Le cinquième paramètre indique si la valeur des instances de classe peut être transmise sous forme d'une chaîne. Vous pouvez ajouter un sixième paramètre facultatif (non présenté ici) pour contrôler la manière dont plusieurs références à la même instance d'objet doivent être représentées dans les paquets SOAP.

==Voir aussi==

*[[Utilisation d'objets distants|Utilisation d'objets distants]]

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

[[en:Registering Nonscalar Types]]
[[de:Nicht-skalare Typen registrieren]]
[[ja:非スカラー型の登録]]

Utilisation de types non scalaires dans des interfaces invocables

2021-01-05T04:58:50Z

Fabiola.Arias : Added the {{Note|}} template

{{Parent|Présentation des interfaces invocables}}

L'architecture des services Web prend en charge les types scalaires suivants pour Delphi et C++ :

{| border="1" frame="hsides" rules="rows"
|-
| style="text-align: left; vertical-align: top;" |
Boolean
| style="text-align: left; vertical-align: top;" |
ByteBool
| style="text-align: left; vertical-align: top;" |
WordBool
|-
| style="text-align: left; vertical-align: top;" |
LongBool
| style="text-align: left; vertical-align: top;" |
Char
| style="text-align: left; vertical-align: top;" |
Byte
|-
| style="text-align: left; vertical-align: top;" |
ShortInt
| style="text-align: left; vertical-align: top;" |
SmallInt
| style="text-align: left; vertical-align: top;" |
Word
|-
| style="text-align: left; vertical-align: top;" |
Integer
| style="text-align: left; vertical-align: top;" |
Cardinal
| style="text-align: left; vertical-align: top;" |
LongInt
|-
| style="text-align: left; vertical-align: top;" |
Int64
| style="text-align: left; vertical-align: top;" |
Single
| style="text-align: left; vertical-align: top;" |
Double
|-
| style="text-align: left; vertical-align: top;" |
Extended
| style="text-align: left; vertical-align: top;" |
string
| style="text-align: left; vertical-align: top;" |
WideString
|-
| style="text-align: left; vertical-align: top;" |
Currency
| style="text-align: left; vertical-align: top;" |
TDateTime
| style="text-align: left; vertical-align: top;" |
Variant
|}

Les types scalaires supplémentaires suivants sont pris en charge pour C++ :

{| border="1" frame="hsides" rules="rows"
|-
| style="text-align: left; vertical-align: top;" |
bool
| style="text-align: left; vertical-align: top;" |
unsigned short
| style="text-align: left; vertical-align: top;" |
_int64
|-
| style="text-align: left; vertical-align: top;" |
char
| style="text-align: left; vertical-align: top;" |
int
| style="text-align: left; vertical-align: top;" |
AnsiString
|-
| style="text-align: left; vertical-align: top;" |
signed char
| style="text-align: left; vertical-align: top;" |
unsigned
| style="text-align: left; vertical-align: top;" |
float
|-
| style="text-align: left; vertical-align: top;" |
unsigned char
| style="text-align: left; vertical-align: top;" |
long
| style="text-align: left; vertical-align: top;" |
double
|-
| style="text-align: left; vertical-align: top;" |
short
| style="text-align: left; vertical-align: top;" |
unsigned long
| style="text-align: left; vertical-align: top;" |
long double
|}

Vous n'avez rien à faire de particulier lorsque vous utilisez ces types scalaires sur une interface invocable. Toutefois, si votre interface inclut des propriétés ou des méthodes qui utilisent d'autres types, votre application doit recenser ces types avec le [[Recensement des types non scalaires|registre des types distants]].

Les tableaux dynamiques peuvent être utilisés dans les interfaces invocables. Ils doivent être recensés dans le registre des types distants, mais ce recensement intervient automatiquement lorsque vous recensez l'interface. Le registre des types distants extrait toutes les informations requises des informations de type générées par le compilateur.

{{Note|Vous devez éviter de définir plusieurs types de tableaux dynamiques avec le même type d'élément. Comme le compilateur les traite comme des types transparents pouvant être implicitement transtypés l'un vers l'autre, il ne distingue pas leurs informations accessibles à l'exécution. Par conséquent, le registre des types distants ne peut pas différencier les types. Cela ne pose pas un problème pour les serveurs mais peut amener les clients à utiliser une mauvaise définition de type. Une autre approche consiste à utiliser des classes distantes pour représenter des types de tableaux.}}

{{Note|Les types de tableaux dynamiques définis dans l'unité Types sont recensés automatiquement, de sorte que votre application n'a pas besoin d'ajouter de code de recensement particulier pour ces types. Un de ces types en particulier, ''TByteDynArray'', mérite une mention spéciale car il établit une correspondance avec un bloc ‘base64’ de données binaires plutôt qu'avec chaque élément du tableau séparément, comme les autres types de tableaux dynamiques.}}

En outre, les types énumérés et ceux correspondant à l'un des types scalaires automatiquement soumis au marshaling peuvent être utilisés dans une interface invocable. Comme les types de tableaux dynamiques, ils sont automatiquement recensés dans le registre des types distants.

Pour tous les autres types, comme les tableaux statiques, les structures ou enregistrements, les ensembles, les interfaces ou les classes, vous devez établir une correspondance entre le type et une [[Utilisation d'objets distants|classe distante]]. Une classe distante est une classe qui inclut des informations de type accessibles à l'exécution (RTTI). Votre interface doit alors utiliser la classe distante à la place du tableau statique, de la structure ou enregistrement, de l'ensemble, de l'interface ou de la classe correspondants. Toutes les classes distantes que vous créez doivent être recensées dans le registre des types distants. Comme pour les autres types, ce recensement intervient automatiquement.

==Rubriques==

* [[Recensement des types non scalaires|Recensement des types non scalaires]]
* [[Utilisation d'objets distants|Utilisation d'objets distants]]
* [[Exemple d'objet distant|Exemple d'objet distant]]

==Voir aussi==

*[[Présentation des interfaces invocables|Présentation des interfaces invocables]]
*[[Conception de serveurs gérant les services Web|Conception de serveurs gérant les services Web]]
* [[Mappage des types Delphi en types C++|Mappage des types Delphi en types C++]]

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

[[en:Using Nonscalar Types in Invokable Interfaces]]
[[de:Nicht-skalare Typen in aufrufbaren Interfaces verwenden]]
[[ja:起動可能インターフェイスでの非スカラー型の使用]]

Génération de documents WSDL pour une application de service Web

2020-12-24T06:38:19Z

Fabiola.Arias : Added the {{Tip|}} and the {{Note|}} templates

{{Parent|Conception de serveurs gérant les services Web}}

Pour permettre aux applications client de savoir quels services Web votre application met à disposition, vous pouvez publier un document WSDL qui décrit vos interfaces invocables et indique comment les appeler.

Pour publier un document WSDL décrivant votre service Web, incluez un composant [[lib_fr:Soap.WSDLPub.TWSDLHTMLPublish|Soap.WSDLPub.TWSDLHTMLPublish]] dans votre module Web. L'expert d'application serveur SOAP ajoute ce composant par défaut. ''TWSDLHTMLPublish'' est un composant à auto-répartition, ce qui signifie qu'il répond automatiquement aux messages entrants qui demandent une liste de documents WSDL pour votre service Web. Utilisez la propriété [[lib_fr:Soap.WSDLPub.TWSDLHTMLPublish.WebDispatch|WebDispatch]] pour spécifier les informations de l'URL que les clients doivent utiliser pour accéder à la liste des documents WSDL. Le navigateur Web peut alors demander une liste de documents WSDL en spécifiant une URL constituée de l'emplacement de l'application serveur suivi du chemin spécifié par la propriété ''WebDispatch''. Cette URL a la forme suivante :

<nowiki> http://www.myco.com/MyService.dll/WSDL </nowiki>

{{Tip|Si vous souhaitez utiliser un fichier WSDL physique à la place, vous pouvez afficher le document WSDL dans votre navigateur Web puis l'enregistrer pour générer le fichier document WSDL.}}

{{Note|Outre le document WSDL, ''THWSDLHTMLPublish'' génère également un document WS-Inspection pour décrire le service des outils automatisés. L'URL de ce document a la forme suivante :}}

<nowiki> http://www.myco.com/MyService.dll/inspection.wsil </nowiki>

Il n'est pas nécessaire de publier le document WSDL à partir de l'application qui implémente votre service Web. Pour créer une application qui publie simplement le document WSDL, omettez le code qui implémente et recense les objets d'implémentation et incluez uniquement le code définissant et recensant les interfaces invocables, les classes distantes qui représentent des types complexes et toutes les exceptions distantes.

Par défaut, quand vous publiez un document WSDL, il indique que les services sont disponibles à l'URL à laquelle vous avez publié le document WSDL (mais avec un chemin différent). Si vous déployez plusieurs versions de votre application de service Web ou si vous publiez le document WSDL à partir d'une application différente de celle qui implémente le service Web, vous devrez modifier le document WSDL pour qu'il contienne des informations à jour sur l'emplacement du service Web.

Pour changer l'URL, utilisez l'administrateur WSDL. Vous devez tout d'abord activer l'administrateur. Pour ce faire, initialisez la propriété [[lib_fr:Soap.WSDLPub.TWSDLHTMLPublish.AdminEnabled|AdminEnabled]] du composant ''TWSDLHTMLPublish'' à true. Ensuite, lorsque vous utiliserez votre navigateur pour afficher la liste des documents WSDL, il contiendra également un bouton permettant de les administrer. Utilisez l'administrateur WSDL pour spécifier les emplacements (URL) où vous avez déployé votre application de service Web.

==Voir aussi==

*[[Utilisation de types non scalaires dans des interfaces invocables|Utilisation de types non scalaires dans des interfaces invocables]]
*[[Création de classes d'exception personnalisées pour les services Web|Création de classes d'exception personnalisées pour les services Web]]
*[[Définition et utilisation des en-têtes SOAP|Définition et utilisation des en-têtes SOAP]]

{{DEFAULTSORT:Generation de documents WSDL pour une application de service Web}}
[[Category:Guide du développeur Windows]]
[[Category:Delphi]]
[[Category:C++]]

[[en:Generating WSDL Documents for a Web Service Application]]
[[de:WSDL-Dokumente für Web-Service-Anwendungen generieren]]
[[ja:Web サービスアプリケーション用の WSDL ドキュメントの生成]]

Préparation d'une application Android pour son déploiement

2020-12-19T03:54:34Z

Fabiola.Arias : Added the {{Note|}} template

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

Votre app Android est déployée quand vous l'exécutez sur un périphérique cible '''Android'''. Vous pouvez aussi utiliser le [[Gestionnaire de déploiement|Gestionnaire de déploiement]] pour gérer les fichiers déployés. Lorsque votre application Android est prête pour le déploiement final, vous pouvez construire et signer votre application. Voir '''[[Déploiement de votre application Android signée|Déploiement de votre application Android signée]]'''.

==Configuration des options pour le déploiement de votre app Android==

Vous devez configurer plusieurs options pour votre app Android avant de construire l'application pour la distribution. Les propriétés que vous configurez sont fournies avec votre application, dans le fichier {{Path|AndroidManifest.xml}}. Vous ne pouvez pas modifier ces propriétés après avoir construit et signé votre application. Parce que ces propriétés fournissent des informations essentielles concernant votre application, vous devez vous assurer qu'elles contiennent des valeurs correctes avant de déployer votre application. Dans le cas contraire, il se peut que vous deviez reconstruire votre application pour changer les valeurs configurées.

Avant chaque release de votre application Android, vous devez vérifier que chaque paramètre est correctement configuré.

'''Pour configurer votre app Android :'''

* Sur la page '''Projet > Options > [[Options de l'application|Application]]''', fournissez les icônes et images représentant votre application.
* Sur la page '''Projet > Options > [[Informations de version|Informations de version]]''', augmentez le code de version de votre application. Les magasins d'applications comme Google Play peuvent nécessiter que les nouvelles versions de votre application aient toujours un code de version supérieur aux versions précédentes.
* Sur la page '''Projet > Options > [[Permissions d'utilisation|Permissions d'utilisation]]''', définissez les permissions requises par votre application pour fonctionner.
* Si vous le souhaitez, vous pouvez [[Préparation d'une application Android pour son déploiement#Déclaration de fonctionnalités comme facultatives|déclarer des fonctionnalités comme facultatives]].
* Sur la page '''Projet > Options > [[Page Approvisionnement|Approvisionnement]]''', sélectionnez dans le champ '''Cible''' la configuration de construction que vous voulez utiliser pour le déploiement de votre application (par exemple, '''Release''') et [[Compléter la page Approvisionnement#Plate-forme Android (Magasin d'applications)|fournissez un fichier de certificat]] si vous n'en avez pas déjà créé un. Cette étape est nécessaire afin d'installer votre application dans un périphérique ayant le [[Activation du débogage USB sur un périphérique Android|débogage USB désactivé]] et de distribuer votre application. Pour de plus amples informations sur les fichiers magasin de clés, voir : [http://docs.oracle.com/javase/1.5.0/docs/api/java/security/KeyStore.html http://docs.oracle.com/javase/1.5.0/docs/api/java/security/KeyStore.html (EN)].

==Personnalisation de votre fichier AndroidManifest.xml==

'''{{Product}}''' écrit les [[#Configuration des options pour le déploiement de votre app Android|options de votre application Android]] dans un fichier Android spécial, [[Fichier manifest d'application Android (AndroidManifest.xml)|AndroidManifest.xml]], qui est inclus dans votre package Android final quand vous déployez votre application pour Android. Ce fichier définit des informations comme le code de version ou le nom d'affichage de votre application, la liste des permissions requises par votre application, etc.

Généralement, vous n'avez pas besoin de modifier ce fichier, et vous pouvez laisser '''{{Product}}''' s'occuper de tout. Néanmoins, {{Product}} vous permet de personnaliser le contenu du fichier {{Path|AndroidManifest.xml}} si vous devez inclure dans ce fichier des données personnalisées que vous ne pouvez pas définir visuellement dans vos [[Boîte de dialogue Options de projet|options de projet]].

Quand vous construisez une application pour la plate-forme cible Android pour la première fois, {{Product}} ajoute un fichier au dossier de votre projet : {{Path|AndroidManifest.template.xml}}. Chaque fois que vous construisez votre application pour Android, {{Product}} lit ce fichier, remplace des espaces réservés du fichier par les valeurs réelles de vos [[Boîte de dialogue Options de projet|options de projet]], et écrit le contenu résultant dans un fichier de sortie : {{Path|Android\<build configuration>\AndroidManifest.xml}}. Ce fichier de sortie est le fichier AndroidManifest.xml qui est inclus dans le package Android que {{Product}} génère quand vous déployez votre application pour la plate-forme cible Android.

Pour personnaliser le fichier de sortie {{Path|AndroidManifest.xml}} d'un '''projet unique''', modifiez le contenu de {{Path|AndroidManifest.template.xml}}.

Le fichier {{Path|AndroidManifest.template.xml}} que {{Product}} ajoute à un projet quand vous construisez ce projet pour la plate-forme cible Android pour la première fois provient de {{Path|{{AppDataPath}}\AndroidManifest.xml}}. Si vous voulez que vos '''nouveaux projets''' utilisent un autre fichier {{Path|AndroidManifest.template.xml}} de démarrage, modifiez ce fichier.

==Re-création du fichier AndroidManifest.template.xml==

Le fichier '''AndroidManifest.template.xml''' généré par {{product}} change entre deux versions. Pour déployer un projet construit avec une autre version de {{product}}, soyez très prudent avec le fichier '''AndroidManifest.template.xml''' existant dans votre dossier projet.

Il existe deux scénarios possibles :

* Vous souhaitez conserver l'ancien fichier AndroidManifest.template.xml car il est personnalisé.
* Vous n'avez pas besoin de conserver l'ancien fichier AndroidManifest.template.xml.

===Conserver le fichier AndroidManifest.template.xml===

Si vous souhaitez conserver le fichier '''AndroidManifest.template.xml''' car vous avez manuellement apporté des modifications au fichier, vous devez procéder comme suit :

* Ouvrez le dossier de votre projet.
* Assurez-vous de bien sauvegarder votre fichier '''AndroidManifest.template.xml'''.
* Supprimez le fichier '''AndroidManifest.template.xml''' de votre dossier projet.
* Ouvrez votre projet avec la nouvelle version de {{product}}.
* Sélectionnez la cible '''Android'''.
* Construisez le projet.
{{Note|La construction du projet crée un nouveau fichier '''AndroidManifest.template.xml'''.}}
* Accédez à votre dossier projet et vérifiez qu'un nouveau fichier '''AndroidManifest.template.xml''' est présent.
* Apportez manuellement vos modifications au nouveau fichier '''AndroidManifest.template.xml'''.

===Création d'un nouveau fichier AndroidManifest.template.xml===

Si vous n'avez pas modifié le fichier '''AndroidManifest.template.xml''', suivez ces étapes pour faire en sorte que {{product}} crée un nouveau fichier :

* Ouvrez le dossier de votre projet.
* Supprimez le fichier '''AndroidManifest.template.xml''', s'il existe.
* Ouvrez votre projet avec la nouvelle version de {{product}}.
* Sélectionnez la cible '''Android'''.
* Construisez le projet.
{{Note|La construction du projet crée un nouveau fichier '''AndroidManifest.template.xml'''.}}
* Accédez à votre dossier projet et vérifiez qu'un nouveau fichier '''AndroidManifest.template.xml''' est présent.

==Déclaration de fonctionnalités comme facultatives==

Lorsque vous construisez votre application Android, une liste des fonctionnalités requises est automatiquement créée selon les permissions déclarées. Cette liste est uniquement fournie à titre informatif et elle n'empêche pas l'installation d'une application sur un périphérique. Certains services, comme Google Play, utilisent cette liste pour filtrer les applications qui sont visibles aux utilisateurs. Les utilisateurs peuvent de cette façon ne voir et ne télécharger que les applications qui sont compatibles avec leur périphérique. Toutes les fonctionnalités nécessaires à votre application sont déclarées comme requises par défaut, ce qui rend votre application incompatible avec les périphériques qui ne prennent pas en charge ces fonctionnalités.

Si votre application ne requiert pas une certaine fonctionnalité pour fonctionner (mais a besoin de cette fonctionnalité pour des fonctions non essentielles), vous pouvez déclarer cette fonctionnalité comme facultative. Pour déclarer une fonctionnalité comme facultative, vous devez spécifier explicitement cette fonctionnalité comme non requise dans le manifeste de l'application.

Par exemple, pour déclarer que votre application requiert facultativement un accès au microphone, procédez comme suit :

<ul><li>Assurez-vous que la permission {{Code|Enregistrer du son}} est définie dans [[Permissions d'utilisation|Permissions d'utilisation]].
</li>
<li>Ajoutez manuellement la ligne suivante à {{Path|AndroidManifest.template.xml}} après '''<%uses-permission%>''' : (voir la section [[Préparation d'une application Android pour son déploiement#Personnalisation de votre fichier AndroidManifest.xml|Personnalisation de votre fichier AndroidManifest.xml]] pour de plus amples informations sur la façon de modifier {{Path|AndroidManifest.template.xml}}) :

<uses-feature android:name="android.hardware.microphone" android:required="False"/>

{{Note|Certaines permissions, comme {{Code|android.permission.CAMERA}}, impliquent plusieurs exigences de fonctionnalité. Pour de plus amples informations, lisez [http://developer.android.com/guide/topics/manifest/uses-feature-element.html#permissions Permissions that Imply Feature Requirements (EN)].}}
</li>
</ul>

Voir [http://developer.android.com/guide/topics/manifest/uses-feature-element.html#features-reference Features Reference (EN)] pour obtenir une liste complète des fonctionnalités matérielles et logicielles prises en charge par la release de plate-forme la plus récente.

==Voir aussi==

* [[Déploiement des applications multi-périphériques|Déploiement des applications multi-périphériques]]
* [[Déploiement de votre application Android signée|Déploiement de votre application Android signée]]
* [[Applications de base de données multi-périphériques|Applications de base de données multi-périphériques]]
* [[Création d'un fichier magasin de clés|Création d'un fichier magasin de clés]]
* [[Permissions d'utilisation|Permissions d'utilisation]]
* [[Informations de version|Informations de version]]

* [http://developer.android.com/guide/topics/manifest/uses-feature-element.html Android Developers APi Guides: App Manifest - <uses-feature> (EN)]

{{DEFAULTSORT:Preparation d'une application Android pour son deploiement}}
[[Category:Android]]
[[Category:XE5]]
[[Category:AMMigrate]]

[[en:Preparing an Android Application for Deployment]]
[[de:Vorbereiten von Android-Anwendungen für die Bereitstellung]]
[[ja:Android アプリケーションの配置準備]]

Types d'ensembles de données dbExpress

2020-11-27T14:30:00Z

Fabiola.Arias : Added the {{Note|}} template

{{Parent|Utilisation des composants dbExpress - Index}}

La catégorie ''dbExpress'' de la '''palette d'outils''' contient quatre types d'ensembles de données unidirectionnels : [[lib_fr:Data.SqlExpr.TSQLDataSet|SQLExpr.TSQLDataSet]], [[lib_fr:Data.SqlExpr.TSQLQuery|SQLExpr.TSQLQuery]], [[lib_fr:Data.SqlExpr.TSQLTable|SQLExpr.TSQLTable]] et [[lib_fr:Data.SqlExpr.TSQLStoredProc|SQLExpr.TSQLStoredProc]].

''TSQLDataSet'' est le plus général des quatre. Vous pouvez utiliser un ensemble de données SQL pour représenter n'importe quelles données disponibles via ''dbExpress'', ou pour envoyer des commandes à une base de données accédée via ''dbExpress''. C'est le composant recommandé pour travailler avec des tables dans de nouvelles applications de base de données.

''TSQLQuery'' est un [[Utilisation d'ensembles de données de type requête|ensemble de données de type requête]] qui encapsule une instruction SQL et permet aux applications d'accéder aux enregistrements éventuellement obtenus.

''TSQLTable'' est un [[Utilisation d'ensembles de données de type table|ensemble de données de type table]] qui représente toutes les lignes et colonnes d'une seule table de base de données.

''TSQLStoredProc'' est un [[Utilisation d'ensembles de données de type procédure stockée|ensemble de données de type procédure stockée]] qui exécute une procédure stockée définie sur un serveur de bases de données.

{{Note|La page ''dbExpress'' comprend également [[lib_fr:SimpleDS.TSimpleDataSet|SimpleDS.TSimpleDataSet]], qui n'est pas un ensemble de données unidirectionnel. Il s'agit d'un ensemble de données client qui utilise un ensemble de données unidirectionnel de manière interne pour accéder à ses données.}}

==Voir aussi==

* [[Spécification des données à afficher|Spécification des données à afficher]]
* [[Connexion à un serveur de bases de données en utilisant dbExpress|Connexion à un serveur de bases de données en utilisant dbExpress]]
* [[Récupération des données|Récupération des données]]
* [[Exécution des commandes ne renvoyant pas d'enregistrement|Exécution des commandes ne renvoyant pas d'enregistrement]]
* [[Accès aux informations de schéma dbExpress|Accès aux informations de schéma dbExpress]]
* [[Débogage d'applications dbExpress|Débogage d'applications dbExpress]]

{{DEFAULTSORT:Types d'ensembles de donnees dbExpress}}
[[Category:Guide du développeur Windows]]
[[Category:Delphi]]
[[Category:C++]]

[[en:Types of dbExpress Datasets]]
[[de:Arten von dbExpress-Datenmengen]]
[[ja:DbExpress データセットの種類]]

Présentation des styles VCL

2020-11-20T04:20:02Z

Fabiola.Arias : Added the {{Note|}} template

{{Parent|Travailler avec les styles VCL}}

==Qu'est-ce qu'un style==

Vous pouvez changer l'apparence d'une application VCL en utilisant un ''style''. Un style est :

* Un ensemble de détails graphiques qui définissent l'aspect d'une application VCL.
* Similaire à un thème dans Windows.

Un style vous permet de changer l'apparence de chaque partie et état d'un contrôle. Les contrôles VCL sont constitués de parties et d'états. Un style VCL est constitué d'un ensemble de valeurs pour chaque partie et état. Par exemple, une barre de défilement comprend les parties suivantes : le cadre, la glissière et les deux boutons pour chaque direction. Les boutons ont, par exemple, les états suivants : enfoncé, désactivé, sensible, normal.

Pour définir un style pour votre application VCL, définissez le style dans '''Projet > Options > Application > Apparence'''. Pour plus de détails, voir [[Apparence de l'application|Apparence de l'application]].

{{Note|Le style VCL change l'apparence de l'application en cours d'exécution. Cependant, le '''[[Concepteur de fiches|Concepteur de fiches]]''' n'affiche pas ces changements.}}

'''Emplacement des fichiers de styles (fichiers <code>.vsf</code>) :'''

* Les styles VCL livrés avec le produit sont disponibles dans
*:{{Path|{{StylesPath}}}}.
* Vous pouvez obtenir de nouveaux styles VCL, disponibles dans le [{{VCLPremiumStylesPack}} '''VCL premium style pack (EN)'''].
* En outre, vous pouvez redistribuer les styles (VCL ou {{FM}}) avec vos applications. Les fichiers de styles transmissibles se trouvent dans le répertoire d'installation du produit
*: '''\Redist\styles'''.

==Concepteur de styles de bitmaps==

Vous pouvez créer vos propres styles, ou modifier des styles existants, en utilisant le '''[[Concepteur de styles de bitmaps|Concepteur de styles de bitmaps]]''', disponible dans le menu '''Outils'''. Pour plus de détails, voir [[Création d'un style à l'aide du Concepteur de styles de bitmaps|Création d'un style à l'aide du Concepteur de styles de bitmaps]].

Le '''Concepteur de styles de bitmaps''' supporte aussi la conversion d'un style VCL en style {{FM}} et fournit des applications de test pour tester les styles VCL, {{FM}} et {{FM}} Metro.

==Gestion d'un style==

Vous pouvez utiliser la fonction [[lib_fr:Vcl.Themes.StyleServices|Vcl.Themes.StyleServices]] pour accéder par programme aux informations concernant le style en cours. Avec StyleServices, vous pouvez obtenir des informations sur les éléments et les contrôles stylés, et effectuer le dessin des contrôles. Voir [[lib_fr:Vcl.Themes.TCustomStyleServices|Vcl.Themes.TCustomStyleServices]] pour une meilleure compréhension de l'interface [[lib_fr:Vcl.Themes.StyleServices|Vcl.Themes.StyleServices]].

Utilisez la classe [[lib_fr:Vcl.Styles.TStyleEngine|Vcl.Themes.TStyleEngine]] pour recenser les classes hook de styles pour vos composants VCL personnalisés. Un hook de style est une classe que vous devez implémenter pour fournir la gestion des messages personnalisés pour votre contrôle personnalisé. Si un contrôle personnalisé nécessite un traitement visuel spécial, créez une classe hook de style qui traite les messages en héritant de [[lib_fr:Vcl.Themes.TStyleHook|Vcl.Themes.TStyleHook]].

Utilisez la classe [[lib_fr:Vcl.Themes.TStyleManager|Vcl.Themes.TStyleManager]] pour charger, recenser et sélectionner des styles, ou pour obtenir, recenser et dérecenser un moteur de style.

==Vous devez définir la possession du contrôle==

Dans les applications VCL stylées, il est particulièrement important que tous les contrôles soient [[lib_fr:Vcl.Controls.TControl.Create|créés avec un propriétaire valide]], tel que la [[lib_fr:Vcl.Forms.TForm|fiche]] à laquelle ils appartiennent, afin que la VCL puisse les identifier comme partie de l'application stylée et leur appliquer le style configuré en conséquence.

==Limitations==

L'utilisation des styles VCL comporte certaines limitations. La section suivante liste ces limitations :

* Les styles VCL ne sont pas dessinés lors de l'utilisation de [[lib_fr:Vcl.ComCtrls.TAutoCompleteOption|option suggestion automatique]] d'un contrôle [[lib_fr:Vcl.ComCtrls.TComboBoxEx|TComboBoxEx]]. Dans ce cas, la liste déroulante de suggestion automatique est toujours dessinée avec le thème Windows, même si un style VCL est actif. Cependant, le style VCL est dessiné correctement lors de l'utilisation de la liste déroulante normale.
* Windows fournit un défilement lors de l'utilisation de [[lib_fr:Vcl.Menus.TPopupMenu|menus contextuels]] qui sont plus larges que la hauteur de l'écran. Cependant, quand vous utiliser des styles VCL, le défilement n'est pas fourni. Pour résoudre ce problème, vous pouvez utiliser la propriété [[lib_fr:Vcl.Menus.TMenuItem.Break|TMenuItem.Break]] pour créer un menu sans colonnes.

==Voir aussi==

* [[Apparence de l'application|Apparence de l'application]]
* [[Concepteur de styles de bitmaps|Concepteur de styles de bitmaps]]
* [[Création d'un style à l'aide du Concepteur de styles de bitmaps|Création d'un style à l'aide du Concepteur de styles de bitmaps]]
* [[Manipulation des images dans le Concepteur de styles de bitmaps|Manipulation des images dans le Concepteur de styles de bitmaps]]
* [[Conversion d'un style VCL en style FireMonkey|Conversion d'un style VCL en style FireMonkey]]
* [[lib_fr:Vcl.Styles.TStyleEngine|Vcl.Styles.TStyleEngine]]
* [[lib_fr:Vcl.Themes.StyleServices|Vcl.Themes.StyleServices]]
* [[lib_fr:Vcl.Themes.TStyleManager|Vcl.Themes.TStyleManager]]

{{DEFAULTSORT:Presentation des styles VCL}}
[[Category:Utilisation de Delphi pour Windows]]
[[Category:Delphi]]

[[en:VCL Styles Overview]]
[[de:Überblick über VCL-Stile]]
[[ja:VCL スタイルの概要]]

Création d'une application C++ simple pour utiliser les fonctionnalités C++11

2020-11-18T02:40:05Z

Fabiola.Arias : RS-103954

{{Parent|C++ moderne}}

'''{{CBuilder}} XE3''' fournit la prise en charge de C++11, la version la plus récente du standard C++.

La façon la plus simple de tester et d'utiliser les nouvelles '''[[Fonctionnalités du C++ moderne prises en charge par les compilateurs C++ améliorés par Clang de RAD Studio|fonctionnalités C++11]]''' dans les applications {{CBuilder}} est de créer une application console C++, tel que cela est décrit dans les étapes suivantes. {{f|vcl|Vous pouvez également utiliser les fonctionnalités C++11 dans n'importe quelle application C++ Windows 64 bits créée avec {{Product}}, comme une application de fiches VCL C++ ou une application multi-périphérique C++.}} L'utilisation d'une application console C++ vous fournit une application simple dans laquelle vous pouvez tester la syntaxe C++11 sans qu'un framework y soit attaché.

{{Note| Les mêmes étapes élémentaires décrites ici (la création d'une application console C++) sont utiles pour s'exercer et découvrir les fonctionnalités du compilateur C++ ou pour développer et tester du code C++ dans un cadre réduit au strict minimum en attachant seulement la [[Utilisation de la RTL (bibliothèque d'exécution)|RTL]].}}

==Etapes==

# Choisissez '''Fichier >Nouveau > Autre'''.
#: [[File:File - New - Other.png|link=]] 
# La boîte de dialogue '''[[Nouveaux éléments|Nouveaux éléments]]''' apparaît. Cliquez sur '''Projets {{CBuilder}}''', sélectionnez '''Application console''', puis cliquez sur '''OK'''.
#: [[File:Console Application.png|link=]] 
# La boîte de dialogue '''[[Nouvelle application console (C++)|Nouvelle application console (C++)]]''' apparaît. Assurez-vous que C++ est sélectionné coumme type source. {{f|vcl|Si vous souhaitez sélectionner un framework pour votre application, choisissez VCL ou {{FM}} dans la zone de liste déroulante '''Framework cible'''. Dans le cas contraire, choisissez '''Aucun'''.|Si vous souhaitez sélectionner un framework pour votre application, choisissez {{FM}} dans la zone de liste déroulante '''Framework cible''' combo box. Dans le cas contraire, choisissez '''Aucun'''.}} Conservez les valeurs par défaut des autres options et cliquez sur '''OK'''.
#: [[File:New Console Application.png|link=]] 
# Dans le [[Fenêtre Projets|Gestionnaire de projets]], cliquez avec le bouton droit sur '''Plates-formes cible''' puis sélectionnez '''Ajouter une plate-forme'''.
#:[[File:Project Window.png|link=]] 
# Dans la boîte de dialogue '''Sélectionner une plate-forme''', sélectionnez '''Windows 64 bits''' et cliquez sur '''OK'''.
#:[[File:Select Platform.png|link=]] 
#[[Editeur de code|L'éditeur de code]] apparaît et affiche le squelette du code pour une application C++ simple. Vous pouvez écrire votre code C++11 dans ce fichier.
#: Par exemple, la portion de code suivante utilise le mot clé '''[[Auto|auto]]''' comme défini dans C++11 :

<source lang="cpp">
#include <iostream>
int main() {
char array[] = {'C', '+', '+', '1', '1'};
for (auto&i : array) {
printf("%c", i);
}
std::cin.get();
return 0;
}
</source>

: 7. Appuyez sur la touche F9 ou sélectionnez '''Exécuter > [[Exécuter|Exécuter]]''' pour exécuter l'application :
:[[File:RunApplication.png]]

Pour des exemples de code C++11, voir '''[[C++ moderne|C++11]]'''.

==Voir aussi==

* [[C++ moderne|C++11]]
* [[Fonctionnalités du C++ moderne prises en charge par les compilateurs C++ améliorés par Clang de RAD Studio|Fonctionnalités C++11 prises en charge par les compilateurs C++ améliorés par Clang de RAD Studio]]
* [[Nouvelle application console (C++)|Nouvelle application console (C++)]]
* [[Applications console|Applications console]]
* [[Création de bibliothèques de templates|Création de bibliothèques de templates]]
* [[Développement d'applications C++ Builder Windows 64 bits|Développement d'applications {{CBuilder}} Windows 64 bits]]
* [[Compilateurs C++ améliorés par Clang|Compilateurs C++ améliorés par Clang]]

{{DEFAULTSORT:Creation d'une application C++ simple pour utiliser les fonctionnalites C++11}}
[[Category:C++]]
[[Category:XE3]]
[[Category:AMMigrate]]

[[en:Creating a Simple C++ Application to Use Modern C++ Features]]
[[de:Erstellen einer einfachen C++-Anwendung für die Verwendung von C++11-Features]]
[[ja:C++11 機能を使用する簡単な C++ アプリケーションを作成する]]

Fichier:Select Platform.png

2020-11-18T02:38:49Z

Fabiola.Arias : Fabiola.Arias a téléversé une nouvelle version de Fichier:Select Platform.png

Fichier:Project Window.png

2020-11-18T02:38:49Z

Fabiola.Arias : MsUpload

MsUpload

Fichier:New Console Application.png

2020-11-18T02:38:48Z

Fabiola.Arias : MsUpload

MsUpload

Fichier:File - New - Other.png

2020-11-18T02:38:37Z

Fabiola.Arias : MsUpload

MsUpload

Fichier:Console Application.png

2020-11-18T02:38:25Z

Fabiola.Arias : MsUpload

MsUpload

Création d'une application C++ simple pour utiliser les fonctionnalités C++11

2020-11-17T15:34:57Z

Fabiola.Arias : Added the {{Note|}} template

{{Parent|C++ moderne}}

'''{{CBuilder}} XE3''' fournit la prise en charge de C++11, la version la plus récente du standard C++.

La façon la plus simple de tester et d'utiliser les nouvelles '''[[Fonctionnalités du C++ moderne prises en charge par les compilateurs C++ améliorés par Clang de RAD Studio|fonctionnalités C++11]]''' dans les applications {{CBuilder}} est de créer une application console C++, tel que cela est décrit dans les étapes suivantes. {{f|vcl|Vous pouvez également utiliser les fonctionnalités C++11 dans n'importe quelle application C++ Windows 64 bits créée avec {{Product}}, comme une application de fiches VCL C++ ou une application multi-périphérique C++.}} L'utilisation d'une application console C++ vous fournit une application simple dans laquelle vous pouvez tester la syntaxe C++11 sans qu'un framework y soit attaché.

{{Note| Les mêmes étapes élémentaires décrites ici (la création d'une application console C++) sont utiles pour s'exercer et découvrir les fonctionnalités du compilateur C++ ou pour développer et tester du code C++ dans un cadre réduit au strict minimum en attachant seulement la [[Utilisation de la RTL (bibliothèque d'exécution)|RTL]].}}

==Etapes==

# Choisissez '''Fichier >Nouveau > Autre'''.
#: [[File:FileNewOther.png]] 
# La boîte de dialogue '''[[Nouveaux éléments|Nouveaux éléments]]''' apparaît. Cliquez sur '''Projets {{CBuilder}}''', sélectionnez '''Application console''', puis cliquez sur '''OK'''.
#: [[File:C++NewCOnsoleApplication.png]] 
# La boîte de dialogue '''[[Nouvelle application console (C++)|Nouvelle application console (C++)]]''' apparaît. Assurez-vous que C++ est sélectionné coumme type source. {{f|vcl|Si vous souhaitez sélectionner un framework pour votre application, choisissez VCL ou {{FM}} dans la zone de liste déroulante '''Framework cible'''. Dans le cas contraire, choisissez '''Aucun'''.|Si vous souhaitez sélectionner un framework pour votre application, choisissez {{FM}} dans la zone de liste déroulante '''Framework cible''' combo box. Dans le cas contraire, choisissez '''Aucun'''.}} Conservez les valeurs par défaut des autres options et cliquez sur '''OK'''.
#: [[File:NCA01.png]] 
# Dans le [[Fenêtre Projets|Gestionnaire de projets]], cliquez avec le bouton droit sur '''Plates-formes cible''' puis sélectionnez '''Ajouter une plate-forme'''.
#:[[File:AddPlatfromRC.png]] 
# Dans la boîte de dialogue '''Sélectionner une plate-forme''', sélectionnez '''Windows 64 bits''' et cliquez sur '''OK'''.
#:[[File:SelectPlatform64.png]] 
#[[Editeur de code|L'éditeur de code]] apparaît et affiche le squelette du code pour une application C++ simple. Vous pouvez écrire votre code C++11 dans ce fichier.
#: Par exemple, la portion de code suivante utilise le mot clé '''[[Auto|auto]]''' comme défini dans C++11 :

<source lang="cpp">
#include <iostream>
int main() {
char array[] = {'C', '+', '+', '1', '1'};
for (auto&i : array) {
printf("%c", i);
}
std::cin.get();
return 0;
}
</source>

: 7. Appuyez sur la touche F9 ou sélectionnez '''Exécuter > [[Exécuter|Exécuter]]''' pour exécuter l'application :
:[[File:RunApplication.png]]

Pour des exemples de code C++11, voir '''[[C++ moderne|C++11]]'''.

==Voir aussi==

* [[C++ moderne|C++11]]
* [[Fonctionnalités du C++ moderne prises en charge par les compilateurs C++ améliorés par Clang de RAD Studio|Fonctionnalités C++11 prises en charge par les compilateurs C++ améliorés par Clang de RAD Studio]]
* [[Nouvelle application console (C++)|Nouvelle application console (C++)]]
* [[Applications console|Applications console]]
* [[Création de bibliothèques de templates|Création de bibliothèques de templates]]
* [[Développement d'applications C++ Builder Windows 64 bits|Développement d'applications {{CBuilder}} Windows 64 bits]]
* [[Compilateurs C++ améliorés par Clang|Compilateurs C++ améliorés par Clang]]

{{DEFAULTSORT:Creation d'une application C++ simple pour utiliser les fonctionnalites C++11}}
[[Category:C++]]
[[Category:XE3]]
[[Category:AMMigrate]]

[[en:Creating a Simple C++ Application to Use Modern C++ Features]]
[[de:Erstellen einer einfachen C++-Anwendung für die Verwendung von C++11-Features]]
[[ja:C++11 機能を使用する簡単な C++ アプリケーションを作成する]]