Comment : structurer et masquer le code

Mise à jour : novembre 2007

Par défaut, tout le texte est affiché dans l'éditeur de code, mais vous pouvez choisir de masquer certaines parties du code. L'éditeur de code vous permet de sélectionner une région de code et de la rendre réductible, afin qu'elle apparaisse sous un signe plus (+).

Cliquez sur le signe plus (+) situé à côté du symbole pour développer ou masquer la zone. Le code en mode Plan n'est pas supprimé, il est simplement masqué.

Les commandes Annuler et Rétablir du menu Edition influent sur ces actions. Autrement dit, si vous créez une zone réductible, la commande Annuler annule la création de cette zone. Par ailleurs, les opérations Copier, Couper, Coller et Glisser-déplacer conservent les informations en mode Plan mais pas l'état de la zone réductible. Par exemple, lorsque vous copiez une zone réduite, l'opération Coller collera le texte copié en tant que zone développée.

Après avoir mis le code en mode Plan, vous pouvez développer les sections sur lesquelles vous voulez travailler, les réduire quand vous avez terminé, puis vous déplacer vers une autre section. Quand vous êtes en mode Plan, vous pouvez utiliser la commande Arrêter le mode Plan pour supprimer les informations en mode Plan sans que cela n'affecte le code sous-jacent.

Attention :
Lorsque vous invalidez la zone, le mode Plan d'une zone est perdue. Par exemple, les opérations supprimer ou Rechercher et remplacer effacent la fin de la zone.

Les commandes suivantes sont disponibles dans le sous-menu Mode Plan du menu Edition, et dans le menu contextuel de l'éditeur de code :

Remarque :
Les boîtes de dialogue et les commandes de menu que vous voyez peuvent différer de celles qui sont décrites dans l'aide selon vos paramètres actifs ou votre édition. Pour modifier vos paramètres, choisissez Importation et exportation de paramètres dans le menu Outils. Pour plus d'informations, consultez Paramètres Visual Studio.

Commande	Définition
Masquer la sélection	Réduit le texte sélectionné. Sélectionnez le texte avant d'exécuter la commande. Les touches de raccourci sont CTRL+M, puis CTRL+H. Remarque : Cette commande devient disponible dans Visual C# quand le mode Plan automatique est désactivé ou que l'option Arrêter le mode Plan est activée. Non disponible dans Visual Basic.
Activer/Désactiver le développement du mode Plan	Inverse l'état en cours (masqué ou développé) de la section du mode Plan la plus interne et dans laquelle se trouve le curseur quand vous êtes dans une section réduite imbriquée. Les touches de raccourci sont CTRL+M, puis CTRL+M.
Activer/Désactiver tout le mode Plan	Définit un même état (masqué ou développé) pour toutes les procédures. Si certaines zones sont développées et d'autres masquées, cette commande développe les zones masquées. Les touches de raccourci sont CTRL+M, puis CTRL+L.
Arrêter le mode Plan	Supprime toutes les informations en mode Plan dans l'ensemble du document. Toutes les régions sont affichées et les symboles supprimés, mais le code sous-jacent n'est pas affecté. Les touches de raccourci sont CTRL+M, puis CTRL+P.
Démarrer le mode Plan automatique	Cette commande est uniquement disponible lorsque le mode Plan automatique est désactivé. Utilisez cette commande pour activer le mode Plan automatique dans l'environnement de développement intégré.
Arrêter le masquage en cours	Supprime les informations en mode Plan pour la zone sélectionnée définie par l'utilisateur. Les touches de raccourci sont CTRL+M, puis CTRL+U. Remarque   Cette commande devient disponible dans Visual C# quand le mode Plan automatique est désactivé ou que l'option Arrêter le mode Plan est activée. Non disponible dans Visual Basic.
Réduire aux définitions	Réduit les membres de tous les types de telle sorte que tous les membres appartenant à un même type soient clairement identifiés. Identique à la commande Réduire le bloc, à la différence que l'environnement parcourt automatiquement la totalité du code du document, crée les zones dans chacune de vos procédures, puis les masque. Les touches de raccourci sont CTRL+M, puis CTRL+O.
Réduire le bloc : <limite logique>	(Visual C++) L'environnement utilise le service du langage de programmation pour définir automatiquement les limites logiques de la création d'une zone dans la fonction contenant le point d'insertion, puis masque cette zone. Par exemple, si le point d'insertion se trouve à l'intérieur d'une boucle, une zone est créée pour cette instruction et la zone est masquée. Chaque fois que vous exécutez cette commande, le niveau immédiatement supérieur contenant l'instruction est réduit jusqu'à ce que vous parveniez au sommet de la procédure ou à une définition de niveau supérieur dans votre code.
Réduire tout dans : <structures logiques>	(Visual C++) Commande identique à Réduire le bloc, excepté qu'elle réduit de façon récursive toutes les structures logiques à l'intérieur de la fonction en une seule étape.

