Windows Forms Resource Editor (Winres.exe)

L'outil Windows Forms Resource Editor, Winres.exe, est un outil d'organisation visuel qui permet aux localisateurs de localiser des ressources d'interface utilisateur Windows Forms utilisées par des formulaires. Vous pouvez créer les fichiers .resx ou .resources servant d'entrée à Winres.exe à l'aide d'un environnement de design visuel tel que Microsoft Visual Studio. Pour obtenir des informations sur le déploiement des ressources dans les applications .NET Framework, consultez Ressources dans les applications.

winres resourceFile 
winres /? 

Notes

L'état des éléments d'interface d'un formulaire dans un projet Windows Forms est généralement stocké dans des fichiers de ressources, c'est-à-dire des fichiers XML portant l'extension .resx ou leurs versions binaires et compilées correspondantes, portant l'extension .resources. Winres.exe est un outil qui permet d'éditer de façon limitée les deux types de fichiers en dehors de l'environnement de design Visual Studio. Vous pouvez y effectuer les types de modifications suivants :

• Un fichier de ressources de culture spécifique ou neutre peut être modifié pour changer les propriétés d'interface utilisateur du formulaire ou de ses contrôles, notamment le texte, la taille ou la position.

• Les fichiers de ressources de culture neutre ou spécifique peuvent être générés à partir du fichier de ressources par défaut.

• Un fichier de ressources avec une culture spécifique peut être enregistré en tant que fichier de ressources d'une autre culture. Par exemple, un fichier de ressources anglais (États-Unis) peut être enregistré en tant que fichier de ressources polonais. En général, le nouveau fichier est modifié par la suite pour être compatible avec la nouvelle culture.

Organisation hiérarchique des ressources pour la localisation
Organisation hiérarchique des ressources pour la localisation
Organisation hiérarchique des ressources pour la localisation
Organisation hiérarchique des ressources pour la localisation

Winres.exe ne peut pas convertir un fichier .resx en fichier .resources correspondant ; utilisez à la place l'outil Resgen.exe. Pour plus d'informations sur Resgen.exe, consultez Outil Resource File Generator Tool (Resgen.exe).

Winres.exe est une application graphique qui recrée une version design d'un formulaire Windows Forms simplement à partir du fichier de ressources, sans devoir accéder au code source. Winres.exe héberge le Concepteur de formulaires Windows Forms et la fenêtre Propriétés. Ces fonctionnalités permettent une modification visuelle d'un fichier .resources ou .resx contenant un formulaire Windows Forms. En règle générale, les localisateurs utilisent Winres.exe pour modifier les étiquettes des contrôles et régler l'emplacement et la taille de ces derniers pour adapter les étiquettes à la culture cible.

Si Winres.exe ne parvient pas à résoudre le type d'un contrôle, il crée un contrôle réservé dans le fichier .resx ou .resources localisé. Ce contrôle apparaît sur le formulaire Windows Forms sous la forme d'une fenêtre hachurée dont la taille et la position correspondent à celles du contrôle réel. Toutes les propriétés localisables disponibles pour le contrôle réservé apparaissent dans la fenêtre Propriétés. Toute modification apportée au contrôle réservé est enregistrée dans le contrôle réel.

Winres.exe et Visual Studio

En général, avant de commencer à localiser les formulaires Windows Forms d'une application, vous devez décider si vous souhaitez utiliser l'outil de localisation Visual Studio .NET ou Winres.exe. Certains problèmes de compatibilité de versions, décrits ultérieurement, peuvent vous empêcher de basculer d'un outil à l'autre.

L'avantage de Visual Studio .NET est qu'il permet à la fois de développer et de localiser une application. Pour localiser un formulaire à l'issue du développement, affectez la valeur true à la propriété LocalizableAttribute (propriété Localizable dans l'éditeur des propriétés et modifiez sa propriété Language en fonction de la culture cible souhaitée. Ensuite, modifiez les chaînes et réglez l'emplacement et la taille des contrôles en fonction des chaînes de la culture cible. Lors de l'enregistrement du fichier .resx localisé, Visual Studio n'écrit que les propriétés localisables (les propriétés modifiées dans la culture cible) dans le fichier. Il crée automatiquement un assembly satellite pour le fichier .resx localisé à l'emplacement de répertoire correct. Procédure pas à pas : localisation de Windows Forms
Procédure pas à pas : localisation de Windows Forms
Procédure pas à pas : localisation de Windows Forms
Procédure pas à pas : localisation de Windows Forms
Procédure pas à pas : localisation de Windows Forms

Visual Studio fournit un environnement de développement et de localisation intégré, mais Winres.exe est préférable si la localisation est effectuée par des tiers. Dans la mesure où Winres.exe est exclusivement un outil de localisation, il permet de mieux séparer le code d'une application des formulaires à localiser et s'avère plus pratique pour gérer des projets volumineux.

Utilisation de Winres.exe

