Comment : localiser des solutions Excel

Article
08/10/2011

La localisation consiste principalement à traduire l'interface utilisateur de votre application. Au lieu d'encoder des chaînes en dur dans votre application, vous devez stocker les chaînes dans un fichier séparé. Vous pouvez stocker des chaînes pour les éléments de l'interface utilisateur Microsoft Office Excel dans le fichier de ressources de l'assembly par défaut du projet. Le fichier est nommé MyResources.resx dans les projets Visual Basic et Resources.resx dans les projets C#. Les copies du fichier de ressources peuvent ensuite être traduites dans plusieurs langues.

S'applique à : Les informations contenues dans cette rubrique s'appliquent aux projets de niveau document et de niveau application pour Excel 2007 et Excel 2010. Pour en savoir plus, consultez Fonctionnalités disponibles par type d'application et de projet Office.

Notes

Il est possible que pour certains des éléments de l'interface utilisateur de Visual Studio, votre ordinateur affiche des noms ou des emplacements différents de ceux indiqués dans les instructions suivantes. Ces éléments dépendent de l'édition de Visual Studio dont vous disposez et des paramètres que vous utilisez. Pour plus d'informations, consultez Utilisation des paramètres.

Stockage de texte dans un fichier de ressources

Pour ajouter du texte à un fichier de ressources

Ouvrez le projet Excel que vous souhaitez localiser.
Dans le menu Projet, sélectionnez Propriétés de <NomProjet>.

Le Concepteur de projets s'ouvre.
Cliquez sur Ressources dans Concepteur de projets pour ouvrir le volet Ressources.
Sélectionnez Chaînes dans la zone de liste déroulante Catégories.
Ajoutez un identificateur unique à la colonne Nom et au texte à localiser dans la colonne Valeur pour chaque chaîne que vous souhaitez localiser. Par exemple :

Nom

Valeur

ListCreateUnscheduledOrder

créer un ordre non planifié

Notes

Vous pouvez utiliser la colonne Commentaire pour fournir des remarques ou des instructions au traducteur.

Nom	Valeur
ListCreateUnscheduledOrder	créer un ordre non planifié

Récupération de texte à partir d'un fichier de ressources

Une fois que vous avez ajouté chaque chaîne au fichier de ressources, les chaînes peuvent être chargées au moment de l'exécution.

Pour ajouter une valeur à une cellule à l'aide d'un fichier de ressources.

Dans le gestionnaire d'événements Startup de Sheet1, ajoutez un contrôle NamedRange à la cellule A1.

Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange = _
    Me.Controls.AddNamedRange(Me.Range("A1"), "NamedRange1")

Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
    this.Controls.AddNamedRange(this.Range["A1", missing], "namedRange1");

Assignez une valeur du fichier de ressources.

namedRange1.Value2 = My.Resources.ListCreateUnscheduledOrder

namedRange1.Value2 = Properties.Resources.ListCreateUnscheduledOrder;

Localisation du fichier de ressources

Pour localiser un fichier de ressources

Copiez le fichier de ressources et nommez-le avec le code de culture de la langue cible. Par exemple, pour créer un fichier qui sera localisé en japonais, copiez le fichier Resources.resx et nommez-le Resources.ja.resx.
Faites traduire le fichier de ressources dans les langues que vous souhaitez prendre en charge. Par exemple, faites traduire les chaînes du fichier Resources.ja.resx en japonais.
Ajoutez les fichiers de ressources traduits à votre projet afin que le système de projet puisse compiler les fichiers de ressources dans des assemblys satellites.

Chargement des ressources basées sur la langue de l'interface utilisateur Office

Microsoft .NET Framework charge des ressources basées sur la langue de l'interface utilisateur Microsoft Windows. Toutefois, les solutions Office sont généralement écrites pour charger des ressources basées sur la langue de l'interface utilisateur Office. Le premier exemple ci-dessous montre comment charger des ressources qui correspondent à la langue de l'interface utilisateur Office, quelle que soit la version d'Office installée. Le deuxième exemple montre comment substituer à la fois la langue de l'interface utilisateur Office et le comportement de Microsoft .NET Framework par défaut.

Pour charger des ressources basées sur Office (plusieurs versions linguistiques d'Office)

Ajoutez le code suivant au gestionnaire d'événements Startup pour le classeur et chacune des feuilles de calcul.

System.Threading.Thread.CurrentThread.CurrentUICulture = _
    New System.Globalization.CultureInfo( _
        Application.LanguageSettings.LanguageID( _
            Office.MsoAppLanguageID.msoLanguageIDUI))

System.Threading.Thread.CurrentThread.CurrentUICulture =
    new System.Globalization.CultureInfo(
        Application.LanguageSettings.get_LanguageID(
            Office.MsoAppLanguageID.msoLanguageIDUI));

Si vous n'avez pas plusieurs versions linguistiques d'Office, vous pouvez forcer le chargement des ressources en assignant l'ID de culture correspondant à la propriété CurrentCulture de l'objet CultureInfo (ou celui du thread en cours). Cela peut être utile pour effectuer des opérations de débogage ou dans le cadre du code personnalisé qui permet aux utilisateurs de sélectionner les ressources à charger.

Pour charger des ressources basées sur Office (à l'aide de l'ID de culture)

Ajoutez le code suivant au gestionnaire d'événements Startup pour le classeur et chacune des feuilles de calcul. Cet exemple passe l'ID de culture pour l'allemand (Allemagne). Pour obtenir la liste des ID de culture, consultez CultureInfo.
```
System.Threading.Thread.CurrentThread.CurrentUICulture = _
    New System.Globalization.CultureInfo("de")
```
```
System.Threading.Thread.CurrentThread.CurrentUICulture = 
    new System.Globalization.CultureInfo("de");
```

Localisation de contrôles personnalisés

Vous pouvez ajouter des contrôles personnalisés au volet Actions dans les solutions Office. Vous pouvez activer la localisation d'un contrôle utilisateur ou d'un contrôle de volet Actions de la même façon que vous localiseriez un formulaire Windows. Pour plus d'informations, consultez Procédure pas à pas : localisation de Windows Forms.

Pour activer la localisation d'un contrôle personnalisé

Dans le menu Affichage, sélectionnez Fenêtre Propriétés.
Sélectionnez le contrôle utilisateur ou le contrôle de volet Actions dans le concepteur et remplacez la valeur de la propriété Localizable par true.

Voir aussi

Partager via