Création de sections de code réductibles dans Visual C++

Pour créer des sections de code réductibles

1. Sélectionnez la section de code ou de texte souhaitée.

   Remarque :
   Pour activer la commande Masquer la sélection, choisissez un flux de texte continu.

2. Cliquez avec le bouton droit sur la sélection, puis choisissez Mode Plan dans le menu contextuel.

3. Choisissez Masquer la sélection dans le sous-menu Mode Plan.

   La sélection est alors réduite sous la première ligne sélectionnée, et un signe plus (+) apparaît à gauche de la ligne, dans la marge des indicateurs.

Pour rendre réductible le code entre accolades

1. Cliquez avec le bouton droit dans l'éditeur de code sur une section de code Visual C++ placée entre accolades ("{}") et sélectionnez Mode Plan dans le menu contextuel.

2. Choisissez Réduire le bloc dans le sous-menu Mode Plan.

   Un signe moins (-) apparaît dans la marge des indicateurs, à côté de la ligne contenant l'accolade gauche ("{"). Lorsque vous sélectionnez ce signe, toutes les lignes suivantes jusqu'à l'accolade droite correspondante ("}") se réduisent sous la première ligne de la section, et un signe plus (+) apparaît.

   Remarque :
   Cette option est activée lorsque vous programmez en Visual C++.

Pour rendre réductibles les structures logiques entre accolades

1. Cliquez avec le bouton droit dans l'éditeur de code sur une section de code Visual C++ placée entre accolades ("{}") et incluant les structures logiques également placées entre accolades ("{}"), puis sélectionnez Mode Plan dans le menu contextuel.

2. Choisissez Réduire tout dans : <structure logique> dans le sous-menu Mode Plan.

   Un signe moins (-) apparaît dans la marge des indicateurs, à côté de l'accolade gauche ("{") de chaque sous-section de code également placée entre accolades. Lorsque vous sélectionnez ce signe, toutes les lignes suivantes jusqu'à l'accolade droite correspondante ("}") se réduisent sous la première ligne de la sous-section, et un signe plus (+) apparaît.

   Remarque :
   Cette option est uniquement disponible lorsque vous programmez en Visual C++.

Réduction et développement du code

Pour réduire et développer une section de code

1. Pour afficher toutes les lignes d'une section réduite, cliquez sur le signe plus (+) dans la marge des indicateurs.

2. Pour masquer une section développée, cliquez sur le signe moins (-) dans la marge des indicateurs.

   Vous pouvez également utiliser les commandes Activer/Désactiver le développement du mode Plan ou Activer/Désactiver tout le mode Plan pour masquer ou pour afficher toutes les sections réductibles.

Pour réduire et développer plusieurs sections de code réductibles

1. Sélectionnez des sections contiguës de code réductible dans l'éditeur de code.

2. Cliquez avec le bouton droit sur la sélection, puis choisissez Mode Plan dans le menu contextuel.

3. Choisissez Activer/Désactiver le développement du mode Plan dans le sous-menu Mode Plan.

   Si une section sélectionnée est développée, toutes les sections sélectionnées sont réduites. Si toutes les sections sélectionnées sont réduites, elles sont toutes développées.

Pour réduire ou développer toutes les sections de code réductibles

1. Cliquez avec le bouton droit sur un emplacement quelconque de l'éditeur de code, puis sélectionnez Mode Plan dans le menu contextuel.