Si vous optez pour une localisation avec Winres.exe, vous devez d'abord développer une application à l'aide d'un concepteur visuel tel que le Concepteur Forms dans Visual Studio. Une fois le développement terminé, affectez la valeur true à la propriété LocalizableAttribute (la propriété Localizable dans l'éditeur des propriétés) puis confiez le fichier .resx de la culture neutre à un localisateur tiers. Ce fichier .resx contient des informations supplémentaires dont se sert Winres.exe pour recréer une version design du formulaire d'origine.

Les versions finales des fichiers de ressources de la culture peuvent enfin être utilisées pour créer des versions localisées de l'application. Pour plus d'informations, consultez Ressources dans les applications.

La version 2.0 de Winres.exe possède les fonctions et fonctionnalités suivantes :

• Winres peut fonctionner en mode fichier unique ou en mode fichier Visual Studio. Le mode fichier unique est le mode hérité (legacy) où l'intégralité des informations relatives au formulaire et à son contenu sont stockées dans le fichier de ressources. Le mode fichier Visual Studio stocke uniquement les modifications relatives à la culture dans le fichier de ressources.

• Une fenêtre de rapport d'erreurs, ancrée dans le coin inférieur gauche de la fenêtre principale, a été ajoutée à l'interface.

• Vous pouvez contrôler s'il existe des doublons de touches d'accès rapide : dans le menu Format, cliquez sur la commande Vérifier les touches d'accès rapide.

Compatibilité des versions

Dans la mesure où le format des fichiers de ressources entre Visual Studio .NET 2002 et Visual Studio 2005 a changé, Winres.exe a été également modifié pour être compatible. Par conséquent, en règle générale, vous devez utiliser la version de Winres.exe publiée avec le .NET Framework que vous utilisez pour créer l'application. Le tableau suivant décrit les versions compatibles.

Si vous essayez d'ouvrir un fichier de ressources plus ancien avec la version 2.0 de Winres.exe, vous serez invité à mettre à niveau le format du fichier pour qu'il soit compatible avec la version 2.0 du .NET Framework.

Dans les versions du .NET Framework antérieures à la version 2.0, Winres.exe et le Concepteur Forms de Visual Studio créaient des fichiers de ressources de culture spécifique et de culture neutre incompatibles. Dès lors, vous n'aviez d'autre choix, une fois le processus de localisation entamé, que de continuer à utiliser le même outil. En revanche, le mode fichier Visual Studio a été ajouté à la version 2.0 de Winres.exe. Comme son nom l'indique, un fichier de ressources enregistré dans ce mode de compatibilité peut être modifié avec les deux outils.

Exemples

Pour localiser un fichier .resx ou .resources associé à un formulaire

1. Tapez winres à l'invite de commandes pour exécuter Winres.exe.

2. Pour ouvrir les ressources par défaut d'un formulaire à localiser, cliquez sur la commande Ouvrir dans le menu Fichier et accédez au fichier pour l'ouvrir.

   - ou -

   Spécifiez le fichier à ouvrir dans la ligne de commande lorsque vous démarrez Winres.exe.

   La commande suivante démarre Winres.exe et charge le formulaire associé à TestApp.resx dans le Concepteur Form.

   winres TestApp.resx
   

   La commande suivante démarre Winres.exe et charge le formulaire associé à TestApp.resources dans le Concepteur Form.

   winres TestApp.resources
   

   Notes

   Si le formulaire dont vous modifiez les ressources est un formulaire hérité, tant l'assembly contenu dans le formulaire hérité que l'assembly contenant le formulaire dérivé (qui hérite) doit être enregistré dans le Global Assembly Cache (GAC) ou résider dans le même répertoire que WinRes.exe. Pour plus d'informations sur l'installation de composants .NET Framework dans le GAC, consultez Global Assembly Cache.

3. Sélectionnez les contrôles sur le formulaire et modifiez les propriétés Text et autres pour refléter la langue localisée. Si nécessaire, déplacez ou redimensionnez les contrôles pour tenir compte du texte localisé.

4. Pour enregistrer la version localisée du fichier .resx ou .resources, cliquez sur l'icône Enregistrer sous ou la même commande dans le menu Fichier. L'outil affiche la fenêtre Choisir la culture.

5. Sélectionnez la culture appropriée et le mode fichier et cliquez sur OK. L'outil enregistre le fichier à l'aide de la convention d'affectation de noms que le runtime attend pour les fichiers de ressources localisés. Par exemple, si vous localisez TestApp.resources en allemand, l'outil enregistre le fichier sous TestApp.de-DE.resources. Si vous localisez TestApp.resx en allemand, l'outil enregistre le fichier sous TestApp.de-DE.resx. Pour plus d'informations sur les conventions d'affectation de noms, consultez Empaquetage et déploiement de ressources. Pour obtenir la liste des noms de cultures prédéfinis utilisés par le runtime, consultez CultureInfo Class.

Voir aussi

Référence

Outils du .NET Framework
LocalizableAttribute
CultureInfo
ResourceManager
ResourceReader
ResourceWriter

Concepts

Ressources dans les applications

Autres ressources

Codage et localisation