2. Choisissez Activer/Désactiver tout le mode Plan dans le sous-menu Mode Plan.

   Si une section réductible est réduite, toutes les sections sont développées.

   Si toutes les sections sont développées, elles sont toutes réduites.

Pour réduire toutes les définitions

1. Cliquez avec le bouton droit sur un emplacement quelconque de l'éditeur de code, puis sélectionnez Mode Plan dans le menu contextuel.

2. Choisissez Réduire aux définitions dans le sous-menu Mode Plan.

   Toutes les sections réductibles du module en cours sont réduites.

Recherche des sections de code réductibles

Différents affichages de la fenêtre Rechercher et remplacer peuvent rechercher les sections de code réduites.

Pour rechercher les sections de code réduites

• Recherche rapide, fenêtre Rechercher et remplacer et Remplacement rapide, fenêtre Rechercher et remplacer incluent parmi leurs Options de recherche l'option Rechercher le texte masqué.

• Rechercher dans les fichiers, fenêtre Rechercher et remplacer et Remplacer dans les fichiers, fenêtre Rechercher et remplacer parcourent toujours la totalité du contenu d'un fichier, indépendamment des parties de texte réduites ou masquées.

Mode Plan automatique

Certains langages de développement prennent en charge un mode d'édition dans lequel le mode Plan automatique est toujours activé. Lorsque vous tapez de nouvelles définitions, l'éditeur de code crée des sections réductibles autour des blocs du nouveau code. Une fois que vous avez sélectionné l'option qui active le mode Plan dans votre langage de développement, différentes commandes deviennent disponibles dans le menu contextuel de l'éditeur de code ; elles permettent de développer et de réduire des sections sélectionnées, de développer et de réduire toutes les définitions, de développer et de réduire chaque section réductible, et, enfin, d'activer ou de désactiver le mode Plan automatique.

Pour créer automatiquement des sections de code réductibles

1. Sélectionnez l'option qui active le mode Plan pour le langage dans lequel vous programmez.

   Pour plus d'informations sur les options qui activent le mode Plan automatique dans certains langages de programmation, consultez Spécifique à VB, Basic, Éditeur de texte, boîte de dialogue Options, Mise en forme, C/C++, Éditeur de texte, boîte de dialogue Options et Mise en forme, C#, Éditeur de texte, boîte de dialogue Options.

2. Ajouter à votre code une nouvelle procédure, fonction, énumération ou un autre bloc de code.

   Un signe moins (-) apparaît dans la marge des indicateurs à côté de la ligne supérieure. Lorsque vous sélectionnez ce signe, le code ajouté est réduit sous la ligne supérieure, et un signe plus (+) apparaît.

Pour désactiver le mode Plan d'une section réductible

1. Cliquez avec le bouton droit sur un emplacement réductible de l'éditeur de code, puis sélectionnez Mode Plan dans le menu contextuel.

2. Choisissez Arrêter le masquage en cours.

   La section est développée, et le signe moins (-), qui permet de réduire la section, n'est plus affiché dans la marge des indicateurs.

Pour désactiver le mode Plan automatique et développer toutes les sections réduites

1. Cliquez avec le bouton droit sur un emplacement quelconque de l'éditeur de code, puis sélectionnez Mode Plan dans le menu contextuel.

2. Choisissez Arrêter le mode Plan.

   Toutes les sections réduites sont développées, et les signes moins (-), qui permettent de les réduire, ne sont plus affichés dans la marge des indicateurs.

Pour restaurer le mode Plan automatique et réduire toutes les sections développées

1. Cliquez avec le bouton droit sur un emplacement quelconque de l'éditeur de code, puis sélectionnez Mode Plan dans le menu contextuel.

2. Choisissez Démarrer le mode Plan automatique.

   Chaque section réductible est réduite sous sa ligne supérieure, et le signe plus (+), qui permet de la développer, est affiché dans la marge des indicateurs.

Voir aussi

Tâches

Comment : réduire et masquer des sections de code

Concepts

Nouvelles commandes et fonctionnalités de l'éditeur de code

Personnalisation de l'éditeur

Référence

#Region, directive

#If...Then...#Else, directives

Autres ressources

Modification de texte, de code et de balisage